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

How to: Create and Modify the Control's Large Image List

  • 2 minutes to read

This example creates and modifies an image list that will serve as a source of large images for the control. The image list is assigned to the NavBarControl.LargeImages property. The NavElement.ImageOptions property gives access to options that allow you to assign images to items/group. NavBarGroup.GroupCaptionUseImage and NavBarGroup.GroupStyle properties are set to enable display of large images.

The following image shows the control’s look & feel before and after code execution:

Images - LargeIndex

using DevExpress.XtraNavBar;

// Create an image list
ImageList largeImageSource = new ImageList();
largeImageSource.ImageSize = new Size(32, 32);
largeImageSource.Images.Add(Image.FromFile("E:\\Images\\Icons\\MSHelpLarge.bmp"));
largeImageSource.Images.Add(Image.FromFile("E:\\Images\\Icons\\IndexLarge.bmp"));
largeImageSource.Images.Add(Image.FromFile("E:\\Images\\Icons\\BookClosedLarge.bmp"));

// Set the image list as a source of large images
navBarControl1.LargeImages = largeImageSource;

// Assign a large image to a group caption
NavBarGroup currGroup = navBarControl1.Groups[1];
currGroup.ImageOptions.LargeImageIndex = 0;
currGroup.GroupCaptionUseImage = NavBarImage.Large;

// Assign large images to items
currGroup.ItemLinks[0].Item.ImageOptions.LargeImageIndex = 1;
currGroup.ItemLinks[1].Item.ImageOptions.LargeImageIndex = 2;
currGroup.GroupStyle = NavBarGroupStyle.LargeIconsText;