FrameworkContentElement.Style FrameworkContentElement.Style FrameworkContentElement.Style FrameworkContentElement.Style Property

Définition

Obtient ou définit le style à utiliser par cet élément.Gets or sets the style to be used by this element.

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 appliqué, non défini par défaut de l’élément, le cas échéant.The applied, nondefault style for the element, if present. Sinon, null.Otherwise, null. La valeur par défaut d’un FrameworkContentElement construit par défaut est null.The default for a default-constructed FrameworkContentElement is null.

Exemples

L’exemple suivant établit une Resources collection sur un FlowDocument élément racine, puis le référence comme une ressource en tant que style spécifique pour Paragraphun.The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a 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 (style implicite).The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). Cette propriété ne définit pas ou ne retourne pas de styles par défaut (thème), mais retourne le style implicite ou un style explicite.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. Dans le cas de styles implicites ou explicites, peu importe si le style est accessible en tant que ressource ou défini localement.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

La définition des styles présente des restrictions.Setting the styles has some restrictions. Vous pouvez réinitialiser la propriété Style entière à Style tout moment, ce qui force une recomposition de disposition.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Toutefois, dès que ce style est placé en cours d’utilisation par un élément chargé, Style doit être considéré comme sealed.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Toute tentative d’apporter une modification à une propriété individuelle d’un style en cours d’utilisation (tel que tout ce qui Settersse trouve dans la collection de) entraîne la levée d’une exception.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. 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 la page dans laquelle il est contenu est chargée (pour les styles intralignes).A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Styleest une propriété de dépendance avec une priorité spéciale.Style is a dependency property with special precedence. Le style défini localement fonctionne généralement au niveau de priorité le plus élevé dans le système de propriétés.The locally set style generally operates at the highest precedence in the property system. Style Si est null à ce stade, pendant le chargement, le système de propriétés vérifie les styles implicites comme des ressources définies qui spécifient ce type.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that 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 Style la valeur de la propriété.If the style is still null after this step, then the style comes from the default (theme) style, but the default style is not returned in the Style property value. Consultez prioritéde la valeur de propriété de dépendance.See Dependency Property Value Precedence.

Utilisation d'attributs XAMLXAML Attribute Usage

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

Valeurs XAMLXAML Values

resourceExtensionresourceExtension
L’une des valeurs suivantes:, ou.One of the following: , or . Consultez ressources XAML.See XAML Resources.

styleResourceKeystyleResourceKey
Clé qui identifie le style demandé.The key that identifies the style being requested. La clé fait référence à une ressource existante dans ResourceDictionaryun.The key refers to an existing resource in a ResourceDictionary.

Notes

La syntaxe des éléments de propriété est techniquement possible, mais non recommandée.Property element syntax is technically possible, but not recommended. Consultez styles et modèles intralignes.See Inline Styles and Templates. Une référence de liaison à l' Binding aide de TemplateBinding ou est également possible, mais rare.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field StyleProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true AffectsMeasure

S’applique à