VisualStyleRenderer.SetParameters Método

Definición

Espacio de nombres:

System.Windows.Forms.VisualStyles

Ensamblado:

System.Windows.Forms.dll

Establece el elemento de estilo visual actual de este VisualStyleRenderer.

Sobrecargas

SetParameters(String, Int32, Int32)	Establece este VisualStyleRenderer en el elemento de estilo visual representado por los valores de clase, parte y estado especificados.
SetParameters(VisualStyleElement)	Establece este VisualStyleRenderer en el elemento de estilo visual representado por el VisualStyleElement especificado.

SetParameters(String, Int32, Int32)

Source:

VisualStyleRenderer.cs

Establece este VisualStyleRenderer en el elemento de estilo visual representado por los valores de clase, parte y 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

Nuevo valor de la propiedad Class .

part

Int32

Nuevo valor de la propiedad Part .

state

Int32

Nuevo valor de la propiedad State .

Excepciones

ArgumentException

La combinación de className, part y state no está definida por el estilo visual actual.

InvalidOperationException

El sistema operativo no admite estilos visuales.

o bien

El usuario ha deshabilitado los estilos visuales en el sistema operativo.

o bien

Los estilos visuales no se aplican al área de cliente de las ventanas de aplicación.

Comentarios

Este método comprueba el valor de la IsSupported propiedad internamente. Antes de llamar a este método, debe llamar al IsElementDefined método para comprobar que el estilo visual actual proporciona una definición para el elemento especificado por los classNameparámetros , party state .

SetParameters(VisualStyleElement)

Source:

VisualStyleRenderer.cs

Establece este VisualStyleRenderer en el elemento de estilo visual representado por el 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

VisualStyleElement que especifica los nuevos valores de las propiedades Class, Part y State.

Excepciones

ArgumentException

El estilo visual actual no define element.

InvalidOperationException

El sistema operativo no admite estilos visuales.

o bien

El usuario ha deshabilitado los estilos visuales en el sistema operativo.

o bien

Los estilos visuales no se aplican al área de cliente de las ventanas de aplicación.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el SetParameters(VisualStyleElement) método para establecer un objeto en VisualStyleRenderer un nuevo VisualStyleElement. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la información general de la VisualStyleRenderer clase.

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

Comentarios

Este método comprueba el valor de la IsSupported propiedad internamente. Antes de llamar a este método, debe llamar al IsElementDefined método para comprobar que el estilo visual actual proporciona una definición para el elemento especificado por el element parámetro .