TreeView.ImageKey Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TreeView.cs

Gets or sets the key of the default image for each node in the TreeView control when it is in an unselected state.

public:
 property System::String ^ ImageKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter))]
[System.Windows.Forms.RelatedImageList("ImageList")]
public string ImageKey { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter))>]
[<System.Windows.Forms.RelatedImageList("ImageList")>]
member this.ImageKey : string with get, set

Public Property ImageKey As String

Property Value

String

The key of the default image shown for each node TreeView control when the node is in an unselected state.

Attributes

TypeConverterAttribute RelatedImageListAttribute

Remarks

The ImageKey property is case-insensitive.

If a TreeNode does not have an image set, the image specified by the ImageKey property will be shown when the node is not selected. When the node is selected, the first item in the ImageList will be shown.

ImageKey and ImageIndex are mutually exclusive, meaning if one is set, the other is set to an invalid value and ignored. If you set the ImageKey property, the ImageIndex property is automatically set to -1. Alternatively, if you set the ImageIndex property, the ImageKey is automatically set to an empty string ("").