VisualStyleRenderer Costruttori

Definizione

Spazio dei nomi:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Inizializza una nuova istanza della classe VisualStyleRenderer.

Overload

VisualStyleRenderer(VisualStyleElement)	Inizializza una nuova istanza della classe VisualStyleRenderer utilizzando il VisualStyleElementspecificato.
VisualStyleRenderer(String, Int32, Int32)	Inizializza una nuova istanza della classe VisualStyleRenderer utilizzando i valori di classe, parte e stato specificati.

VisualStyleRenderer(VisualStyleElement)

Inizializza una nuova istanza della classe VisualStyleRenderer utilizzando il VisualStyleElementspecificato.

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)

Parametri

element

VisualStyleElement

VisualStyleElement che questa VisualStyleRenderer rappresenterà.

Eccezioni

InvalidOperationException

Il sistema operativo non supporta gli stili di visualizzazione.

-o-

Gli stili di visualizzazione sono disabilitati dall'utente nel sistema operativo.

-o-

Gli stili di visualizzazione non vengono applicati all'area client delle finestre dell'applicazione.

ArgumentException

element non è definito dallo stile di visualizzazione corrente.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il costruttore VisualStyleRenderer(VisualStyleElement) per creare un VisualStyleRenderer. Questo esempio di codice fa parte di un esempio di codice più ampio fornito per la panoramica della classe 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

Commenti

Questo costruttore usa le proprietà VisualStyleElement.ClassName, VisualStyleElement.Parte VisualStyleElement.State del parametro element per inizializzare le proprietà Class, Parte State.

Prima di usare questo costruttore, è necessario chiamare il metodo staticIsElementDefined per verificare se lo stile di visualizzazione corrente fornisce una definizione per l'elemento specificato dal parametro element.

VisualStyleRenderer(String, Int32, Int32)

Inizializza una nuova istanza della classe VisualStyleRenderer utilizzando i valori di classe, parte e stato specificati.

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)

Parametri

className

String

Nome della classe dell'elemento che verrà rappresentato da questo VisualStyleRenderer.

part

Int32

Parte dell'elemento che questa VisualStyleRenderer rappresenterà.

state

Int32

Stato dell'elemento che verrà rappresentato da questo VisualStyleRenderer.

Eccezioni

InvalidOperationException

Il sistema operativo non supporta gli stili di visualizzazione.

-o-

Gli stili di visualizzazione sono disabilitati dall'utente nel sistema operativo.

-o-

Gli stili di visualizzazione non vengono applicati all'area client delle finestre dell'applicazione.

ArgumentException

La combinazione di className, parte state non è definita dallo stile di visualizzazione corrente.

ArgumentNullException

.NET 5 e versioni successive: className è null.

Commenti

Questo costruttore usa i parametri className, parte state per inizializzare le proprietà Class, Parte State.

Prima di usare questo costruttore, è necessario chiamare il metodo staticIsElementDefined per verificare se lo stile di visualizzazione corrente fornisce una definizione per l'elemento specificato dai parametri className, parte state.