TreeNode.StateImageKey Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Schlüssels des Bilds, das verwendet wird, um den Status des TreeNode Objekts anzugeben, wenn das übergeordnete Element TreeView seine CheckBoxes Eigenschaft auf falsefestgelegt hat.
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, setPublic Property StateImageKey As StringEigenschaftswert
Der Schlüssel des Bilds, das verwendet wird, um den Zustand des TreeNode.
- Attribute
Hinweise
Der von dieser Eigenschaft zurückgegebene Bildschlüssel ist in der StateImageList Eigenschaft des übergeordneten TreeView Steuerelements enthalten.
Wenn das übergeordnete TreeView Element Kontrollkästchen aktiviert hat, wird dies StateImageKey ignoriert, und der Knoten zeigt das erste oder zweite Bild im StateImageList Satz des übergeordneten TreeView Elements an, um einen deaktivierten bzw. aktivierten Zustand anzugeben. Das Umschalten der Checked Eigenschaft wirkt sich nicht auf den Wert des StateImageKey.
Die StateImageKey Eigenschaften StateImageIndex schließen sich gegenseitig aus, d. h., wenn eine festgelegt wird, wird der andere ignoriert. Wenn Sie die StateImageKey Eigenschaft festlegen, wird die StateImageIndex Eigenschaft automatisch auf -1 festgelegt. Wenn Sie festlegen StateImageIndex, StateImageKey wird die Zeichenfolge auch automatisch auf eine leere Zeichenfolge ("") festgelegt. Sie sollten das StateImageKey Bild auf ein Bild mit einem entsprechenden Index zwischen 0 und 14 festlegen. Sie können das StateImageKey Bild auf ein Bild mit einem Indexwert festlegen, der größer als 14 ist (eine Ausnahme wird nicht ausgelöst), aber das Bild wird möglicherweise nicht angezeigt.
