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

NavBarGroup.GroupCaptionUseImage Property

Gets or sets whether a big or small image is displayed within the group caption.

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v24.2.dll

NuGet Package: DevExpress.Win

#Declaration

[DefaultValue(NavBarImage.Default)]
[XtraSerializableProperty]
public virtual NavBarImage GroupCaptionUseImage { get; set; }

#Property Value

Type Default Description
NavBarImage Default

A NavBarImage value representing the fixed image size to use within the group caption.

Available values:

Name Description
Default

A group’s caption displays a small image, if available. If no small image is available, the group displays a large image. If no large image is available, the group does not display any image.

Small

A group’s caption displays a small image, if available. If no small image is available, the group does not display any image.

Large

A group’s caption displays a large image, if available. If no large image is available, the group does not display any image.

#Remarks

The GroupCaptionUseImage property controls whether small or large images are displayed within the group caption.

Each NavBar group can display either a small or large image within its caption. You can specify images for the group caption in the following ways:

If an image is assigned to the LargeImage/SmallImage property, the LargeImageIndex/SmallImageIndex setting is ignored.

If the GroupCaptionUseImage property is set to NavBarImage.Default, small images (if assigned) have a higher priority than large images. If small images are not assigned, the group caption will display a large image (if available).

For groups to explicitly use small or large images, set the GroupCaptionUseImage property to NavBarImage.Small or NavBarImage.Large.

The NavBarGroup.GetImage method returns the image to be displayed within the group caption which depends on the settings specified.

See Also