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 à l’aide de la VisualStyleElementdonnée.
VisualStyleRenderer(String, Int32, Int32)	Initialise une nouvelle instance de la classe VisualStyleRenderer à l’aide de la classe, de la partie et des valeurs d’état données.

VisualStyleRenderer(VisualStyleElement)

Initialise une nouvelle instance de la classe VisualStyleRenderer à l’aide de la VisualStyleElementdonnée.

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

Un VisualStyleElement que cette 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 cliente des fenêtres d’application.

ArgumentException

element n’est pas défini par le style visuel actuel.

Exemples

L’exemple de code suivant montre comment utiliser le constructeur VisualStyleRenderer(VisualStyleElement) pour créer un VisualStyleRenderer. Cet exemple de code fait partie d’un exemple de code plus large fourni pour la vue d’ensemble de la classe 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

Remarques

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

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

VisualStyleRenderer(String, Int32, Int32)

Initialise une nouvelle instance de la classe VisualStyleRenderer à l’aide de la classe, de la partie et des valeurs 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 représenté par ce VisualStyleRenderer.

part

Int32

Partie de l’élément représenté par cet VisualStyleRenderer.

state

Int32

État de l’élément représenté par ce VisualStyleRenderer.

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 cliente des fenêtres d’application.

ArgumentException

La combinaison de className, partet state n’est pas définie par le style visuel actuel.

ArgumentNullException

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

Remarques

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

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