Style Style Style Style Class

Définition

Active le partage des propriétés, des ressources et des gestionnaires d'événements entre les instances d'un type.Enables the sharing of properties, resources, and event handlers between instances of a 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
type Style = class
    inherit DispatcherObject
    interface INameScope
    interface IAddChild
    interface IQueryAmbient
Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope, IQueryAmbient
Héritage
Attributs
Implémente

Exemples

L’exemple suivant montre une déclaration de style qui affecte la Background propriété d’un Control.The following example shows a style declaration that will affect the Background property of a Control.

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

Pour appliquer le style ci-dessus, procédez comme suit:To apply the above style, do the following:

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

Vous pouvez également appliquer des styles à tous les éléments d’un type donné à TargetType l’aide de la propriété.You can also apply styles to all elements of a given type by using the TargetType property. 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.Adding the target type to the style means that you no longer have to fully qualify the property you are setting with the ClassName.PropertyName syntax. L’exemple suivant définit un style qui sera appliqué à chaque TextBlock élément.The following example defines a style that will be applied to every TextBlock element.

<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 WPFWPF nombreux contrôles se composent d' WPFWPF une combinaison d’autres contrôles, donc la création d’un style qui s’applique à tous les contrôles d’un type peut avoir un impact important.Many WPFWPF controls consist of a combination of other WPFWPF controls, so creating a style that applies to all controls of a type can have broad impact. Par exemple, si vous créez un style qui cible les TextBlock contrôles dans un Canvas, le style est appliqué à tous TextBlock les contrôles dans la zone de dessin, TextBlock même si le fait partie d’un autre contrôle ListBox, tel qu’un.For instance, if you create a style that targets the TextBlock controls in a Canvas, the style is applied to all TextBlock controls in the canvas, even if the TextBlock is part of another control, such as a ListBox.

Pour plus d’informations sur l’extension ou l’héritage d’un style défini, BasedOn consultez la page.For information on how to extend or inherit from a defined style, see the BasedOn page.

Remarques

Vous pouvez définir un Style sur tout élément qui dérive de FrameworkElement ou FrameworkContentElement.You can set a Style on any element that derives from FrameworkElement or FrameworkContentElement. Un style est généralement déclaré comme une ressource à l’intérieur Resources de la section.A style is most commonly declared as a resource inside the 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é.Because styles are resources, they obey the same scoping rules that apply to all resources, so where you declare a style affects where it can be applied. Si, par exemple, vous déclarez le style dans l’élément racine de votre fichier XAMLXAML de définition d’application, le style peut être utilisé n’importe où dans votre application.If, for instance, you declare the style in the root element of your application definition XAMLXAML file, the style can be used anywhere in your application. Si vous créez une application de navigation et que vous déclarez le style dans l’un XAMLXAML des fichiers de l’application, le style ne peut XAMLXAML être utilisé que dans ce fichier.If you are creating a navigation application and declare the style in one of the application's XAMLXAML files, the style can be used only in that XAMLXAML file. Pour plus d’informations sur les règles de portée pour les ressources, consultez ressources XAML.For more information on scoping rules for resources, see XAML Resources.

La déclaration de style se compose Style d’un objet qui contient une collection d’un Setter ou plusieurs objets.The style declaration consists of a Style object that contains a collection of one or more Setter objects. Chaque Setter est constitué d' Property un et Valued’un.Each Setter consists of a Property and a Value. La propriété est le nom de la propriété de l’élément auquel le style doit s’appliquer.The property is the name of the property of the element the style is to apply to. Une fois que le style est déclaré en tant que ressource, il peut être référencé comme n’importe quelle autre ressource.After the style is declared as a resource, it can then be referenced just like any other resource.

Notes

S’il existe plus d’un accesseur set dans la collection Setter avec Property la même valeur de propriété, l’accesseur Set qui est déclaré en dernier est utilisé.If there is more than one setter in the setter collection with the same Property property value, the setter that is declared last is used. 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.Similarly, if you set a value for the same property in a style and on an element directly, the value set on the element directly takes precedence.

