FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style Property

Définition

Obtient ou définit le style utilisé par cet élément quand il est rendu.Gets or sets the style used by this element when it is rendered.

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 FrameworkElement construit par défaut est null.The default for a default-constructed FrameworkElement is null.

Exemples

L’exemple suivant définit un style dans un dictionnaire de ressources.The following example defines a style in a resource dictionary.

<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 de thèmes de contrôle ou à partir de styles généralement appliqué aux contrôles de ce type par les ressources au niveau page ou application (un style implicite).For controls, the current style is often provided by a default style from control theming, or from styles generally applied to controls of that type by resources at page or application level (an implicit style). Cette propriété ne pas définie ou retour par défaut les styles (thème), mais il retourne un style implicite ou un style explicite qui agit sur l’élément.This property does not set or return default (theme) styles, but it does return either an implicit style or an explicit style that is acting on the element. Dans le cas de styles implicites ou explicites, peu importe si le style est spécifié en tant que ressource ou défini localement.In the case of implicit or explicit styles, it does not matter whether the style is specified as a resource or defined locally.

Définition des styles comporte certaines restrictions.Setting the styles has some restrictions. Vous pouvez réinitialiser l’ensemble Style propriété vers un nouveau 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é, le 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. Essayez d’apporter une modification à n’importe quelle propriété individuelle d’un style en cours d’utilisation (tels que quoi que ce soit dans la collection de Setters) provoque une exception levée.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 qui est défini dans le balisage est considéré comme en cours d’utilisation dès qu’il est chargé à partir d’un dictionnaire de ressources (pour les ressources), ou la page, dans qu'il est contenu est chargée (pour les styles intraligne).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).

Style est une propriété de dépendance avec une priorité particulière.Style is a dependency property with special precedence. Définie localement style fonctionne généralement à la priorité la plus élevée dans le système de propriétés.The locally set style generally operates at the highest precedence in the property system. Si le Style a la valeur null à ce stade, pendant le 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.If the Style is null at this point, during loading the property system checks for implicit styles in local or application resources that specify that type. Si le style est toujours la valeur null après cette étape, puis le style agissant à des fins de présentation vient 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é.If the style is still null after this step, then the acting style for presentation purposes generally comes from the default (theme) style, but the default style is not returned in the Style property value. Consultez priorité de valeur de propriété de dépendance ou Styling and Templating.See Dependency Property Value Precedence or Styling and Templating.

Utilisation d'attributs XAMLXAML Attribute Usage

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

Utilisation des éléments de propriété XAMLXAML Property Element Usage

Valeurs XAMLXAML Values

resourceExtensionresourceExtension
Une des opérations suivantes :, ou.One of the following: , or . Consultez XAML ressources.See XAML Resources.

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

Notes

Syntaxe d’élément de propriété est techniquement possible, mais non recommandée pour la plupart des scénarios de style.Property element syntax is technically possible, but not recommended for most style scenarios. Consultez modèles et Styles intralignes.See Inline Styles and Templates. Une référence de liaison à l’aide TemplateBinding ou Binding 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
La valeur des propriétés de métadonnées trueMetadata properties set to true AffectsMeasure

S’applique à