VisualStyleRenderer.SetParameters Método

Definição

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

Define o elemento visual atual deste VisualStyleRenderer.

Sobrecargas

Name Description
SetParameters(String, Int32, Int32)

Define isto VisualStyleRenderer para o elemento de estilo visual representado pelos valores especificados de classe, parte e estado.
SetParameters(VisualStyleElement)

Define isto VisualStyleRenderer para o elemento de estilo visual representado pelo especificado VisualStyleElement.

SetParameters(String, Int32, Int32)

Define isto VisualStyleRenderer para o elemento de estilo visual representado pelos valores especificados de classe, parte e estado.

public:
 void SetParameters(System::String ^ className, int part, int state);
public void SetParameters(string className, int part, int state);
member this.SetParameters : string * int * int -> unit
Public Sub SetParameters (className As String, part As Integer, state As Integer)

Parâmetros

className
String

O novo valor da Class propriedade.

part
Int32

O novo valor da Part propriedade.

state
Int32

O novo valor da State propriedade.

Exceções

ArgumentException

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

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.

Observações

Este método verifica internamente o valor da IsSupported propriedade. Antes de chamar este método, deve chamá-lo IsElementDefined para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelos classNameparâmetros, part, e state .

Aplica-se a

SetParameters(VisualStyleElement)

Define isto VisualStyleRenderer para o elemento de estilo visual representado pelo especificado VisualStyleElement.

public:
 void SetParameters(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);
public void SetParameters(System.Windows.Forms.VisualStyles.VisualStyleElement element);
member this.SetParameters : System.Windows.Forms.VisualStyles.VisualStyleElement -> unit
Public Sub SetParameters (element As VisualStyleElement)

Parâmetros

element
VisualStyleElement

A VisualStyleElement que especifica os novos valores dos Class, Part, e State das propriedades.

Exceções

ArgumentException

element não é definido pelo estilo visual atual.

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.

Exemplos

O seguinte exemplo de código demonstra como usar o SetParameters(VisualStyleElement) método para definir a VisualStyleRenderer como um novo VisualStyleElement. Este exemplo de código faz parte de um exemplo maior 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 método verifica internamente o valor da IsSupported propriedade. Antes de chamar este método, deve chamá-lo IsElementDefined para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelo element parâmetro.

Aplica-se a