VisualStyleRenderer.IsElementDefined(VisualStyleElement) 方法

  • 参考

定义

命名空间:
System.Windows.Forms.VisualStyles
程序集:
System.Windows.Forms.dll

确定当前视觉样式是否定义了指定的视觉样式元素。

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

参数

element
VisualStyleElement

将验证其类和部件组合的 VisualStyleElement。

返回

Boolean

如果定义了 element 的 ClassName 和 Part 属性的组合，则为 true；否则为 false。

例外

InvalidOperationException

操作系统不支持视觉样式。

- 或 -

用户在操作系统中禁用视觉样式。

- 或 -

视觉样式不应用于应用程序窗口的工作区。

示例

下面的代码示例演示如何使用 IsElementDefined 方法确定是否将 初始化 VisualStyleRenderer 为给定 VisualStyleElement。 此代码示例是为类概述提供的更大示例的 VisualStyleRenderer 一部分。

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

注解

此方法在内部检查属性的值 IsSupported 。

适用于