VisualStyleRenderer.SetParameters 方法

定義

命名空間:

System.Windows.Forms.VisualStyles

組件:

System.Windows.Forms.dll

設定這個 VisualStyleRenderer 的目前視覺化樣式項目。

多載

SetParameters(String, Int32, Int32)	將這個 VisualStyleRenderer 設為由指定之類別、組件和狀態值表示的視覺化樣式項目。
SetParameters(VisualStyleElement)	將這個 VisualStyleRenderer 設為由指定之 VisualStyleElement 表示的視覺化樣式項目。

SetParameters(String, Int32, Int32)

將這個 VisualStyleRenderer 設為由指定之類別、組件和狀態值表示的視覺化樣式項目。

public:
 void SetParameters(System::String ^ className, int part, int state);

public void SetParameters (string className, int part, int state);

member this.SetParameters : string * int * int -> unit

Public Sub SetParameters (className As String, part As Integer, state As Integer)

參數

className

String

Class 屬性的新值。

part

Int32

Part 屬性的新值。

state

Int32

State 屬性的新值。

例外狀況

ArgumentException

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

InvalidOperationException

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

-或-

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

-或-

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

備註

這個方法會在內部檢查屬性的值 IsSupported 。 呼叫這個方法之前，您應該呼叫 IsElementDefined 方法，以確認目前的視覺化樣式提供 、 part 和 state 參數所 className 指定元素的定義。

SetParameters(VisualStyleElement)

將這個 VisualStyleRenderer 設為由指定之 VisualStyleElement 表示的視覺化樣式項目。

public:
 void SetParameters(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);

public void SetParameters (System.Windows.Forms.VisualStyles.VisualStyleElement element);

member this.SetParameters : System.Windows.Forms.VisualStyles.VisualStyleElement -> unit

Public Sub SetParameters (element As VisualStyleElement)

參數

element

VisualStyleElement

VisualStyleElement，指定 Class、Part 和 State 屬性的新值。

例外狀況

ArgumentException

目前的視覺化樣式未定義 element。

InvalidOperationException

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

-或-

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

-或-

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

範例

下列程式碼範例示範如何使用 SetParameters(VisualStyleElement) 方法將 設定 VisualStyleRenderer 為新的 VisualStyleElement 。 此程式碼範例是類別概觀所提供較大範例的 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

備註

這個方法會在內部檢查屬性的值 IsSupported 。 呼叫這個方法之前，您應該呼叫 IsElementDefined 方法，以確認目前的視覺化樣式提供 參數所 element 指定元素的定義。