VisualStyleRenderer 建構函式

定義

命名空間:

System.Windows.Forms.VisualStyles

組件:

System.Windows.Forms.dll

初始化 VisualStyleRenderer 類別的新執行個體。

多載

VisualStyleRenderer(VisualStyleElement)	使用指定的 VisualStyleRenderer，初始化 VisualStyleElement 類別的新執行個體。
VisualStyleRenderer(String, Int32, Int32)	使用指定的類別、組件和狀態值，初始化 VisualStyleRenderer 類別的新執行個體。

VisualStyleRenderer(VisualStyleElement)

使用指定的 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 參數的 element 、 VisualStyleElement.Part 和 VisualStyleElement.State 屬性來初始化 Class 、 Part 和 State 屬性。

使用此建構函式之前，您應該呼叫 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 將表示的項目狀態。

例外狀況

InvalidOperationException

作業系統不支援視覺化樣式。

-或-

使用者已停用作業系統中的視覺化樣式。

-或-

視覺化樣式不適用於應用程式視窗的工作區。

ArgumentException

目前的視覺化樣式未定義 className、part 和 state 的組合。

ArgumentNullException

.NET 5 和更新版本： className 是 null 。

備註

這個建構函式會 className 使用 、 part 和 state 參數來初始化 Class 、 Part 和 State 屬性。

使用此建構函式之前，您應該呼叫 staticIsElementDefined 方法，以確認目前的視覺化樣式是否提供 、 part 和 state 參數所 className 指定元素的定義。