ContextQMD
Back to Devexpress

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

windowsforms-4891-controls-and-libraries-navigation-controls-navigation-bar-examples-appearance-how-to-create-and-modify-the-controls-large-image-list.md

latest2.7 KB
Original Source

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

  • Jan 10, 2025
  • 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:

csharp
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;
vb
Imports DevExpress.XtraNavBar

' Create an image list
Private largeImageSource As 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
Dim currGroup As NavBarGroup = 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