VisualStyleRenderer.Handle 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.
Ruft einen eindeutigen Bezeichner für die aktuelle Klasse von visuellen Stilelementen ab.
public:
property IntPtr Handle { IntPtr get(); };
public IntPtr Handle { get; }
member this.Handle : nativeint
Public ReadOnly Property Handle As IntPtr
Eigenschaftswert
nativeint
Ein IntPtr, der einen Datensatz bezeichnet, durch die die Klasse der von der Class angegebenen Elemente definiert wird.
Ausnahmen
Das Betriebssystem unterstützt keine visuellen Stile.
- oder -
Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.
- oder -
Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.
Hinweise
Diese Eigenschaft wird intern von den VisualStyleRenderer Methoden verwendet. Wenn die von der Class -Eigenschaft angegebene Klasse von Elementen nicht durch den aktuellen visuellen Stil definiert wird, gibt diese Eigenschaft zurück IntPtr.Zero.
Dieser Eigenschaftswert wird ungültig, wenn sich der visuelle Stil des Betriebssystems ändert oder wenn der Benutzer visuelle Stile deaktiviert. Wenn Sie direkt auf diese Eigenschaft zugreifen, sollte Ihr Code diese Eigenschaft erneut abfragen, um ein neues Handle zu erhalten, wenn das SystemEvents.UserPreferenceChanged Ereignis mit dem UserPreferenceChangedEventArgs.Category Eigenschaftswert von UserPreferenceCategory.VisualStyleausgelöst wird.