VisualStyleRenderer.Handle Propriété

Définition

Espace de noms:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Source:

VisualStyleRenderer.cs

Obtient un identificateur unique pour la classe actuelle d’éléments de style visuel.

public:
 property IntPtr Handle { IntPtr get(); };

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Valeur de propriété

IntPtr

nativeint

Qui IntPtr identifie un jeu de données qui définit la classe d’éléments spécifié par Class.

Exceptions

InvalidOperationException

Le système d’exploitation ne prend pas en charge les styles visuels.

- ou -

Les styles visuels sont désactivés par l’utilisateur dans le système d’exploitation.

- ou -

Les styles visuels ne sont pas appliqués à la zone cliente des fenêtres d’application.

Remarques

Cette propriété est utilisée en interne par les VisualStyleRenderer méthodes. Si la classe d’éléments spécifiée par la Class propriété n’est pas définie par le style visuel actuel, cette propriété retourne IntPtr.Zero.

Cette valeur de propriété est invalidée lorsque le style visuel du système d’exploitation change ou lorsque l’utilisateur désactive les styles visuels. Si vous accédez directement à cette propriété, votre code doit interroger à nouveau cette propriété pour obtenir un nouveau handle lorsque l’événement SystemEvents.UserPreferenceChanged est déclenché avec la UserPreferenceChangedEventArgs.Category valeur de propriété de UserPreferenceCategory.VisualStyle.