VisualStyleRenderer Construtores

Definição

Espaço de Nomes:
System.Windows.Forms.VisualStyles
Assemblagem:
System.Windows.Forms.dll

Inicializa uma nova instância da VisualStyleRenderer classe.

Sobrecargas

Name Description
VisualStyleRenderer(VisualStyleElement)

Inicializa uma nova instância da VisualStyleRenderer classe usando o dado VisualStyleElement.
VisualStyleRenderer(String, Int32, Int32)

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

VisualStyleRenderer(VisualStyleElement)

Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs

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

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

A VisualStyleElement que isto VisualStyleRenderer irá representar.

Exceções

InvalidOperationException

O sistema operativo não suporta estilos visuais.

-ou-

Os estilos visuais são desativados pelo utilizador no sistema operativo.

-ou-

Estilos visuais não são aplicados à área cliente das janelas de aplicação.

ArgumentException

element não é definido pelo estilo visual atual.

Exemplos

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

    // 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

Observações

Este construtor usa os VisualStyleElement.ClassName, , e VisualStyleElement.Part as propriedades do VisualStyleElement.State parâmetro para inicializar os element, Class, e Part as Statepropriedades.

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

Aplica-se a

VisualStyleRenderer(String, Int32, Int32)

Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs
Origem:
VisualStyleRenderer.cs

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

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 isto VisualStyleRenderer irá representar.

part
Int32

A parte do elemento que isto VisualStyleRenderer irá representar.

state
Int32

O estado do elemento que isto VisualStyleRenderer irá representar.

Exceções

InvalidOperationException

O sistema operativo não suporta estilos visuais.

-ou-

Os estilos visuais são desativados pelo utilizador no sistema operativo.

-ou-

Estilos visuais não são aplicados à área cliente das janelas de aplicação.

ArgumentException

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

ArgumentNullException

.NET 5 e posteriores: className é null.

Observações

Este construtor usa os classNameparâmetros , part, e state para inicializar os Class, Part, e State as propriedades.

Antes de usar este construtor, deve chamar o staticIsElementDefined método para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelos classNameparâmetros, part, e state .

Aplica-se a