TreeNode.StateImageIndex Eigenschaft

Definition

Ruft den Index des Bilds ab, das den Zustand des TreeNode angibt, wenn die TreeView-Eigenschaft der übergeordneten CheckBoxes auf false festgelegt ist, oder legt diesen fest.Gets or sets the index of the image that is used to indicate the state of the TreeNode when the parent TreeView has its CheckBoxes property set to false.

public:
 property int StateImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("TreeView.StateImageList")]
public int StateImageIndex { get; set; }
member this.StateImageIndex : int with get, set
Public Property StateImageIndex As Integer

Eigenschaftswert

Der Index des Bilds, das den Zustand des TreeNode angibt.The index of the image that is used to indicate the state of the TreeNode.

Attribute

Ausnahmen

Der angegebene Index ist kleiner als -1 oder größer als 14.The specified index is less than -1 or greater than 14.

Hinweise

Der von dieser Eigenschaft zurückgegebene Bildindex ist in der StateImageList -Eigenschaft des übergeordneten TreeView -Steuer Elements enthalten.The image index that is returned by this property is contained in the StateImageList property of the parent TreeView control.

Wenn für das TreeView übergeordnete Kontrollkästchen aktiviert ist StateImageIndex , wird ignoriert, und der Knoten zeigt das erste oder zweite Bild in StateImageList der Gruppe auf dem TreeView übergeordneten Element an, um den Status "deaktiviert" oder "aktiviert" anzugeben.If the parent TreeView has check boxes enabled, the StateImageIndex is ignored and the node will display the first or second image in the StateImageList set on the parent TreeView to indicate an unchecked or checked state, respectively. Das Umschalten der Checked Eigenschaft wirkt sich nicht StateImageIndexauf den Wert von aus.Toggling the Checked property does not affect the value of the StateImageIndex.

StateImageIndex Gibt-1 zurück, wenn kein Wert festgelegt ist.The StateImageIndex returns -1 when not set. Die StateImageKey Eigenschaften StateImageIndex und schließen sich gegenseitig aus, d. h., wenn eine festgelegt ist, wird die andere ignoriert.The StateImageKey and StateImageIndex properties are mutually exclusive, meaning if one is set, the other is ignored. Wenn Sie die StateImageKey -Eigenschaft festlegen, StateImageIndex wird die-Eigenschaft automatisch auf-1 festgelegt.If you set the StateImageKey property, the StateImageIndex property is automatically set to -1. Wenn Sie festlegen StateImageIndex, StateImageKey wird von automatisch eine leere Zeichenfolge ("") festgelegt.Alternatively, if you set StateImageIndex, StateImageKey is automatically set to an empty string ("").

Gilt für:

Siehe auch