Style Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Active le partage des propriétés, des ressources et des gestionnaires d'événements entre les instances d'un type.

public ref class Style : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IAddChild, System::Windows::Markup::INameScope, System::Windows::Markup::IQueryAmbient

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.DictionaryKeyProperty("TargetType")]
public class Style : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IAddChild, System.Windows.Markup.INameScope, System.Windows.Markup.IQueryAmbient

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.DictionaryKeyProperty("TargetType")>]
type Style = class
    inherit DispatcherObject
    interface IAddChild
    interface INameScope
    interface IQueryAmbient

Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope, IQueryAmbient

Héritage

Object

DispatcherObject

Style

Attributs

LocalizabilityAttribute ContentPropertyAttribute DictionaryKeyPropertyAttribute

Implémente

IAddChild INameScope IQueryAmbient

Exemples

L’exemple suivant montre une déclaration de style qui affecte la Background propriété d’un Control.

<Style x:Key="Style1">
  <Setter Property="Control.Background" Value="Yellow"/>
</Style>

Pour appliquer le style ci-dessus, procédez comme suit :

<Label Content="Yellow Background" Style="{StaticResource Style1}" />

Vous pouvez également appliquer des styles à tous les éléments d’un type donné à l’aide de la TargetType propriété . L’ajout du type cible au style signifie que vous n’avez plus besoin de qualifier entièrement la propriété que vous définissez avec la ClassName.PropertyName syntaxe. L’exemple suivant définit un style qui sera appliqué à chaque TextBlock élément.

<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>

Notes

De nombreux contrôles WPF se composent d’une combinaison d’autres contrôles WPF, de sorte que la création d’un style qui s’applique à tous les contrôles d’un type peut avoir un large impact. Par instance, si vous créez un style qui cible les TextBlock contrôles dans un Canvas, le style est appliqué à tous les TextBlock contrôles du canevas, même si le TextBlock fait partie d’un autre contrôle, tel qu’un ListBox.

Pour plus d’informations sur l’extension ou l’héritage d’un style défini, consultez la BasedOn page .

Remarques

Vous pouvez définir un Style sur n’importe quel élément qui dérive de FrameworkElement ou FrameworkContentElement. Un style est généralement déclaré en tant que ressource à l’intérieur de la Resources section. Étant donné que les styles sont des ressources, ils obéissent aux mêmes règles d’étendue que celles qui s’appliquent à toutes les ressources, de sorte que l’endroit où vous déclarez un style affecte l’endroit où il peut être appliqué. Si, par instance, vous déclarez le style dans l’élément racine de votre fichier XAML de définition d’application, le style peut être utilisé n’importe où dans votre application. Si vous créez une application de navigation et déclarez le style dans l’un des fichiers XAML de l’application, le style ne peut être utilisé que dans ce fichier XAML. Pour plus d’informations sur les règles d’étendue pour les ressources, consultez Ressources XAML.

La déclaration de style se compose d’un Style objet qui contient une collection d’un ou plusieurs Setter objets. Chacune Setter se compose d’un Property et d’un Value. La propriété est le nom de la propriété de l’élément auquel le style doit s’appliquer. Une fois le style déclaré en tant que ressource, il peut être référencé comme n’importe quelle autre ressource.

Notes

S’il existe plusieurs setter dans la collection setter avec la même Property valeur de propriété, le setter déclaré en dernier est utilisé. De même, si vous définissez une valeur pour la même propriété dans un style et sur un élément directement, la valeur définie sur l’élément est directement prioritaire.

Le modèle de style et de création de modèles Windows Presentation Foundation (WPF) permet la maintenance et le partage d’une apparence, ainsi que la séparation de la présentation et de la logique. Le modèle de style et de création de modèles comprend une suite de fonctionnalités qui vous permettent de personnaliser votre interface utilisateur. Cette suite de fonctionnalités inclut la Style classe ainsi que les éléments suivants :

• Trigger

• EventTrigger et Storyboard

• ControlTemplate

• DataTemplate

Pour plus d’informations, consultez Application d’un style et création de modèles.

Constructeurs

Style()	Initialise une nouvelle instance de la classe Style.
Style(Type)	Initialise une nouvelle instance de la classe Style à utiliser sur le Type spécifié.
Style(Type, Style)	Initialise une nouvelle instance de la classe Style à utiliser sur le Type spécifié et selon le Style spécifié.

Propriétés

BasedOn	Obtient ou définit un style défini qui est la base du style actuel.
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
IsSealed	Obtient une valeur qui indique si le style est en lecture seule et ne peut pas être modifié.
Resources	Obtient ou définit la collection des ressources qui peuvent être utilisées dans la portée de ce style.
Setters	Obtient une collection d'objets Setter et EventSetter.
TargetType	Obtient ou définit le type auquel ce style est destiné.
Triggers	Obtient une collection d'objets TriggerBase qui appliquent des valeurs de propriété selon des conditions spécifiées.

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Retourne le code de hachage pour ce Style.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RegisterName(String, Object)	Inscrit une nouvelle paire nom-objet dans la portée de nom actuelle.
Seal()	Verrouille ce style, ainsi que l'ensemble des fabriques et déclencheurs pour en empêcher la modification.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UnregisterName(String)	Supprime un mappage nom-objet de la portée de nom.
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)	Ajoute un objet enfant.
IAddChild.AddText(String)	Ajoute le contenu textuel d’un nœud à l’objet.
INameScope.FindName(String)	Retourne un objet qui a le nom d’identification fourni.
IQueryAmbient.IsAmbientPropertyAvailable(String)	Demande si une propriété ambiante spécifiée est disponible dans la portée actuelle.

Voir aussi

• x :Key Attribute
• x:Type, extension de balisage