Setter.Value Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit la valeur à appliquer à la propriété spécifiée par l’élément 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 l’élément Setter.

Remarques

Comme vous pouvez le voir dans la syntaxe XAML, il existe plusieurs façons de spécifier le Value pour un setter en 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 d’é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} entre 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 du 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. L’utilisation d’une 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 est créé en XAML ou modifié dans le Setter code).

Si vous accédez à un instance Setter à 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 true. Cela est également signalé par la propriété IsSealed sur un individu Setter. Le système définit ces propriétés true sur 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 sealed Setter 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 il s’agit de la Setter propriété Template d’une classe dérivée de Control qui constitue la majorité du balisage XAML dans un objet classique Style. Le Value pour un Setter avec Property="Template" est presque toujours spécifié 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 jeu de modèles définit la définition d’interface utilisateur de modèle de base pour un contrôle instance 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 dans les scénarios de Style création de modèles de contrôle, consultez Modèles de contrôle XAML.