NavigatorButtonCollectionBase.Item[Int32] Property
Gets the button at the specified index.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.XtraEditors.v24.2.dll
NuGet Package: DevExpress.Win.Navigation
#Declaration
#Parameters
Name | Type | Description |
---|---|---|
index | Int32 | An integer value representing the button’s zero-based index. If negative or exceeds the maximum available index, an exception is raised. |
#Property Value
Type | Description |
---|---|
Navigator |
A Navigator |
#Remarks
Use the Item property to access individual buttons using index notation. This property returns an NavigatorButton object and its properties can be used to customize a button’s settings. For example, you can specify the index of the image to be displayed on the button via the NavigatorButtonBase.ImageIndex property.
#Example
The following code creates a new DataNavigator control, binds it to a data source, and specifies custom images for control buttons at runtime. Custom images are stored in an ImageCollection object.
using DevExpress.XtraEditors;
private void CreateDataNavigator() {
// Create a new DataNavigator control
DataNavigator dataNavigator = new DataNavigator();
Controls.Add(dataNavigator);
dataNavigator.Height = 40;
dataNavigator.Dock = DockStyle.Bottom;
// Bind to a data source
dataNavigator.DataSource = productsBindingSource;
// Specify the ImageCollection that stores custom images for DataNavigator buttons
dataNavigator.Buttons.ImageList = imageCollection1;
for (int i = 0; i < dataNavigator.Buttons.ButtonCollection.Count; i++) {
dataNavigator.Buttons.ButtonCollection[i].ImageIndex = i;
}
dataNavigator.ShowToolTips = true;
}