VisualStyleRenderer Konstruktoren

  • Referenz

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 mithilfe des angegebenen VisualStyleElement.
VisualStyleRenderer(String, Int32, Int32)

Initialisiert eine neue Instanz der VisualStyleRenderer Klasse mithilfe der angegebenen Klassen-, Teil- und Zustandswerte.

VisualStyleRenderer(VisualStyleElement)

Initialisiert eine neue Instanz der VisualStyleRenderer Klasse mithilfe des 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

Eine VisualStyleElement, die diese VisualStyleRenderer darstellt.

Ausnahmen

InvalidOperationException

Das Betriebssystem unterstützt keine visuellen Formatvorlagen.

-oder-

Visuelle Formatvorlagen werden vom Benutzer im Betriebssystem deaktiviert.

-oder-

Visuelle Formatvorlagen werden nicht auf den Clientbereich von Anwendungsfenstern angewendet.

ArgumentException

element wird nicht durch den aktuellen visuellen Stil definiert.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des VisualStyleRenderer(VisualStyleElement)-Konstruktors zum Erstellen eines VisualStyleRendererveranschaulicht. Dieses Codebeispiel ist Teil eines größeren Codebeispiels, das für die Übersicht über die VisualStyleRenderer Klasse bereitgestellt wird.

    // 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 Eigenschaften VisualStyleElement.ClassName, VisualStyleElement.Partund VisualStyleElement.State des element-Parameters, um die Eigenschaften Class, Partund State zu initialisieren.

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

Gilt für:

VisualStyleRenderer(String, Int32, Int32)

Initialisiert eine neue Instanz der VisualStyleRenderer Klasse mithilfe der angegebenen Klassen-, Teil- und Zustandswerte.

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 dieses VisualStyleRenderer darstellt.

part
Int32

Der Teil des Elements, das dieses VisualStyleRenderer darstellt.

state
Int32

Der Status des Elements, das dieses VisualStyleRenderer darstellt.

Ausnahmen

InvalidOperationException

Das Betriebssystem unterstützt keine visuellen Formatvorlagen.

-oder-

Visuelle Formatvorlagen werden vom Benutzer im Betriebssystem deaktiviert.

-oder-

Visuelle Formatvorlagen werden nicht auf den Clientbereich von Anwendungsfenstern angewendet.

ArgumentException

Die Kombination aus className, partund state wird nicht durch die aktuelle visuelle Formatvorlage definiert.

ArgumentNullException

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

Hinweise

Dieser Konstruktor verwendet die Parameter className, partund state, um die Eigenschaften Class, Partund State zu initialisieren.

Bevor Sie diesen Konstruktor verwenden, sollten Sie die staticIsElementDefined-Methode aufrufen, um zu überprüfen, ob die aktuelle visuelle Formatvorlage eine Definition für das durch die parameter className, partund state angegebene Element bereitstellt.

Gilt für: