Style Classe

Définition

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
public ref class Style : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IAddChild, System::Windows::Markup::INameScope
[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")]
public class Style : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IAddChild, System.Windows.Markup.INameScope
[<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
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.DictionaryKeyProperty("TargetType")>]
type Style = class
    inherit DispatcherObject
    interface INameScope
    interface IAddChild
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.DictionaryKeyProperty("TargetType")>]
type Style = class
    inherit DispatcherObject
    interface INameScope
    interface IAddChild
    interface IQueryAmbient
Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope, IQueryAmbient
Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope
Héritage
Attributs
Implémente

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 à qualifier complètement 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, donc la création d’un style qui s’applique à tous les contrôles d’un type peut avoir un impact important. 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 dans la zone de dessin, 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 tout élément qui dérive de FrameworkElement ou FrameworkContentElement . Un style est généralement déclaré comme une ressource à l’intérieur de la Resources section. Étant donné que les styles sont des ressources, ils obéissent aux mêmes règles de portée qui s’appliquent à toutes les ressources, de sorte que vous déclarez un style qui affecte l’endroit 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 de portée 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. Chaque Setter est constitué 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 que le style est déclaré en tant que ressource, il peut être référencé comme n’importe quelle autre ressource.

Notes

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

Le modèle de conception et de création de modèles de 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 conception 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 comprend la Style classe, ainsi que les éléments suivants :

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.

S’applique à

Voir aussi