In This Topic ▼

Tag Property

Summary

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

Syntax

C++/CLI

C++

public object Tag { get; set; }

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

public:  
   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).

Remarks

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.

Example

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 
   imageList.Items.Clear(); 
 
   // 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 
      imageList.Items.Add(item); 
   } 
 
   // 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); 
      MessageBox.Show(msg); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms