VisualStyleRenderer Konstruktoren

Definition

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Initialisiert eine neue Instanz der VisualStyleRenderer-Klasse.

Überlädt

VisualStyleRenderer(VisualStyleElement)	Initialisiert eine neue Instanz der VisualStyleRenderer-Klasse mit dem angegebenen VisualStyleElement.
VisualStyleRenderer(String, Int32, Int32)	Initialisiert mit den angegebenen Klassen-, Teil- und Zustandswerten eine neue Instanz der VisualStyleRenderer-Klasse.

VisualStyleRenderer(VisualStyleElement)

Initialisiert eine neue Instanz der VisualStyleRenderer-Klasse mit dem angegebenen VisualStyleElement.

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)

Parameter

element

VisualStyleElement

Ein VisualStyleElement, das dieser VisualStyleRenderer darstellt.

Ausnahmen

InvalidOperationException

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

ArgumentException

element wird vom aktuellen visuellen Stil nicht definiert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der VisualStyleRenderer(VisualStyleElement) -Konstruktor zum Erstellen eines VisualStyleRendererverwendet wird. Dieses Codebeispiel ist Teil eines größeren Codebeispiels für die VisualStyleRenderer Klassenübersicht.

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

Hinweise

Dieser Konstruktor verwendet die VisualStyleElement.ClassNameEigenschaften , VisualStyleElement.Partund VisualStyleElement.State des element Parameters, um die ClassEigenschaften , Partund State zu initialisieren.

Bevor Sie diesen Konstruktor verwenden, sollten Sie die staticIsElementDefined -Methode aufrufen, um zu überprüfen, ob der aktuelle visuelle Stil eine Definition für das durch den element -Parameter angegebene Element bereitstellt.

VisualStyleRenderer(String, Int32, Int32)

Initialisiert mit den angegebenen Klassen-, Teil- und Zustandswerten eine neue Instanz der VisualStyleRenderer-Klasse.

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)

Parameter

className

String

Der Klassenname des Elements, das dieser VisualStyleRenderer darstellt.

part

Int32

Der Teil des Elements, den dieser VisualStyleRenderer darstellt.

state

Int32

Der Zustand des Elements, den dieser VisualStyleRenderer darstellt.

Ausnahmen

InvalidOperationException

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

ArgumentException

Die Kombination aus className, part und state wird vom aktuellen visuellen Stil nicht definiert.

ArgumentNullException

.NET 5 und höher: className ist null.

Hinweise

Dieser Konstruktor verwendet die classNameParameter , partund state , um die ClassEigenschaften , Partund State zu initialisieren.

Bevor Sie diesen Konstruktor verwenden, sollten Sie die staticIsElementDefined -Methode aufrufen, um zu überprüfen, ob der aktuelle visuelle Stil eine Definition für das element bereitstellt, das durch die classNameParameter , partund state angegeben wird.