VisualStyleRenderer.SetParameters Méthode

Définition

Espace de noms:

System.Windows.Forms.VisualStyles

Assembly:

System.Windows.Forms.dll

Définit l’élément de style visuel actuel de ce VisualStyleRenderer.

Surcharges

Nom	Description
SetParameters(String, Int32, Int32)	Définit cette valeur VisualStyleRenderer sur l’élément de style visuel représenté par la classe, la partie et les valeurs d’état spécifiées.
SetParameters(VisualStyleElement)	Définit cette valeur VisualStyleRenderer sur l’élément de style visuel représenté par le .VisualStyleElement

SetParameters(String, Int32, Int32)

Source:

VisualStyleRenderer.cs

Définit cette valeur VisualStyleRenderer sur l’élément de style visuel représenté par la classe, la partie et les valeurs d’état spécifiées.

public:
 void SetParameters(System::String ^ className, int part, int state);

public void SetParameters(string className, int part, int state);

member this.SetParameters : string * int * int -> unit

Public Sub SetParameters (className As String, part As Integer, state As Integer)

Paramètres

className

String

Nouvelle valeur de la propriété Class.

part

Int32

Nouvelle valeur de la propriété Part.

state

Int32

Nouvelle valeur de la propriété State.

Exceptions

ArgumentException

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

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.

Remarques

Cette méthode vérifie la valeur de la IsSupported propriété en interne. Avant d’appeler cette méthode, vous devez appeler la IsElementDefined méthode pour vérifier que le style visuel actuel fournit une définition pour l’élément spécifié par les paramètres et partstate les classNameparamètres.

SetParameters(VisualStyleElement)

Source:

VisualStyleRenderer.cs

Définit cette valeur VisualStyleRenderer sur l’élément de style visuel représenté par le .VisualStyleElement

public:
 void SetParameters(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);

public void SetParameters(System.Windows.Forms.VisualStyles.VisualStyleElement element);

member this.SetParameters : System.Windows.Forms.VisualStyles.VisualStyleElement -> unit

Public Sub SetParameters (element As VisualStyleElement)

Paramètres

element

VisualStyleElement

Valeur VisualStyleElement qui spécifie les nouvelles valeurs des propriétés et PartState des Classpropriétés.

Exceptions

ArgumentException

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

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.

Exemples

L’exemple de code suivant montre comment utiliser la SetParameters(VisualStyleElement) méthode pour définir une VisualStyleRenderer nouvelle VisualStyleElementméthode . Cet exemple de code fait partie d’un exemple plus large 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

Cette méthode vérifie la valeur de la IsSupported propriété en interne. Avant d’appeler cette méthode, vous devez appeler la IsElementDefined méthode pour vérifier que le style visuel actuel fournit une définition pour l’élément spécifié par le element paramètre.