TileBarDropDownContainer Class

The dropdown control container that can be associated with a TileBarItem object

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[ToolboxBitmap(typeof(ToolboxIconsRootNS), "TileBarDropDownContainer")]
public class TileBarDropDownContainer :
    PanelControl

VB.NET

<ToolboxBitmap(GetType(ToolboxIconsRootNS), "TileBarDropDownContainer")>
Public Class TileBarDropDownContainer
    Inherits PanelControl

Related API Members

The following members return TileBarDropDownContainer objects:

• TileBar.GetDropDown()
• TileBarDropDownShowingEventArgs.DropDownContainer
• TileBarItem.DropDownControl

Remarks

You can associate TileBarItem objects in the TileBar with dropdown controls using the TileBarItem.DropDownControl property, which accepts objects of the TileBarDropDownContainer type. You can locate the TileBarDropDownContainer in the Toolbox, drop it onto the form and assign this container to the TileBarItem.DropDownControl property. The TileBarDropDownContainer can contain any control, including another TileBar control. You can regulate the view and behavior of this control using the TileBarDropDownOptions object.

Example

The following code demonstrates how to create a TileBar control with one tile and associate a dropdown control with this tile.

C#

using DevExpress.XtraBars.Navigation;
using DevExpress.XtraEditors;
using DevExpress.XtraRichEdit;

private TileBar tileBar;

private void Form1_Load(object sender, EventArgs e) {
    tileBar = new TileBar();
    this.Controls.Add(tileBar);
    tileBar.Dock = DockStyle.Top;
    tileBar.Height = 100;
    tileBar.BackColor = Color.LightGray;
    TileBarGroup tileBarGroup = new TileBarGroup();
    tileBar.Groups.Add(tileBarGroup);
    TileBarItem item = new TileBarItem();
    item.Text = "Notes";
    item.Image = global::WindowsFormsApplication1.Properties.Resources.textbox_32x32;
    item.DropDownOptions.BackColorMode = BackColorMode.UseTileBackColor;
    item.DropDownOptions.Height = 185;
    tileBarGroup.Items.Add(item);
    TileBarDropDownContainer ddContainer = new TileBarDropDownContainer();
    ddContainer.Size = new System.Drawing.Size(595, 185);
    SimpleButton button = new SimpleButton();
    button.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Right)));
    button.Location = new System.Drawing.Point(510, 152);
    button.Size = new System.Drawing.Size(75, 22);
    button.Text = "Close";
    button.Click += button_Click;
    RichEditControl richEditControl = new RichEditControl();
    richEditControl.Dock = System.Windows.Forms.DockStyle.Top;
    richEditControl.Text = "";
    richEditControl.Height = 142;
    richEditControl.ActiveViewType = RichEditViewType.Draft;
    richEditControl.Options.HorizontalScrollbar.Visibility = RichEditScrollbarVisibility.Hidden;
    ddContainer.Controls.Add(button);
    ddContainer.Controls.Add(richEditControl);
    item.DropDownControl = ddContainer;
}

void button_Click(object sender, EventArgs e) {
    tileBar.HideDropDownWindow();
}

VB.NET

Imports DevExpress.XtraBars.Navigation
Imports DevExpress.XtraEditors
Imports DevExpress.XtraRichEdit

Private tileBar As TileBar

Private Sub Form1_Load(sender As Object, e As EventArgs)
    tileBar = New TileBar()
    Me.Controls.Add(tileBar)
    tileBar.Dock = DockStyle.Top
    tileBar.Height = 100
    tileBar.BackColor = Color.LightGray
    Dim tileBarGroup As New TileBarGroup()
    tileBar.Groups.Add(tileBarGroup)
    Dim item As New TileBarItem()
    item.Text = "Notes"
    item.Image = Global.WindowsFormsApplication1.Properties.Resources.textbox_32x32
    item.DropDownOptions.BackColorMode = BackColorMode.UseTileBackColor
    item.DropDownOptions.Height = 185
    tileBarGroup.Items.Add(item)
    Dim ddContainer As New TileBarDropDownContainer()
    ddContainer.Size = New System.Drawing.Size(595, 185)
    Dim button As New SimpleButton()
    button.Anchor = DirectCast((System.Windows.Forms.AnchorStyles.Bottom Or System.Windows.Forms.AnchorStyles.Right), System.Windows.Forms.AnchorStyles)
    button.Location = New System.Drawing.Point(510, 152)
    button.Size = New System.Drawing.Size(75, 22)
    button.Text = "Close"
    AddHandler button.Click, AddressOf button_Click
    Dim richEditControl As New RichEditControl()
    richEditControl.Dock = System.Windows.Forms.DockStyle.Top
    richEditControl.Text = ""
    richEditControl.Height = 142
    richEditControl.ActiveViewType = RichEditViewType.Draft
    richEditControl.Options.HorizontalScrollbar.Visibility = RichEditScrollbarVisibility.Hidden
    ddContainer.Controls.Add(button)
    ddContainer.Controls.Add(richEditControl)
    item.DropDownControl = ddContainer
End Sub

Private Sub button_Click(sender As Object, e As EventArgs)
    tileBar.HideDropDownWindow()
End Sub

Implements

IXtraResizableControl

Inheritance

Object

MarshalByRefObject

Component

Control

ScrollableControl

XtraScrollableControl

XtraPanel

DevExpress.Utils.Controls.PanelBase

PanelControl

TileBarDropDownContainer