Le Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) modèle de conception et de création de modèles permet la maintenance et le partage d’une apparence, ainsi que la séparation de la présentation et de la logique.The Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) styling and templating model allows maintenance and sharing of a look as well as the separation of presentation and logic. Le modèle de conception et de création de modèles comprend une suite de fonctionnalités qui vous permettent Interface utilisateurUIde personnaliser votre.The styling and templating model includes a suite of features that enable you to customize your Interface utilisateurUI. Cette suite de fonctionnalités comprend la Style classe, ainsi que les éléments suivants:This suite of features includes the Style class as well as the following:

Pour plus d’informations, consultez Application d’un style et création de modèles.For more information, see Styling and Templating.

Constructeurs

Style() Style() Style() Style()

Initialise une nouvelle instance de la classe Style.Initializes a new instance of the Style class.

Style(Type) Style(Type) Style(Type) Style(Type)

Initialise une nouvelle instance de la classe Style à utiliser sur le Type spécifié.Initializes a new instance of the Style class to use on the specified Type.

Style(Type, Style) Style(Type, Style) Style(Type, Style) Style(Type, Style)

Initialise une nouvelle instance de la classe Style à utiliser sur le Type spécifié et selon le Style spécifié.Initializes a new instance of the Style class to use on the specified Type and based on the specified Style.

Propriétés

BasedOn BasedOn BasedOn BasedOn

Obtient ou définit un style défini qui est la base du style actuel.Gets or sets a defined style that is the basis of the current style.

Dispatcher Dispatcher Dispatcher Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
IsSealed IsSealed IsSealed IsSealed

Obtient une valeur qui indique si le style est en lecture seule et ne peut pas être modifié.Gets a value that indicates whether the style is read-only and cannot be changed.

Resources Resources Resources Resources

Obtient ou définit la collection des ressources qui peuvent être utilisées dans la portée de ce style.Gets or sets the collection of resources that can be used within the scope of this style.

Setters Setters Setters Setters

Obtient une collection d'objets Setter et EventSetter.Gets a collection of Setter and EventSetter objects.

TargetType TargetType TargetType TargetType

Obtient ou définit le type auquel ce style est destiné.Gets or sets the type for which this style is intended.

Triggers Triggers Triggers Triggers

Obtient une collection d'objets TriggerBase qui appliquent des valeurs de propriété selon des conditions spécifiées.Gets a collection of TriggerBase objects that apply property values based on specified conditions.

Méthodes

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage pour ce Style.Returns the hash code for this Style.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object)

Inscrit une nouvelle paire nom-objet dans la portée de nom actuelle.Registers a new name-object pair in the current namescope.

Seal() Seal() Seal() Seal()

Verrouille ce style, ainsi que l'ensemble des fabriques et déclencheurs pour en empêcher la modification.Locks this style and all factories and triggers so they cannot be changed.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
UnregisterName(String) UnregisterName(String) UnregisterName(String) UnregisterName(String)

Supprime un mappage nom-objet de la portée de nom.Removes a name-object mapping from the namescope.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Ajoute un objet enfant.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Ajoute le contenu textuel d’un nœud à l’objet.Adds the text content of a node to the object.

INameScope.FindName(String) INameScope.FindName(String) INameScope.FindName(String) INameScope.FindName(String)

Retourne un objet qui porte le nom d'identification fourni.Returns an object that has the provided identifying name.

IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String)

Demande si une propriété ambiante spécifiée est disponible dans la portée actuelle.Queries whether a specified ambient property is available in the current scope.

ISealable.CanSeal ISealable.CanSeal ISealable.CanSeal ISealable.CanSeal
ISealable.IsSealed ISealable.IsSealed ISealable.IsSealed ISealable.IsSealed
ISealable.Seal() ISealable.Seal() ISealable.Seal() ISealable.Seal()

S’applique à

Voir aussi