VisualStyleRenderer コンストラクター

定義

名前空間:

System.Windows.Forms.VisualStyles

アセンブリ:

System.Windows.Forms.dll

VisualStyleRenderer クラスの新しいインスタンスを初期化します。

オーバーロード

VisualStyleRenderer(VisualStyleElement)	指定した VisualStyleRenderer を使用して、VisualStyleElement クラスの新しいインスタンスを初期化します。
VisualStyleRenderer(String, Int32, Int32)	指定したクラス、部品、および状態値を使用して、VisualStyleRenderer クラスの新しいインスタンスを初期化します。

VisualStyleRenderer(VisualStyleElement)

指定した 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。

例外

InvalidOperationException

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

または

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

または

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

ArgumentException

element が現在の visual スタイルで定義されていません。

例

次のコード例は、コンストラクターVisualStyleRendererを使用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

注釈

このコンストラクターは、パラメーターの VisualStyleElement.ClassName、、およびVisualStyleElement.Stateプロパティをelement使用して 、Part、およびStateプロパティをClassVisualStyleElement.Part初期化します。

このコンストラクターを使用する前に、メソッドを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

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

または

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

または

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

ArgumentException

className、part、および state の組み合わせを、現在の visual スタイルが定義していません。

ArgumentNullException

.NET 5 以降: className です null。

注釈

このコンストラクターでは、className、part、およびstateパラメーターを使用して、、Part、およびStateプロパティをClass初期化します。

このコンストラクターを使用する前に、メソッドをstaticIsElementDefined呼び出して、現在のビジュアル スタイルで 、part、およびstateパラメーターでclassName指定された要素の定義が提供されているかどうかを確認する必要があります。