VisualStyleRenderer.SetParameters Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms.VisualStyles
Assembly:
System.Windows.Forms.dll

Legt das aktuelle visuelle Stilelement dieses VisualStyleRenderer fest.

Überlädt

SetParameters(String, Int32, Int32)

Legt diesen VisualStyleRenderer auf das visuelle Stilelement fest, das durch die angegebenen Werte für die Klasse, den Teil und den Zustand dargestellt wird.
SetParameters(VisualStyleElement)

Legt diesen VisualStyleRenderer auf das durch das angegebene VisualStyleElement dargestellte visuelle Stilelement fest.

SetParameters(String, Int32, Int32)

Legt diesen VisualStyleRenderer auf das visuelle Stilelement fest, das durch die angegebenen Werte für die Klasse, den Teil und den Zustand dargestellt wird.

public:
 void SetParameters(System::String ^ className, int part, int state);
public void SetParameters (string className, int part, int state);
member this.SetParameters : string * int * int -> unit
Public Sub SetParameters (className As String, part As Integer, state As Integer)

Parameter

className
String

Der neue Wert der Class -Eigenschaft.

part
Int32

Der neue Wert der Part -Eigenschaft.

state
Int32

Der neue Wert der State -Eigenschaft.

Ausnahmen

ArgumentException

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

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.

Hinweise

Diese Methode überprüft den Wert der IsSupported Eigenschaft intern. Bevor Sie diese Methode aufrufen, sollten Sie die IsElementDefined Methode aufrufen, um zu überprüfen, ob die aktuelle visuelle Formatvorlage eine Definition für das durch die className, partund state parameter angegebene Element bereitstellt.

Gilt für

SetParameters(VisualStyleElement)

Legt diesen VisualStyleRenderer auf das durch das angegebene VisualStyleElement dargestellte visuelle Stilelement fest.

public:
 void SetParameters(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);
public void SetParameters (System.Windows.Forms.VisualStyles.VisualStyleElement element);
member this.SetParameters : System.Windows.Forms.VisualStyles.VisualStyleElement -> unit
Public Sub SetParameters (element As VisualStyleElement)

Parameter

element
VisualStyleElement

Ein VisualStyleElement, das die neuen Werte der Eigenschaften Class, Part und State angibt.

Ausnahmen

ArgumentException

element wird vom aktuellen visuellen Stil nicht definiert.

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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SetParameters(VisualStyleElement) Methode zum Festlegen einer VisualStyleRenderer neuen VisualStyleElementMethode verwendet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die VisualStyleRenderer Klassenübersicht 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

Diese Methode überprüft den Wert der IsSupported Eigenschaft intern. Bevor Sie diese Methode aufrufen, sollten Sie die IsElementDefined Methode aufrufen, um zu überprüfen, ob die aktuelle visuelle Formatvorlage eine Definition für das durch den element Parameter angegebene Element bereitstellt.

Gilt für