NavigatorButtonsBase.ImageList Property

Gets or sets the source of images to be displayed within the navigation buttons.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(null)]
public object ImageList { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property ImageList As Object

Property Value

Type	Default	Description
Object	null	An object which represents the source of images.

Remarks

By default, the navigation buttons display images contained within the NavigatorButtonsBase.DefaultImageList property. The ImageList property allows a custom source of images to be specified. Once the custom source of images is assigned to this property, use the button’s NavigatorButtonBase.ImageIndex property to specify the index of the required image.

The ImageList property accepts the following image collections:

• ImageCollection - Supports image transparency.
• SharedImageCollection - Supports image transparency. Allows you to share images between controls within multiple forms.
• SvgImageCollection - Stores vector icons that can scale without losing their quality on high resolution devices.
• ImageList.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ImageList property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-grid-data-navigator-custom-button/CS/CustomButton/Form1.cs#L22

gridControl1.EmbeddedNavigator.ButtonClick += new DevExpress.XtraEditors.NavigatorButtonClickEventHandler(gridControl1_EmbeddedNavigator_ButtonClick);
gridControl1.EmbeddedNavigator.Buttons.ImageList = imageCollection1;
DevExpress.XtraEditors.NavigatorCustomButton button;

VB.NET

winforms-grid-data-navigator-custom-button/VB/CustomButton/Form1.vb#L21

AddHandler gridControl1.EmbeddedNavigator.ButtonClick, New DevExpress.XtraEditors.NavigatorButtonClickEventHandler(AddressOf gridControl1_EmbeddedNavigator_ButtonClick)
gridControl1.EmbeddedNavigator.Buttons.ImageList = imageCollection1
Dim button As DevExpress.XtraEditors.NavigatorCustomButton