Share via

VisualStyleRenderer.SetParameters Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms.VisualStyles
Assembly:
System.Windows.Forms.dll

Définit l'élément de style visuel en cours de ce VisualStyleRenderer.

Surcharges

SetParameters(String, Int32, Int32)

Définit ce VisualStyleRenderer avec l'élément de style visuel représenté par les valeurs de classe, de partie et d'état spécifiées.
SetParameters(VisualStyleElement)

Définit ce VisualStyleRenderer avec l'élément de style visuel représenté par le VisualStyleElement spécifié.

SetParameters(String, Int32, Int32)

Définit ce VisualStyleRenderer avec l'élément de style visuel représenté par les valeurs de classe, de partie et 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

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

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.

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 classNameparamètres , partet state .

S’applique à

SetParameters(VisualStyleElement)

Définit ce VisualStyleRenderer avec l'élément de style visuel représenté par le VisualStyleElement spécifié.

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

VisualStyleElement qui spécifie les nouvelles valeurs des propriétés Class, Part et State.

Exceptions

ArgumentException

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

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.

Exemples

L’exemple de code suivant montre comment utiliser la SetParameters(VisualStyleElement) méthode pour définir un VisualStyleRenderer sur un nouveau VisualStyleElement. 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 .

S’applique à