Setter.Value Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient ou définit la valeur à appliquer à la propriété spécifiée par le Setter.

public:
 property Platform::Object ^ Value { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable Value();

void Value(IInspectable value);

public object Value { get; set; }

var object = setter.value;
setter.value = object;

Public Property Value As Object

<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

Valeur de propriété

Object

Platform::Object

IInspectable

Valeur à appliquer à la propriété spécifiée par le Setter.

Remarques

Comme vous pouvez le voir dans la syntaxe XAML, il existe plusieurs façons de spécifier la valeur d’un setter dans XAML :

• En tant qu’attribut, à l’aide d’une valeur de chaîne. Une telle valeur de chaîne peut être convertie implicitement en un type spécifique à une propriété pour des cas simples tels que la définition de valeurs numériques, de valeurs nommées à partir d’une énumération ou d’un URI (Uniform Resource Identifier).
• En tant que nouvel objet complet déclaré dans la syntaxe de l’élément d’objet XAML, et l’élément object est imbriqué dans l’utilisation d’un élément de propriété.
• En tant qu’attribut qui a une utilisation de l’extension de balisage {StaticResource} dans les guillemets. En règle générale, le type de valeur de la propriété détermine la syntaxe appropriée. Pour plus d’informations sur les utilisations XAML, consultez Vue d’ensemble XAML ou Guide de syntaxe XAML. Vous pouvez utiliser la syntaxe d’attribut pour la plupart des propriétés d’interface utilisateur XAML, et les propriétés d’interface utilisateur qui nécessitent spécifiquement l’utilisation d’un élément de propriété ou une référence de ressource sont moins courantes. Une utilisation de l’extension de balisage {StaticResource} peut être appropriée même pour les chaînes ou les valeurs numériques si ces valeurs sont partagées par plusieurs styles ou propriétés.

Vous devez spécifier les propriétés Property et Value sur un Setter. Sinon, une exception est levée (une exception d’analyse ou une erreur d’exécution, selon que le Setter est créé en XAML ou modifié dans le code).

Si vous accédez à un setter instance à l’aide de code, vous ne pouvez pas modifier la valeur d’une propriété d’un setter instance si la valeur de la propriété IsSealed sur un style parent est vraie. Cela est également signalé par la propriété IsSealed sur un Setter individuel. Le système définit ces propriétés sur true lorsque le runtime applique des styles aux éléments d’interface utilisateur et les affiche dans l’interface utilisateur. La tentative de modification d’un setter scellé génère une erreur d’exécution.

Styles et modèles

Vous pouvez utiliser un setter dans un style pour appliquer des valeurs à n’importe quelle propriété de dépendance. Mais c’est le Setter de la propriété Template d’une classe dérivée du contrôle qui constitue la majorité du balisage XAML dans un style classique. La valeur d’un setter avec Property="Template" est presque toujours spécifiée en tant qu’élément de propriété qui contient un élément objet ControlTemplate .

Lorsqu’un Style est utilisé pour définir un modèle de contrôle, le TargetType de l’élément Style et le TargetType de l’élément ControlTemplate pour son setter Control.Template doivent toujours utiliser la même valeur.

Le setter de modèles définit la définition d’interface utilisateur de modèle de base pour un instance de contrôle où ce modèle est appliqué. Il contient également les états visuels d’un contrôle et d’autres définitions d’interface utilisateur basées sur l’état, telles que les transitions de thème par défaut. Pour un contrôle complexe tel que ListBox, le modèle par défaut Style et le ControlTemplate dans peuvent avoir des centaines de lignes de XAML. Pour plus d’informations sur le rôle de Style dans les scénarios de création de modèles de contrôle, consultez Démarrage rapide : Modèles de contrôle.