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 pour l’élément, s’il est présent. Sinon, null. La valeur par défaut d’une construction FrameworkContentElement 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 les ressources au niveau de la page ou de l’application (un 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 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é. Si vous tentez d’apporter une modification à une propriété individuelle d’un style in-use (par exemple, tout ce qui se trouve dans la collection), Settersune exception est levée. Un style défini dans le balisage est considéré comme étant utilisé 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é particulière. 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 en tant que 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 propriété Style . Voir Priorité de la valeur de propriété de dépendance.

Utilisation des 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.

Note

La syntaxe de l’élément property est techniquement possible, mais n’est pas recommandée. Consultez les styles et les modèles inline. Référence de liaison à l’aide de TemplateBinding ou Binding est également possible, mais rare.

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

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