FrameworkContentElement.Style Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit le style à utiliser par cet élément.

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 FrameworkContentElement construit par défaut est null.

Exemples

L’exemple suivant établit une Resources collection sur un FlowDocument élément racine, puis la référence en tant que ressource comme style spécifique pour un Paragraph.

<FlowDocument
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class=" SDKSample.Page2">
  <FlowDocument.Resources>
    <Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="FontSize" Value="18"/>
      <Setter Property="Foreground" Value="LightBlue"/>
      <Setter Property="FontFamily" Value="Trebuchet MS"/>
    </Style>
  </FlowDocument.Resources>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>

Remarques

Le style actuel est souvent fourni par un style par défaut à partir de thèmes, ou à partir de styles généralement appliqués aux objets de ce type par des ressources au niveau de la page ou de l’application (style implicite). Cette propriété ne définit pas ou ne retourne pas de styles par défaut (thème), mais elle retourne le style implicite ou un style explicite. Dans le cas de styles implicites ou explicites, il n’importe pas si le style est accessible en tant que ressource ou défini localement.

La définition des styles comporte des 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, recherche des styles implicites comme ressources définies qui spécifient ce type. Si le style est toujours null après cette étape, le style provient du style par défaut (thème), mais le style par défaut n’est pas retourné dans la valeur de la Style propriété. Consultez la priorité des valeurs de propriété de dépendance.

Utilisation d'attributs XAML

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

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 pas recommandée. 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