Setter.Value Propriété

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é

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

Remarques

Comme vous pouvez le voir à partir de la syntaxe XAML, il existe différentes façons de spécifier l’élément ValueSetter 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 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 qu’objet complet déclaré dans la syntaxe d’élément d’objet XAML, et l’élément objet est imbriqué dans une 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 la vue d’ensemble du code XAML ou le guide de syntaxe XAML. Vous pouvez utiliser la syntaxe d’attribut pour la plupart des propriétés d’interface utilisateur XAML et des propriétés d’interface utilisateur qui nécessitent spécifiquement une 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 à la fois la propriété et Value les propriétés d’un setter. Sinon, une exception est levée (une exception d’analyse ou une erreur d’exécution, selon que l’exception est créée en XAML ou modifiée dans le Setter code).

Si vous accédez à une instance Setter à l’aide de code, vous ne pouvez pas modifier la valeur d’une propriété d’une 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 lorsque le runtime applique des styles aux éléments de l’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 Setter de la propriété Template d’une classe dérivée de Contrôle qui constitue la majorité du balisage XAML dans une classe classique Style. La Value 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 d’objet ControlTemplate .

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

Le jeu de modèles définit la définition de l’interface utilisateur de modèle de base pour une 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 style de modèle par défaut et le ControlTemplate au sein peuvent avoir des centaines de lignes de XAML. Pour plus d’informations sur le rôle des scénarios de création de modèles de Style contrôle, consultez les modèles de contrôle XAML.