Skip to main content

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

AccordionControlElementBase.ImageLayoutMode Property

Gets or sets whether the header image (AccordionControlElementBase.Image or AccordionControlElementBase.ImageIndex) is resized and how this is performed.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[Browsable(false)]
public ImageLayoutMode ImageLayoutMode { get; set; }

#Property Value

Type Description
DevExpress.XtraBars.Navigation.ImageLayoutMode

The image stretching mode.

#Remarks

The following stretching modes are available:

  • OriginalSize - an image is displayed as is, without stretching. An element’s header is auto-sized to fit the assigned image.
  • Squeeze - a large image is scaled down to fit the height of the header’s content region, while a smaller image is displayed as is.
  • Stretch - an image is proportionally resized to fit the height of the header’s content region.

In the OriginalSize mode, the image height affects the header height, while in the Squeeze and Stretch modes, the header height limits the image display size. You can use the following properties to manually change the header height of elements: AccordionControlElementBase.Height, AccordionControl.ItemHeight and AccordionControl.GroupHeight.

Tip

The height of a header’s content region is determined by the header height minus content vertical margins.

See Also