VisualStyleRenderer.SetParameters メソッド

定義

名前空間:

System.Windows.Forms.VisualStyles

アセンブリ:

System.Windows.Forms.dll

VisualStyleRenderer の現在の visual スタイル要素を設定します。

オーバーロード

SetParameters(String, Int32, Int32)	指定したクラス、部品、および状態値で表される visual スタイル要素に、VisualStyleRenderer を設定します。
SetParameters(VisualStyleElement)	VisualStyleRenderer を、指定した VisualStyleElement が表す visual スタイル要素に設定します。

SetParameters(String, Int32, Int32)

指定したクラス、部品、および状態値で表される visual スタイル要素に、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 の組み合わせを、現在の visual スタイルが定義していません。

InvalidOperationException

オペレーティング システムが visual スタイルをサポートしていません。

または

visual スタイルは、オペレーティング システムのユーザーにより無効にされています。

または

visual スタイルは、アプリケーション ウィンドウのクライアント領域には適用されません。

注釈

このメソッドは、プロパティの値を IsSupported 内部的にチェックします。 このメソッドを呼び出す前に、 メソッドをIsElementDefined呼び出して、現在のビジュアル スタイルが、、part、および state パラメーターで指定された要素の定義を提供していることを確認するclassName必要があります。

SetParameters(VisualStyleElement)

VisualStyleRenderer を、指定した VisualStyleElement が表す visual スタイル要素に設定します。

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 が現在の visual スタイルで定義されていません。

InvalidOperationException

オペレーティング システムが visual スタイルをサポートしていません。

または

visual スタイルは、オペレーティング システムのユーザーにより無効にされています。

または

visual スタイルは、アプリケーション ウィンドウのクライアント領域には適用されません。

例

次のコード例では、 メソッドを使用して をSetParameters(VisualStyleElement)新しい 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

注釈

このメソッドは、プロパティの値を IsSupported 内部的にチェックします。 このメソッドを呼び出す前に、 メソッドを IsElementDefined 呼び出して、現在のビジュアル スタイルで パラメーターで指定された要素の定義が提供されていることを確認する element 必要があります。