Freigeben über

VisualStyleRenderer.IsElementDefined(VisualStyleElement) Methode

Definition

Namespace:
System.Windows.Forms.VisualStyles
Assembly:
System.Windows.Forms.dll
Quelle:
VisualStyleRenderer.cs
Quelle:
VisualStyleRenderer.cs
Quelle:
VisualStyleRenderer.cs
Quelle:
VisualStyleRenderer.cs
Quelle:
VisualStyleRenderer.cs

Bestimmt, ob das angegebene visuelle Formatvorlagenelement durch die aktuelle visuelle Formatvorlage definiert wird.

public:
 static bool IsElementDefined(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);
public static bool IsElementDefined(System.Windows.Forms.VisualStyles.VisualStyleElement element);
static member IsElementDefined : System.Windows.Forms.VisualStyles.VisualStyleElement -> bool
Public Shared Function IsElementDefined (element As VisualStyleElement) As Boolean

Parameter

element
VisualStyleElement

A VisualStyleElement whose class and part combination will be verified.

Gibt zurück

Boolean

true wenn die Kombination der Definierten ClassName und Part Eigenschaften element definiert ist; andernfalls false.

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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IsElementDefined Methode verwendet wird, um zu bestimmen, ob eine VisualStyleRenderer in eine bestimmte Eigenschaft VisualStyleElementinitialisiert werden soll. 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.

Gilt für: