VisualStyleRenderer Konstruktory

Definicja

Przestrzeń nazw:

System.Windows.Forms.VisualStyles

Zestaw:

System.Windows.Forms.dll

Inicjuje nowe wystąpienie klasy VisualStyleRenderer.

Przeciążenia

VisualStyleRenderer(VisualStyleElement)	Inicjuje VisualStyleRenderer nowe wystąpienie klasy przy użyciu podanego VisualStyleElementelementu .
VisualStyleRenderer(String, Int32, Int32)	Inicjuje VisualStyleRenderer nowe wystąpienie klasy przy użyciu danej klasy, części i wartości stanu.

VisualStyleRenderer(VisualStyleElement)

Inicjuje VisualStyleRenderer nowe wystąpienie klasy przy użyciu podanego VisualStyleElementelementu .

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)

Parametry

element

VisualStyleElement

Element VisualStyleElement , który będzie to VisualStyleRenderer reprezentować.

Wyjątki

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

-lub-

Style wizualizacji są wyłączone przez użytkownika w systemie operacyjnym.

-lub-

Style wizualne nie są stosowane do obszaru klienta okien aplikacji.

ArgumentException

element nie jest definiowany przez bieżący styl wizualizacji.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć konstruktora VisualStyleRenderer(VisualStyleElement) do utworzenia elementu VisualStyleRenderer. Ten przykład kodu jest częścią większego przykładu kodu udostępnionego VisualStyleRenderer do omówienia klasy.

    // 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

Uwagi

Ten konstruktor używa VisualStyleElement.ClassNamewłaściwości , VisualStyleElement.Parti VisualStyleElement.State parametru element do inicjowania Classwłaściwości , Parti State .

Przed użyciem tego konstruktora należy wywołać metodę staticIsElementDefined , aby sprawdzić, czy bieżący styl wizualizacji zawiera definicję elementu określonego element przez parametr .

VisualStyleRenderer(String, Int32, Int32)

Inicjuje VisualStyleRenderer nowe wystąpienie klasy przy użyciu danej klasy, części i wartości stanu.

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)

Parametry

className

String

Nazwa klasy elementu, który będzie reprezentować VisualStyleRenderer .

part

Int32

Część elementu, który będzie reprezentować VisualStyleRenderer .

state

Int32

Stan elementu, który będzie reprezentować VisualStyleRenderer .

Wyjątki

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

-lub-

Style wizualizacji są wyłączone przez użytkownika w systemie operacyjnym.

-lub-

Style wizualne nie są stosowane do obszaru klienta okien aplikacji.

ArgumentException

Kombinacja elementów className, parti state nie jest zdefiniowana przez bieżący styl wizualizacji.

ArgumentNullException

.NET 5 lub nowszy: className to null.

Uwagi

Ten konstruktor używa parametrów className, parti state do inicjowania Classwłaściwości , Parti State .

Przed użyciem tego konstruktora należy wywołać metodę staticIsElementDefined , aby sprawdzić, czy bieżący styl wizualizacji zawiera definicję elementu określonego classNameprzez parametry , parti state .