Tag Property


Gets or sets the object that contains data about this RasterImageListItem.


public object Tag { get; set; } 
property Object^ Tag { 
   Object^ get(); 
   void set (    Object^ ); 
   property Object^ Tag 
      Object^ get() 
      void set(Object^ value) 

Property Value

An System.Object that contains data about this RasterImageListItem. The default value is a null reference (Nothing in VB).


Any System.Object derived type can be assigned to this property.

You can use this property to associate your own user-defined data with an item.


This example creates and populates a RasterImageList control with a few items. It then associates each item with a user-defined object. When the selected item is changed by the user interface, the corresponding user data is pulled from the selected item and displayed in a message box.

using Leadtools.WinForms; 
using Leadtools; 
using Leadtools.Codecs; 
private class UserData 
   public int Number; 
   public string Text; 
public void RasterImageListItem_Tag(RasterImageList imageList) 
   // Create a new RasterImageList control. 
   imageList.Bounds = new Rectangle(new Point(0, 0), new Size(300, 200)); 
   // Sort the items in the list in ascending order. 
   imageList.Sorting = SortOrder.Ascending; 
   // Initialize the RasterCodecs class 
   RasterCodecs codecs = new RasterCodecs(); 
   // Clear existing items 
   // Create three items 
   string imagesPath = LEAD_VARS.ImagesDir; 
   for (int i = 0; i < 3; i++) 
      // Load the image 
      int index = i + 1; 
      string imageFileName = Path.Combine(imagesPath, @"ImageProcessingDemo\Image" + index.ToString() + ".cmp"); 
      RasterImage image = codecs.Load(imageFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1); 
      RasterImageListItem item = new RasterImageListItem(image, 1, "Item" + index.ToString()); 
      // Select the first item 
      if (i == 0) 
         item.Selected = true; 
      // Add the user data 
      UserData data = new UserData(); 
      data.Number = index; 
      data.Text = "This is data number " + index.ToString(); 
      item.Tag = data; 
      // Add the item to the image list 
   // Add a handler to the SelectedIndexChanged event 
   imageList.SelectedIndexChanged += new EventHandler(imageList_SelectedIndexChanged); 
private void imageList_SelectedIndexChanged(object sender, EventArgs e) 
   // User has selected an item from the RasterImageList control. 
   // Get the user data associated with the currently selected item and 
   // show it in a message box 
   RasterImageList imageList = sender as RasterImageList; 
   // Get the selected item(s) 
   RasterImageListItemCollection selectedItems = imageList.SelectedItems; 
   if (selectedItems != null && selectedItems.Count == 1) 
      RasterImageListItem item = selectedItems[0]; 
      // Load the image in its original size and set it in the viewer 
      UserData data = item.Tag as UserData; 
      string msg = string.Format("Number = {0}{1}Text = {2}", data.Number, Environment.NewLine, data.Text); 
static class LEAD_VARS 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 


Target Platforms

See Also


RasterImageListItem Class

RasterImageListItem Members

Help Version 22.0.2023.2.9
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.WinForms Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.