VisualStyleRenderer Konstruktory

Definice

Obor názvů:

System.Windows.Forms.VisualStyles

Sestavení:

System.Windows.Forms.dll

Inicializuje novou instanci VisualStyleRenderer třídy.

Přetížení

VisualStyleRenderer(VisualStyleElement)	Inicializuje novou instanci třídy VisualStyleRenderer pomocí dané VisualStyleElement.
VisualStyleRenderer(String, Int32, Int32)	Inicializuje novou instanci VisualStyleRenderer třídy pomocí dané třídy, části a stavové hodnoty.

VisualStyleRenderer(VisualStyleElement)

Inicializuje novou instanci třídy VisualStyleRenderer pomocí dané 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, že tento VisualStyleRenderer bude reprezentovat.

Výjimky

InvalidOperationException

Operační systém nepodporuje vizuální styly.

-nebo-

Vizuální styly jsou zakázány uživatelem v operačním systému.

-nebo-

Styly vizuálů se nepoužívají v klientské oblasti oken aplikací.

ArgumentException

element není definován aktuálním stylem vizuálu.

Příklady

Následující příklad kódu ukazuje, jak použít VisualStyleRenderer(VisualStyleElement) konstruktor k vytvoření VisualStyleRenderer. Tento příklad kódu je součástí většího příkladu kódu, který je k dispozici pro přehled třídy 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

Poznámky

Tento konstruktor používá vlastnosti VisualStyleElement.ClassName, VisualStyleElement.Parta VisualStyleElement.State parametru element k inicializaci vlastností Class, Parta State.

Před použitím tohoto konstruktoru byste měli volat metodu staticIsElementDefined, abyste ověřili, zda aktuální vizuální styl poskytuje definici prvku určeného parametrem element.

VisualStyleRenderer(String, Int32, Int32)

Inicializuje novou instanci VisualStyleRenderer třídy pomocí dané třídy, části a stavové hodnoty.

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

Název třídy elementu, který bude tento VisualStyleRenderer představovat.

part

Int32

Část elementu, který bude tento VisualStyleRenderer představovat.

state

Int32

Stav prvku, který bude tento VisualStyleRenderer představovat.

Výjimky

InvalidOperationException

Operační systém nepodporuje vizuální styly.

-nebo-

Vizuální styly jsou zakázány uživatelem v operačním systému.

-nebo-

Styly vizuálů se nepoužívají v klientské oblasti oken aplikací.

ArgumentException

Kombinace className, parta state není definována aktuálním vizuálním stylem.

ArgumentNullException

.NET 5 a novější: className je null.

Poznámky

Tento konstruktor používá parametry className, parta state k inicializaci vlastností Class, Parta State.

Před použitím tohoto konstruktoru byste měli volat metodu staticIsElementDefined k ověření, zda aktuální vizuální styl poskytuje definici prvku určeného className, parta state parametry.