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.

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; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter))>]
[<System.Windows.Forms.RelatedImageList("TreeView.StateImageList")>]
member this.StateImageKey : string with get, set
Public Property StateImageKey As String

Eigenschaftswert

Der Schlüssel des Bilds, das den Zustand des TreeNode angibt.

Attribute

Hinweise

Der von dieser Eigenschaft zurückgegebene Imageschlüssel ist in der StateImageList Eigenschaft des übergeordneten TreeView Steuerelements enthalten.

Wenn die übergeordneten TreeView Kontrollkästchen aktiviert sind, wird das StateImageKey -Element ignoriert, und der Knoten zeigt das erste oder zweite Bild in der StateImageList Gruppe auf dem übergeordneten TreeView Element an, um einen deaktivierten oder aktivierten Zustand anzugeben. Das Umschalten der Checked Eigenschaft wirkt sich nicht auf den Wert von aus StateImageKey.

Die StateImageKey Eigenschaften und StateImageIndex schließen sich gegenseitig aus, d. h., wenn eine festgelegt ist, wird die andere ignoriert. Wenn Sie die StateImageKey Eigenschaft festlegen, wird die StateImageIndex Eigenschaft automatisch auf -1 festgelegt. Alternativ wird , wenn Sie festlegen StateImageIndex, StateImageKey automatisch auf eine leere Zeichenfolge ("") festgelegt. Sie sollten die StateImageKey auf ein Bild mit einem entsprechenden Index zwischen 0 und 14 festlegen. Sie können auf StateImageKey ein Bild mit einem Indexwert größer als 14 festlegen (eine Ausnahme wird nicht ausgelöst), aber das Bild wird möglicherweise nicht angezeigt.

Gilt für:

Weitere Informationen