TreeView.ImageKey Property

Definition

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

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

Attributes

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 ("").

Applies to