VisualStyleRenderer.IsElementDefined(VisualStyleElement) Method

Definition

Determines whether the specified visual style element is defined by the current visual style.

public static bool IsElementDefined (System.Windows.Forms.VisualStyles.VisualStyleElement element);

Parameters

element
VisualStyleElement

A VisualStyleElement whose class and part combination will be verified.

Returns

true if the combination of the ClassName and Part properties of element are defined; otherwise, false.

Exceptions

The operating system does not support visual styles.

-or-

Visual styles are disabled by the user in the operating system.

-or-

Visual styles are not applied to the client area of application windows.

Examples

The following code example demonstrates how to use the IsElementDefined method to determine whether to initialize a VisualStyleRenderer to a given VisualStyleElement. This code example is part of a larger example provided for the VisualStyleRenderer class overview.

// 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;
}

Remarks

This method checks the value of the IsSupported property internally.

Applies to

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9