Skip to main content
All docs
V24.2

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

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

NuGet Package: DevExpress.Win.Navigation

#Declaration

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

#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).

See Also