FrameworkElement.Style Propriété

Définition

Obtient ou définit le style utilisé par cet élément quand il est rendu.

public:
 property System::Windows::Style ^ Style { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style Style { get; set; }
member this.Style : System.Windows.Style with get, set
Public Property Style As Style

Valeur de propriété

Style

Style appliqué, non défini par défaut de l’élément, le cas échéant. Sinon, null. La valeur par défaut d’un FrameworkElement construit par défaut est null.

Exemples

L’exemple suivant définit un style dans un dictionnaire de ressources.

<Page.Resources>
<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>
<Border Style="{StaticResource PageBackground}">
</Border>

Remarques

Pour les contrôles, le style actuel est souvent fourni par un style par défaut à partir du thème du contrôle ou des styles généralement appliqués aux contrôles de ce type par les ressources au niveau de la page ou de l’application (style implicite). Cette propriété ne définit pas ou retourne les styles par défaut (thème), mais elle retourne un style implicite ou un style explicite qui agit sur l’élément. Dans le cas de styles implicites ou explicites, il n’est pas important que le style soit spécifié en tant que ressource ou défini localement.

La définition des styles comporte certaines restrictions. Vous pouvez réinitialiser la propriété entière Style à un nouveau Style à tout moment, ce qui force une recomposition de disposition. Toutefois, dès que ce style est placé en cours d’utilisation par un élément chargé, il Style doit être considéré comme scellé. Toute tentative de modification apportée à une propriété individuelle d’un style in-use (par exemple, tout ce qui se trouve dans la collection) Settersentraîne la levée d’une exception. Un style défini dans le balisage est considéré comme étant en cours d’utilisation dès qu’il est chargé à partir d’un dictionnaire de ressources (pour les ressources) ou que la page qu’il contient est chargée (pour les styles inline).

Style est une propriété de dépendance avec une priorité spéciale. Le style défini localement fonctionne généralement à la priorité la plus élevée dans le système de propriétés. Si la Style valeur est Null à ce stade, lors du chargement du système de propriétés, vérifie les styles implicites dans les ressources locales ou d’application qui spécifient ce type. Si le style est toujours null après cette étape, le style agissant à des fins de présentation provient généralement du style par défaut (thème), mais le style par défaut n’est pas retourné dans la Style valeur de propriété. Consultez la priorité de la valeur de propriété de dépendance ou le style et la création de modèles.

Utilisation d'attributs XAML

<object Style="{resourceExtension styleResourceKey}"/>  

Utilisation des éléments de propriété XAML

Valeurs XAML

resourceExtension
L’un des éléments suivants : , ou . Consultez les ressources XAML.

styleResourceKey
Clé qui identifie le style demandé. La clé fait référence à une ressource existante dans un ResourceDictionary.

Notes

La syntaxe de l’élément property est techniquement possible, mais elle n’est pas recommandée pour la plupart des scénarios de style. Voir Styles et modèles inline. Référence de liaison utilisant TemplateBinding ou Binding est également possible, mais rare.

Informations sur les propriétés de dépendance

Champ d’identificateur StyleProperty
Propriétés de métadonnées définies sur true AffectsMeasure

S’applique à