Skip to main content
Bar

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BarEditItem.VisibleWhenVertical Property

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

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[Browsable(true)]
[DefaultValue(false)]
public override bool VisibleWhenVertical { get; set; }

#Property Value

Type Default Description
Boolean false

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.ImageOptions.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