VisualStyleRenderer 构造函数

定义

初始化 VisualStyleRenderer 类的新实例。

重载

VisualStyleRenderer(VisualStyleElement)

使用给定 VisualStyleElement初始化 VisualStyleRenderer 类的新实例。

VisualStyleRenderer(String, Int32, Int32)

使用给定的类、部件和状态值初始化 VisualStyleRenderer 类的新实例。

VisualStyleRenderer(VisualStyleElement)

使用给定 VisualStyleElement初始化 VisualStyleRenderer 类的新实例。

public:
 VisualStyleRenderer(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);
public VisualStyleRenderer (System.Windows.Forms.VisualStyles.VisualStyleElement element);
new System.Windows.Forms.VisualStyles.VisualStyleRenderer : System.Windows.Forms.VisualStyles.VisualStyleElement -> System.Windows.Forms.VisualStyles.VisualStyleRenderer
Public Sub New (element As VisualStyleElement)

参数

例外

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

-或-

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

-或-

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

当前视觉样式未定义 element

示例

下面的代码示例演示如何使用 VisualStyleRenderer(VisualStyleElement) 构造函数创建 VisualStyleRenderer。 此代码示例是为 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

注解

此构造函数使用 element 参数的 VisualStyleElement.ClassNameVisualStyleElement.PartVisualStyleElement.State 属性初始化 ClassPartState 属性。

使用此构造函数之前,应调用 staticIsElementDefined 方法,以验证当前视觉样式是否为 element 参数指定的元素提供定义。

适用于

VisualStyleRenderer(String, Int32, Int32)

使用给定的类、部件和状态值初始化 VisualStyleRenderer 类的新实例。

public:
 VisualStyleRenderer(System::String ^ className, int part, int state);
public VisualStyleRenderer (string className, int part, int state);
new System.Windows.Forms.VisualStyles.VisualStyleRenderer : string * int * int -> System.Windows.Forms.VisualStyles.VisualStyleRenderer
Public Sub New (className As String, part As Integer, state As Integer)

参数

className
String

VisualStyleRenderer 将表示的元素的类名。

part
Int32

VisualStyleRenderer 将表示的元素的一部分。

state
Int32

VisualStyleRenderer 将表示的元素的状态。

例外

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

-或-

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

-或-

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

当前视觉样式未定义 classNamepartstate 的组合。

.NET 5 及更高版本:classNamenull

注解

此构造函数使用 classNamepartstate 参数初始化 ClassPartState 属性。

使用此构造函数之前,应调用 staticIsElementDefined 方法,以验证当前视觉样式是否为 classNamepartstate 参数指定的元素提供定义。

适用于