VisualStyleRenderer Constructeurs

Définition

Espace de noms:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Initialise une nouvelle instance de la classe VisualStyleRenderer.

Surcharges

VisualStyleRenderer(VisualStyleElement)	Initialise une nouvelle instance de la classe VisualStyleRenderer avec le VisualStyleElement donné.
VisualStyleRenderer(String, Int32, Int32)	Initialise une nouvelle instance de la classe VisualStyleRenderer à l'aide des valeurs de classe, de partie et d'état données.

VisualStyleRenderer(VisualStyleElement)

Initialise une nouvelle instance de la classe VisualStyleRenderer avec le VisualStyleElement donné.

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)

Paramètres

element

VisualStyleElement

VisualStyleElement que ce VisualStyleRenderer représentera.

Exceptions

InvalidOperationException

Le système d'exploitation ne prend pas en charge les styles visuels.

• ou -

Les styles visuels sont désactivés par l'utilisateur dans le système d'exploitation.

• ou -

Les styles visuels ne sont pas appliqués à la zone client des fenêtres d'application.

ArgumentException

element n'est pas défini par le style visuel en cours.

Exemples

L’exemple de code suivant montre comment utiliser le VisualStyleRenderer(VisualStyleElement) constructeur pour créer un VisualStyleRenderer. Cet exemple de code fait partie d’un exemple de code plus grand fourni pour la vue d’ensemble de la VisualStyleRenderer classe.

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

Remarques

Ce constructeur utilise les propriétés , VisualStyleElement.Partet VisualStyleElement.State les VisualStyleElement.ClassNamepropriétés du element paramètre pour initialiser le Class, Partet State les propriétés.

Avant d’utiliser ce constructeur, vous devez appeler la static IsElementDefined méthode pour vérifier si le style visuel actuel fournit une définition pour l’élément spécifié par le element paramètre.

VisualStyleRenderer(String, Int32, Int32)

Initialise une nouvelle instance de la classe VisualStyleRenderer à l'aide des valeurs de classe, de partie et d'état données.

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)

Paramètres

className

String

Nom de classe de l'élément que ce VisualStyleRenderer représentera.

part

Int32

Partie de l'élément que ce VisualStyleRenderer représentera.

state

Int32

État de l'élément que ce VisualStyleRenderer représentera.

Exceptions

InvalidOperationException

Le système d'exploitation ne prend pas en charge les styles visuels.

• ou -

Les styles visuels sont désactivés par l'utilisateur dans le système d'exploitation.

• ou -

Les styles visuels ne sont pas appliqués à la zone client des fenêtres d'application.

ArgumentException

La combinaison de className, part et state n'est pas définie par le style visuel en cours.

ArgumentNullException

.NET 5 et versions ultérieures : className est null.

Remarques

Ce constructeur utilise les classNameparamètres , partet state les paramètres pour initialiser le Class, Partet State les propriétés.

Avant d’utiliser ce constructeur, vous devez appeler la static IsElementDefined méthode pour vérifier si le style visuel actuel fournit une définition pour l’élément spécifié par les paramètres et state partles classNameparamètres.