Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Style, classe

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

Espace de noms :  System.Windows
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[ContentPropertyAttribute("Setters")]
[DictionaryKeyPropertyAttribute("TargetType")]
[LocalizabilityAttribute(LocalizationCategory.Ignore)]
public class Style : DispatcherObject, INameScope, 
	IAddChild, IQueryAmbient

Le type Style expose les membres suivants.

  NomDescription
Méthode publiqueStyle()Initialise une nouvelle instance de la classe Style.
Méthode publiqueStyle(Type)Initialise une nouvelle instance de la classe Style à utiliser sur le Type spécifié.
Méthode publiqueStyle(Type, Style)Initialise une nouvelle instance de la classe Style à utiliser sur le Type spécifié et selon le Style spécifié.
Début

  NomDescription
Propriété publiqueBasedOnObtient ou définit un style défini qui est la base du style actuel.
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueDispatcher (Hérité de DependencyObject.)
Propriété publiqueIsSealedObtient une valeur qui indique si le style est en lecture seule et ne peut pas être modifié.
Propriété publiqueResourcesObtient ou définit la collection des ressources qui peuvent être utilisées dans la portée de ce style.
Propriété publiqueSettersObtient une collection d'objets Setter et EventSetter.
Propriété publiqueTargetTypeObtient ou définit le type auquel ce style est destiné.
Propriété publiqueTriggersObtient une collection d'objets TriggerBase qui appliquent des valeurs de propriété selon des conditions spécifiées.
Début

  NomDescription
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(DependencyProperty)Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetAnimationBaseValue (Hérité de DependencyObject.)
Méthode publiqueGetHashCodeRetourne le code de hachage pour ce Style. (Substitue Object.GetHashCode().)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode publiqueRegisterNameInscrit une nouvelle paire nom-objet dans la portée de nom actuelle.
Méthode publiqueSealVerrouille ce style, ainsi que l'ensemble des fabriques et déclencheurs pour en empêcher la modification.
Méthode publiqueSetValue(DependencyProperty, Object)Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueUnregisterNameSupprime un mappage nom-objet de la portée de nom.
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeIAddChild.AddChildInfrastructure. Ajoute un objet enfant.
Implémentation d'interface expliciteMéthode privéeIAddChild.AddTextInfrastructure. Ajoute le texte d'un nœud à l'objet.
Implémentation d'interface expliciteMéthode privéeINameScope.FindNameInfrastructure. Retourne un objet qui porte le nom d'identification fourni.
Implémentation d'interface expliciteMéthode privéeIQueryAmbient.IsAmbientPropertyAvailableDemande si une propriété ambiante spécifiée est disponible dans la portée actuelle.
Début

Vous pouvez définir un Style sur n'importe quel élément dérivé de FrameworkElement ou FrameworkContentElement. Un style est souvent déclaré en tant que ressource dans la section Resources. Les styles étant des ressources, ils obéissent aux règles de portée applicables à toutes les ressources, de sorte que l'endroit où vous déclarez un style a une incidence sur l'endroit où il peut être utilisé. Si, par exemple, vous déclarez le style dans l'élément racine de votre fichier de définition d'application XAML, il pourra ê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, ce style ne peut être utilisé que dans ce fichier XAML. Pour plus d'informations sur les règles de portée relatives aux ressources, consultez Ressources XAML.

La déclaration du style se compose d'un objet Style qui contient une collection d'un ou de plusieurs objets Setter. Chaque 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 est appliqué. Le style, une fois déclaré en tant que ressource, peut être référencé comme n'importe quelle autre ressource.

RemarqueRemarque

Si plusieurs accesseurs Set de la collection d'accesseurs Set présentent la même valeur de propriété Property, c'est le dernier accesseur Set déclaré qui est utilisé. De la même façon, si vous définissez une valeur pour la même propriété dans un style et directement sur un élément, la valeur définie directement sur l'élément est prioritaire.

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

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

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


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


Pour appliquer le style précité, 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 propriété TargetType. Ajouter le type cible au style signifie que vous n'avez plus à qualifier complètement la propriété que vous définissez avec la syntaxe ClassName.PropertyName. L'exemple suivant définit un style qui s'appliquera à chaque élément TextBlock.


<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>


RemarqueRemarque

De nombreux contrôles WPF se composent d'une combinaison d'autres contrôles WPF. La création d'un style qui s'applique à tous les contrôles d'un type peut donc avoir un large impact. Par exemple, si vous créez un style qui cible les contrôles TextBlock d'un Canvas, le style est appliqué à tous les contrôles TextBlock de 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 la manière d'étendre un style défini ou d'en hériter, consultez la page BasedOn.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft