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 usando el objeto VisualStyleElement especificado.
VisualStyleRenderer(String, Int32, Int32)	Inicializa una nueva instancia de la clase VisualStyleRenderer utilizando los valores de clase, parte y estado dados.

VisualStyleRenderer(VisualStyleElement)

Inicializa una nueva instancia de la clase VisualStyleRenderer usando el objeto VisualStyleElement especificado.

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

ArgumentException

El estilo visual actual no define element.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el VisualStyleRenderer(VisualStyleElement) constructor 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 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 constructor usa las VisualStyleElement.ClassNamepropiedades , VisualStyleElement.Party VisualStyleElement.State del element parámetro para inicializar las Classpropiedades , Party State .

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

VisualStyleRenderer(String, Int32, Int32)

Inicializa una nueva instancia de la clase VisualStyleRenderer utilizando los valores de clase, parte y 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

El nombre de clase del elemento que VisualStyleRenderer representará.

part

Int32

La parte del elemento que VisualStyleRenderer representará.

state

Int32

El estado del elemento que VisualStyleRenderer representará.

Excepciones

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.

ArgumentException

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

ArgumentNullException

.NET 5 y versiones posteriores: className es null.

Comentarios

Este constructor usa los classNameparámetros , party state para inicializar las Classpropiedades , Party State .

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