RibbonEmptyAreaImageOptions.AlwaysVisible Property

Gets or sets whether the Ribbon can clip the Empty Area Image when there is not enough free space to display this image according to its SizeMode.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.2.dll

Declaration

C#

[DefaultValue(true)]
[DXCategory("Layout")]
[XtraSerializableProperty]
public bool AlwaysVisible { get; set; }

VB.NET

<DXCategory("Layout")>
<DefaultValue(True)>
<XtraSerializableProperty>
Public Property AlwaysVisible As Boolean

Property Value

Type	Default	Description
Boolean	true	true to allow partially visible Empty Area Images; false to hide an Empty Area Image if there is not enough free space to display it.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AlwaysVisible
RibbonControl	.EmptyAreaImageOptions .AlwaysVisible

Remarks

When a user resizes a Ribbon, the Empty Area Image is moved, resized, clipped, or hidden. The exact behavior depends on a combination of the AlwaysVisible and SizeMode properties.

• SizeMode is “Stretch”: An Empty Area Image can be resized without limitations and occupies any available space; the AlwaysVisible property is ignored.

• SizeMode is “Default”, “Zoom”, or “Squeeze”: An Empty Area Image is resized until it reaches a minimum size. Further resize forces the Ribbon to either clip this image (if AlwaysVisible is true), or completely hide it (if AlwaysVisible is false).

• SizeMode is “Normal”: An Empty Area Image cannot be resized and is always displayed as is. Resizing a Ribbon causes this image to move closer to the last visible Page Group. When the gap between this group and the image is closed, the image is either clipped (if AlwaysVisible is true) or hidden (if AlwaysVisible is false).