VisualStyleRenderer Constructores

Definición

Espacio de nombres:

System.Windows.Forms.VisualStyles

Ensamblado:

System.Windows.Forms.dll

Inicializa una nueva instancia de la clase VisualStyleRenderer.

Sobrecargas

VisualStyleRenderer(VisualStyleElement)	Inicializa una nueva instancia de la clase VisualStyleRenderer mediante el VisualStyleElementespecificado.
VisualStyleRenderer(String, Int32, Int32)	Inicializa una nueva instancia de la clase VisualStyleRenderer mediante los valores de clase, parte y estado especificados.

VisualStyleRenderer(VisualStyleElement)

Inicializa una nueva instancia de la clase VisualStyleRenderer mediante el VisualStyleElementespecificado.

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

Un VisualStyleElement que representará este VisualStyleRenderer.

Excepciones

InvalidOperationException

El sistema operativo no admite estilos visuales.

-o-

El usuario deshabilita los estilos visuales en el sistema operativo.

-o-

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

ArgumentException

element no está definido por el estilo visual actual.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el constructor VisualStyleRenderer(VisualStyleElement) para crear un VisualStyleRenderer. Este ejemplo de código forma parte de un ejemplo de código más grande proporcionado para la información general de la clase 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

Comentarios

Este constructor usa las propiedades VisualStyleElement.ClassName, VisualStyleElement.Party VisualStyleElement.State del parámetro element para inicializar las propiedades de Class, Party State.

Antes de usar este constructor, debe llamar al método staticIsElementDefined para comprobar si el estilo visual actual proporciona una definición para el elemento especificado por el parámetro element.

VisualStyleRenderer(String, Int32, Int32)

Inicializa una nueva instancia de la clase VisualStyleRenderer mediante los valores de clase, parte y estado especificados.

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

Nombre de clase del elemento que representará este VisualStyleRenderer.

part

Int32

Parte del elemento que representará este VisualStyleRenderer.

state

Int32

Estado del elemento que representará este VisualStyleRenderer.

Excepciones

InvalidOperationException

El sistema operativo no admite estilos visuales.

-o-

El usuario deshabilita los estilos visuales en el sistema operativo.

-o-

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

ArgumentException

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

ArgumentNullException

.NET 5 y versiones posteriores: className es null.

Comentarios

Este constructor usa los parámetros className, party state para inicializar las propiedades Class, Party State.

Antes de usar este constructor, debe llamar al método staticIsElementDefined para comprobar si el estilo visual actual proporciona una definición para el elemento especificado por los parámetros className, party state.