VisualStyleRenderer Construtores

Definição

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Inicializa uma nova instância da classe VisualStyleRenderer.

Sobrecargas

VisualStyleRenderer(VisualStyleElement)	Inicializa uma nova instância da classe VisualStyleRenderer usando o VisualStyleElementdeterminado.
VisualStyleRenderer(String, Int32, Int32)	Inicializa uma nova instância da classe VisualStyleRenderer usando os valores de classe, parte e estado fornecidos.

VisualStyleRenderer(VisualStyleElement)

Inicializa uma nova instância da classe VisualStyleRenderer usando o VisualStyleElementdeterminado.

public:
 VisualStyleRenderer(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);

public VisualStyleRenderer (System.Windows.Forms.VisualStyles.VisualStyleElement element);

new System.Windows.Forms.VisualStyles.VisualStyleRenderer : System.Windows.Forms.VisualStyles.VisualStyleElement -> System.Windows.Forms.VisualStyles.VisualStyleRenderer

Public Sub New (element As VisualStyleElement)

Parâmetros

element

VisualStyleElement

Um VisualStyleElement que este VisualStyleRenderer representará.

Exceções

InvalidOperationException

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

-ou-

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

-ou-

Os estilos visuais não são aplicados à área do cliente das janelas do aplicativo.

ArgumentException

element não é definido pelo estilo visual atual.

Exemplos

O exemplo de código a seguir demonstra como usar o construtor VisualStyleRenderer(VisualStyleElement) para criar um VisualStyleRenderer. Este exemplo de código faz parte de um exemplo de código maior fornecido para a visão geral da classe VisualStyleRenderer.

    // Set the VisualStyleRenderer to a new element.
private:
    bool SetRenderer(VisualStyleElement^ element)
    {
        if (!VisualStyleRenderer::IsElementDefined(element))
        {
            return false;
        }

        if (renderer == nullptr)
        {
            renderer = gcnew VisualStyleRenderer(element);
        }
        else
        {
            renderer->SetParameters(element);
        }

        return true;
    }

// Set the VisualStyleRenderer to a new element.
private bool SetRenderer(VisualStyleElement element)
{
    if (!VisualStyleRenderer.IsElementDefined(element))
    {
        return false;
    }

    if (renderer == null)
    {
        renderer = new VisualStyleRenderer(element);
    }
    else
    {
        renderer.SetParameters(element);
    }

    return true;
}

' Set the VisualStyleRenderer to a new element.
Private Function SetRenderer(ByVal element As _
    VisualStyleElement) As Boolean

    If Not VisualStyleRenderer.IsElementDefined(element) Then
        Return False
    End If

    If renderer Is Nothing Then
        renderer = New VisualStyleRenderer(element)
    Else
        renderer.SetParameters(element)
    End If

    Return True
End Function

Comentários

Esse construtor usa as propriedades VisualStyleElement.ClassName, VisualStyleElement.Parte VisualStyleElement.State do parâmetro element para inicializar as propriedades Class, Parte State.

Antes de usar esse construtor, você deve chamar o método staticIsElementDefined para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelo parâmetro element.

VisualStyleRenderer(String, Int32, Int32)

Inicializa uma nova instância da classe VisualStyleRenderer usando os valores de classe, parte e estado fornecidos.

public:
 VisualStyleRenderer(System::String ^ className, int part, int state);

public VisualStyleRenderer (string className, int part, int state);

new System.Windows.Forms.VisualStyles.VisualStyleRenderer : string * int * int -> System.Windows.Forms.VisualStyles.VisualStyleRenderer

Public Sub New (className As String, part As Integer, state As Integer)

Parâmetros

className

String

O nome da classe do elemento que este VisualStyleRenderer representará.

part

Int32

A parte do elemento que este VisualStyleRenderer representará.

state

Int32

O estado do elemento que este VisualStyleRenderer representará.

Exceções

InvalidOperationException

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

-ou-

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

-ou-

Os estilos visuais não são aplicados à área do cliente das janelas do aplicativo.

ArgumentException

A combinação de className, parte state não é definida pelo estilo visual atual.

ArgumentNullException

.NET 5 e posterior: className é null.

Comentários

Esse construtor usa os parâmetros className, parte state para inicializar as propriedades Class, Parte State.

Antes de usar esse construtor, você deve chamar o método staticIsElementDefined para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelos parâmetros className, parte state.