Style Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Active le partage de propriétés, de ressources et de 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 affectera 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>

Note

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 impact large. Par exemple, 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 s’il 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 élément sur n’importe quel élément qui dérive ou FrameworkElementFrameworkContentElement. Un style est le plus souvent 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 vous déclarez un style affecte l’emplacement où il peut être appliqué. Si, par exemple, 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 peut être utilisé uniquement 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. Chacun Setter se compose d’un et d’un PropertyValue. La propriété est le nom de la propriété de l’élément auquel le style doit s’appliquer. Une fois que le style est déclaré en tant que ressource, il peut ensuite être référencé comme n’importe quelle autre ressource.

Note

S’il existe plusieurs setters dans la collection setter avec la même Property valeur de propriété, le setter déclaré 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 prioritaire.

Le style et le modèle de création de modèles Windows Presentation Foundation (WPF) permettent 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 inclut 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 Style et Création de modèles.

Constructeurs

Nom	Description
Style()	Initialise une nouvelle instance de la classe Style.
Style(Type, Style)	Initialise une nouvelle instance de la Style classe à utiliser sur l’élément spécifié Type et basé sur le fichier spécifié Style.
Style(Type)	Initialise une nouvelle instance de la Style classe à utiliser sur le fichier spécifié Type.

Propriétés

Nom	Description
BasedOn	Obtient ou définit un style défini qui est la base du style actuel.
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (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 de ressources qui peuvent être utilisées dans l’étendue de ce style.
Setters	Obtient une collection d’objets et EventSetter une collection d’objetsSetter.
TargetType	Obtient ou définit le type pour lequel ce style est destiné.
Triggers	Obtient une collection d’objets qui appliquent des valeurs de TriggerBase propriété en fonction des conditions spécifiées.

Méthodes

Nom	Description
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
GetHashCode()	Retourne le code de hachage pour ce Style.
RegisterName(String, Object)	Inscrit une nouvelle paire nom-objet dans le namescope actuel.
Seal()	Verrouille ce style et tous les fabriques et déclencheurs afin qu’ils ne puissent pas être modifiés.
UnregisterName(String)	Supprime un mappage nom-objet de la portée de nom.
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)

Implémentations d’interfaces explicites

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

Voir aussi

• attribut x :Key
• x :Type Markup Extension