VisualStyleRenderer.Handle Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms.VisualStyles

Zestaw:

System.Windows.Forms.dll

Pobiera unikatowy identyfikator bieżącej klasy elementów stylu wizualizacji.

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

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Wartość właściwości

IntPtr

nativeint

Element IntPtr , który identyfikuje zestaw danych, który definiuje klasę elementów określonych przez Classelement .

Wyjątki

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

-lub-

Style wizualizacji są wyłączone przez użytkownika w systemie operacyjnym.

-lub-

Style wizualne nie są stosowane do obszaru klienta okien aplikacji.

Uwagi

Ta właściwość jest używana wewnętrznie przez VisualStyleRenderer metody. Jeśli klasa elementów określona przez Class właściwość nie jest zdefiniowana przez bieżący styl wizualizacji, ta właściwość zwraca wartość IntPtr.Zero.

Ta wartość właściwości jest unieważniona, gdy styl wizualny systemu operacyjnego ulegnie zmianie lub gdy użytkownik wyłączy style wizualizacji. Jeśli uzyskujesz bezpośredni dostęp do tej właściwości, kod powinien wykonać zapytanie dotyczące tej właściwości ponownie, aby uzyskać nowy uchwyt po wystąpieniu SystemEvents.UserPreferenceChanged zdarzenia z UserPreferenceChangedEventArgs.Category wartością UserPreferenceCategory.VisualStylewłaściwości .