VisualStyleRenderer.Handle Eigenschaft

Definition

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

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

IntPtr

nativeint

Ein IntPtr, der einen Datensatz bezeichnet, durch die die Klasse der von der Class angegebenen Elemente definiert wird.

Ausnahmen

InvalidOperationException

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.