VisualStyleRenderer.IsElementDefined(VisualStyleElement) Methode

Definition

Namespace:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Bestimmt, ob das angegebene visuelle Stilelement vom aktuellen visuellen Stil 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

Ein VisualStyleElement, dessen Kombination aus Klasse und Teil überprüft wird.

Gibt zurück

Boolean

true, wenn die Kombination der ClassName-Eigenschaft und der Part-Eigenschaft von element definiert ist, andernfalls false.

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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IsElementDefined -Methode verwendet wird, um zu bestimmen, ob eine VisualStyleRenderer für eine bestimmte VisualStyleElementinitialisiert werden soll. Dieses Codebeispiel ist Teil eines größeren Beispiels 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

Diese Methode überprüft den Wert der IsSupported Eigenschaft intern.