VisualStyleRenderer 建構函式

定義

命名空間:

System.Windows.Forms.VisualStyles

組件:

System.Windows.Forms.dll

初始化 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

VisualStyleElement

這個 VisualStyleRenderer 將代表的 VisualStyleElement。

例外狀況

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

備註

這個建構函式會使用 element 參數的 VisualStyleElement.ClassName、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 和更新版本：classNamenull。

備註

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

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