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 illustre une déclaration de style qui affecte le 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é à l’aide de la TargetType propriété.You can also apply styles to all elements of a given type by using the TargetType property. Ajouter le type cible au style signifie que vous n’avez plus à qualifier complètement la propriété que vous définissez avec le 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 s’appliqueront à 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

Nombreux WPFWPF contrôles se composent d’une combinaison des autres WPFWPF contrôles, afin de la création d’un style qui s’applique à tous les contrôles d’un type peuvent 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 le TextBlock des 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.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 la façon d’étendre ou hériter d’un style défini, consultez le BasedOn 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 n’importe quel é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 souvent déclaré en tant que ressource à l’intérieur de la Resources 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, c’est le cas où vous déclarez un style affecte 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 définition d’application XAMLXAML fichier, 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 déclarez le style dans un de l’application XAMLXAML fichiers, le style peuvent être utilisés que dans ce XAMLXAML 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 des ressources, consultez XAML ressources.For more information on scoping rules for resources, see XAML Resources.

La déclaration de style se compose d’un Style objet qui contient une collection d’un ou plusieurs Setter objets.The style declaration consists of a Style object that contains a collection of one or more Setter objects. Chaque Setter se compose d’un Property et un Value.Each Setter consists of a Property and a Value. La propriété est le nom de la propriété de l’élément de style à 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 ensuite être référencé comme toute autre ressource.After the style is declared as a resource, it can then be referenced just like any other resource.

Notes

Si plusieurs accesseurs Set se trouve dans la collection de setter avec le même Property dernière valeur de propriété, l’accesseur Set qui est déclaré est utilisée.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 une valeur pour la même propriété dans un style et sur un élément directement, la valeur définie directement 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) styles et modèles autorise le partage d’un coup de œil, ainsi que la séparation de la présentation et logique et de maintenance.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 style et création de modèles inclut une suite de fonctionnalités qui vous permettent de personnaliser votre Interface utilisateurUI.The styling and templating model includes a suite of features that enable you to customize your Interface utilisateurUI. Cet ensemble de fonctionnalités comprend la Style classe ainsi que les suivantes :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 cela DispatcherObject est associé.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 du 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()

Impose que le thread appelant a accès à ce 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