Bar

BarEditItem.VisibleWhenVertical Property

Determines whether the current BarEditItem is visible, if a specific bar is vertically oriented.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[Browsable(true)]
public override bool VisibleWhenVertical { get; set; }
<Browsable(True)>
Public Overrides Property VisibleWhenVertical As Boolean

Property Value

Type Description
Boolean

true, if the current BarEditItem is visible in a vertical bar, otherwise, false.

Remarks

If a bar's BarOptions.RotateWhenVertical property is set to true, editors associated with edit items are never displayed within bars docked to the left or right edge of a container (form). In this case, edit items can be represented within such bars only by captions and/or glyphs.

To enable displaying the caption and/or glyph for an edit link within the vertically docked bar, set the VisibleWhenVertical property to true. The second step is to make the caption and/or glyph visible for the item.

To assign a glyph for a link, use the BarItem.ImageIndex or BarItemLink.ImageIndex property.

The BarItem.PaintStyle or BarItemLink.UserPaintStyle property allows you to choose the style for representing the link within a bar and submenu. By default, the paint style is set to BarItemPaintStyle.Standard. In this case, edit items are displayed without captions/glyphs within horizontally oriented bars. For vertically docked bars, the edit items are represented by these images.

To enable displaying captions for edit items within vertically oriented bars, set the paint style to BarItemPaintStyle.Caption or BarItemPaintStyle.CaptionGlyph.

You can implement specific functionality when captions/glyphs are clicked by handling the BarItem.ItemClick or BarManager.ItemClick event. For instance, you can invoke a specific dialog.

See Also