Bar

BarOptions.RotateWhenVertical Property

Gets or sets whether a bar links' captions are rotated when the bar is vertically docked.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[XtraSerializableProperty]
[DefaultValue(true)]
public virtual bool RotateWhenVertical { get; set; }
<XtraSerializableProperty>
<DefaultValue(True)>
Public Overridable Property RotateWhenVertical As Boolean

Property Value

Type Default Description
Boolean

true

true, if the links' captions are rotated along with the bar; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to RotateWhenVertical
Bar
.OptionsBar.RotateWhenVertical

Remarks

If the RotateWhenVertical property is set to true, the captions of the bar's links are rotated when the bar is docked to the left or right edge of its container (form). Otherwise, the captions will be displayed in horizontal orientation.

The following table shows the link layout depending on the RotateWhenVertical property.

Layout Image
Horizontally docked bar Bars3_Bar_RotateWhenVertical_Horiz
Vertically docked bar (RotateWhenVertical is false) Bars3_Bar_RotateWhenVertical_False
Vertically docked bar (RotateWhenVertical is true) Bars3_Bar_RotateWhenVertical_True

Note that if a bar's RotateWhenVertical property is true, editors of BarEditItemLink links are not displayed if a bar is vertically docked.

Edit links can be represented within vertically oriented bars only using captions and/or glyphs. You can perform specific actions when the end-user clicks on these captions or glyphs by handling the BarItem.ItemClick or BarManager.ItemClick event (you can, for instance, invoke a dialog that provides customization facilities, etc).

To make edit links visible within vertically docked bars, set the items' BarEditItem.VisibleWhenVertical property to true and then do one of the following:

See Also