VisualStyleRenderer 构造函数

定义

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

初始化 VisualStyleRenderer 类的新实例。

重载

名称 说明
VisualStyleRenderer(VisualStyleElement)

使用给定VisualStyleRenderer的初始化类的新实例VisualStyleElement。
VisualStyleRenderer(String, Int32, Int32)

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

VisualStyleRenderer(VisualStyleElement)

Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs

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

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
VisualStyleElement

这将表示的VisualStyleElement一个VisualStyleRenderer。

例外

InvalidOperationException

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

-或-

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

-或-

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

ArgumentException

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

注解

此构造函数使用VisualStyleElement.ClassName参数的 VisualStyleElement.Part 、VisualStyleElement.State属性和element属性来初始化ClassPart和State属性。

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

适用于

VisualStyleRenderer(String, Int32, Int32)

Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs
Source:
VisualStyleRenderer.cs

使用给定类 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 的状态。

例外

InvalidOperationException

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

-或-

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

-或-

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

ArgumentException

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

ArgumentNullException

.NET 5 及更高版本： className 是 null。

注解

此构造函数使用className和partstate参数初始化ClassPartState和属性。

使用此构造函数之前，应调用staticIsElementDefined该方法来验证当前视觉样式是否为由 classNamepart 和state参数指定的元素提供定义。

适用于