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 メソッドを呼び出して、現在の visual スタイルが、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 メソッドを呼び出して、現在のビジュアル スタイルが、className、part、および state パラメーターで指定された要素の定義を提供するかどうかを確認する必要があります。