VisualStyleRenderer.SetParameters Methode

Definition

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Legt das aktuelle visuelle Formatvorlagenelement dieses VisualStyleRendererElements fest.

Überlädt

Name	Beschreibung
SetParameters(String, Int32, Int32)	Legt dies VisualStyleRenderer auf das visuelle Formatelement fest, das durch die angegebenen Klassen-, Teil- und Zustandswerte dargestellt wird.
SetParameters(VisualStyleElement)	Legt dies VisualStyleRenderer auf das visuelle Formatelement fest, das durch das angegebene Element VisualStyleElementdargestellt wird.

SetParameters(String, Int32, Int32)

Quelle:

VisualStyleRenderer.cs

Legt dies VisualStyleRenderer auf das visuelle Formatelement fest, das durch die angegebenen Klassen-, Teil- und Zustandswerte 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 von className, partund state wird nicht durch die aktuelle visuelle Formatvorlage definiert.

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.

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 element bereitstellt, das durch die className, partund state parameter angegeben wird.

SetParameters(VisualStyleElement)

Quelle:

VisualStyleRenderer.cs

Legt dies VisualStyleRenderer auf das visuelle Formatelement fest, das durch das angegebene Element VisualStyleElementdargestellt wird.

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

A VisualStyleElement that specifies the new values of the Class, , Part, and State properties.

Ausnahmen

ArgumentException

element wird nicht durch die aktuelle visuelle Formatvorlage definiert.

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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SetParameters(VisualStyleElement) Methode verwendet wird, um ein VisualStyleRenderer neues VisualStyleElementObjekt festzulegen. 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.