VisualStyleRenderer.Handle Propriedade

Definição

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Origem:

VisualStyleRenderer.cs

Obtém um identificador exclusivo para a classe atual de elementos de estilo visual.

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

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Valor da propriedade

IntPtr

nativeint

Um IntPtr que identifica um conjunto de dados que define a classe de elementos especificada por Class.

Exceções

InvalidOperationException

O sistema operacional não dá suporte a estilos visuais.

- ou -

Os estilos visuais estão desabilitados pelo usuário no sistema operacional.

- ou -

Os estilos visuais não são aplicados à área de cliente das janelas de aplicativos.

Comentários

Essa propriedade é usada internamente pelos VisualStyleRenderer métodos . Se a classe de elementos especificada pela Class propriedade não for definida pelo estilo visual atual, essa propriedade retornará IntPtr.Zero.

Esse valor de propriedade é invalidado quando o estilo visual do sistema operacional é alterado ou quando o usuário desabilita estilos visuais. Se você acessar essa propriedade diretamente, seu código deverá consultar essa propriedade novamente para obter um novo identificador quando o SystemEvents.UserPreferenceChanged evento for gerado com o UserPreferenceChangedEventArgs.Category valor da propriedade de UserPreferenceCategory.VisualStyle.