VisualStyleRenderer 建構函式

定義

命名空間:

System.Windows.Forms.VisualStyles

組件:

System.Windows.Forms.dll

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

多載

名稱	Description
VisualStyleRenderer(VisualStyleElement)	使用給定VisualStyleRenderer的 初始化類別的新實例VisualStyleElement。
VisualStyleRenderer(String, Int32, Int32)	使用給定的類別、部分和狀態值初始化該類別的新 VisualStyleRenderer 實例。

VisualStyleRenderer(VisualStyleElement)

來源:

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這代表了A。

例外狀況

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性質來初始化 Class、 Part、 及State性質。

在使用此建構器之前，你應該先呼叫該 staticIsElementDefined 方法，以確認目前的視覺風格是否能為參數指定的 element 元素提供定義。

VisualStyleRenderer(String, Int32, Int32)

來源:

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

、 、 className 的組合partstate並未由當前的視覺風格所定義。

ArgumentNullException

.NET 5 及以後版本： className 是 null。

備註

此構造器使用 className、 part及 state 參數來初始化 Class、 Part、 及 State 性質。

在使用此建構子之前，你應該先呼叫該staticIsElementDefined方法，以確認目前的視覺風格是否能為 、 className、 和part參數所指定的state元素提供定義。