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 nowe wystąpienie klasy VisualStyleRenderer przy użyciu danego VisualStyleElement.
VisualStyleRenderer(String, Int32, Int32)	Inicjuje nowe wystąpienie klasy VisualStyleRenderer przy użyciu danej klasy, części i wartości stanu.

VisualStyleRenderer(VisualStyleElement)

Inicjuje nowe wystąpienie klasy VisualStyleRenderer przy użyciu danego 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)

Parametry

element

VisualStyleElement

VisualStyleElement, które będzie reprezentować ten VisualStyleRenderer.

Wyjątki

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

-lub-

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

-lub-

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

ArgumentException

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

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć VisualStyleRendererza pomocą konstruktora VisualStyleRenderer(VisualStyleElement) . Ten przykładowy kod jest częścią większego przykładu kodu udostępnionego dla przeglądu klasy 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

Uwagi

Ten konstruktor używa właściwości VisualStyleElement.ClassName, VisualStyleElement.Parti VisualStyleElement.State parametru element, aby zainicjować właściwości Class, 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 przez element parametru.

VisualStyleRenderer(String, Int32, Int32)

Inicjuje nowe wystąpienie klasy VisualStyleRenderer 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ć ten VisualStyleRenderer.

part

Int32

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

state

Int32

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

Wyjątki

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

-lub-

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

-lub-

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

ArgumentException

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

ArgumentNullException

.NET 5 lub nowszy: className jest null.

Uwagi

Ten konstruktor używa parametrów className, parti state, aby zainicjować właściwości Class, 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 przez className, parti state parametrów.