TreeNode.StateImageKey Eigenschaft

Definition

Ruft den Schlüssel 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 key 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 System::String ^ StateImageKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter))]
[System.Windows.Forms.RelatedImageList("TreeView.StateImageList")]
public string StateImageKey { get; set; }
member this.StateImageKey : string with get, set
Public Property StateImageKey As String

Eigenschaftswert

Der Schlüssel des Bilds, das den Zustand des TreeNode angibt.The key of the image that is used to indicate the state of the TreeNode.

Attribute

Hinweise

Der von dieser Eigenschaft zurückgegebene Bild Schlüssel ist in der StateImageList -Eigenschaft des übergeordneten TreeView Steuer Elements enthalten.The image key 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 StateImageKey , 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 StateImageKey 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 StateImageKeyauf den Wert von aus.Toggling the Checked property does not affect the value of the StateImageKey.

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 (""). Legen Sie für den StateImageKey auf ein Bild mit einem entsprechenden Index zwischen 0 und 14 fest.You should set the StateImageKey to an image with a corresponding index between 0 and 14. Sie können StateImageKey für ein Bild mit einem Indexwert größer als 14 festlegen (eine Ausnahme wird nicht ausgelöst), das Bild wird jedoch möglicherweise nicht angezeigt.You can set the StateImageKey to an image with an index value greater than 14 (an exception will not be thrown), but the image may not be displayed

Gilt für:

Siehe auch