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.v24.2.dll

Declaration

C#

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool RotateWhenVertical { get; set; }

VB.NET

<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
Vertically docked bar (RotateWhenVertical is false)
Vertically docked bar (RotateWhenVertical is 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:

• leave the item’s BarItem.PaintStyle property set to BarItemPaintStyle.Standard, but assign an image for the item via the BarItem.ImageIndex or BarItemLink.ImageIndex property. This image is displayed only when the bar is vertically docked. When the bar is horizontally oriented, the image is hidden.

  You can also specify the paint style for a link via the BarItemLink.UserPaintStyle property and thus override the item’s setting.

• make the link’s caption visible via the BarItem.PaintStyle or BarItemLink.UserPaintStyle property. In this case, the link will always display the caption (in the vertically docked bar the caption will be rotated)