VisualStyleRenderer.SetParameters Método

  • Referência

Definição

Namespace:
System.Windows.Forms.VisualStyles
Assembly:
System.Windows.Forms.dll

Define o elemento de estilo visual atual deste VisualStyleRenderer.

Sobrecargas

SetParameters(String, Int32, Int32)

Define este VisualStyleRenderer como o elemento de estilo visual representado pela classe, pelo bloco e pelos valores de estado especificados.
SetParameters(VisualStyleElement)

Define este VisualStyleRenderer como o elemento de estilo visual representado pelo VisualStyleElement especificado.

SetParameters(String, Int32, Int32)

Define este VisualStyleRenderer como o elemento de estilo visual representado pela classe, pelo bloco e pelos valores de estado especificados.

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 propriedade Class.

part
Int32

O novo valor da propriedade Part.

state
Int32

O novo valor da propriedade State.

Exceções

ArgumentException

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

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

Esse método verifica o valor da IsSupported propriedade internamente. Antes de chamar esse método, você deve chamar o IsElementDefined método para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelos classNameparâmetros , parte state .

Aplica-se a

SetParameters(VisualStyleElement)

Define este VisualStyleRenderer como o elemento de estilo visual representado pelo VisualStyleElement especificado.

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

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

Exceções

ArgumentException

element não está definido pelo estilo visual atual.

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.

Exemplos

O exemplo de código a seguir demonstra como usar o SetParameters(VisualStyleElement) método para definir um VisualStyleRenderer como um novo VisualStyleElement. Este exemplo de código faz parte de um exemplo maior fornecido para a visão geral da VisualStyleRenderer 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

Comentários

Esse método verifica o valor da IsSupported propriedade internamente. Antes de chamar esse método, você deve chamar o IsElementDefined método para verificar se o estilo visual atual fornece uma definição para o elemento especificado pelo element parâmetro .

Aplica-se a