TileBrush Classe

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Décrit une façon de peindre une zone à l’aide d’une ou de plusieurs mosaïques.

public ref class TileBrush abstract : System::Windows::Media::Brush

public abstract class TileBrush : System.Windows.Media.Brush

type TileBrush = class
    inherit Brush

Public MustInherit Class TileBrush
Inherits Brush

Héritage

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

TileBrush

Dérivé

System.Windows.Media.DrawingBrush

System.Windows.Media.ImageBrush

System.Windows.Media.VisualBrush

Remarques

Les classes dérivées de TileBrush définissent le contenu des vignettes que vous utilisez pour peindre une région. Par exemple, utilisez la ImageBrush classe pour peindre une zone à l’aide d’une image.

Utilisez un TileBrush pour contrôler la façon dont vous peignez une zone. Par exemple, Windows Presentation Foundation (WPF) fournit plusieurs types de pinceaux :

• Pour peindre à l’aide d’une image, utilisez le ImageBrush.

• Pour peindre en dessinant, utilisez .DrawingBrush

• Pour peindre à l’aide d’un Visual, utilisez le VisualBrush.

Lorsque vous utilisez pour TileBrush peindre une zone, au lieu de peindre une zone à l’aide d’une seule image étirée, vous pouvez peindre une zone à l’aide d’une série de vignettes d’image qui créent un motif.

Lorsque vous peignez une zone à l’aide d’un TileBrush, vous utilisez trois composants : le contenu, les vignettes et la zone de sortie. Les illustrations suivantes montrent comment ces trois composants sont liés les uns TileBrush aux autres.

Composants d’un TileBrush avec une seule mosaïque

Composants d’un TileBrush avec un TileMode de mosaïque

Contenu : un TileBrush peut avoir différents types de contenu :

• Si le pinceau est un ImageBrush, ce contenu est une image. La ImageSource propriété spécifie le contenu de .ImageBrush

• Si le pinceau est un DrawingBrush, ce contenu est un dessin. La Drawing propriété spécifie le contenu de .DrawingBrush

• Si le pinceau est un VisualBrush, ce contenu est un visuel. La Visual propriété spécifie le contenu du VisualBrush.

Vous pouvez spécifier la position et les dimensions du contenu à l’aide de TileBrush la Viewbox propriété .

Vignettes : un TileBrush produit une ou plusieurs vignettes. Par défaut, le contenu du pinceau est étiré pour remplir une seule vignette et cette vignette est étirée pour remplir la zone de sortie. La Viewport propriété est utilisée pour spécifier la taille et la position de la vignette de base pour le TileBrush. La ViewportUnits propriété détermine si la taille et la position de sont Viewport relatives à la zone de sortie (comportement par défaut) ou s’il s’agit de valeurs absolues.

Zone de sortie : la zone de sortie est la zone que le pinceau peint, comme le Fill d’un Ellipse ou le Background d’un Button.

Pour plus d’informations sur la TileBrush classe , consultez Peinture avec des images, des dessins et des visuels .

Fonctionnalités Freezable

Un TileBrush est un Freezable type. Pour plus d’informations sur Freezable les fonctionnalités, telles que le gel et le clonage, consultez la vue d’ensemble de Freezable Objects.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de la TileBrush classe , vous devez remplacer la CreateInstanceCore() méthode . Pour plus d’informations sur l’héritage de Freezable types, consultez La vue d’ensemble des objets Freezable.

Constructeurs

TileBrush()

Fournit l'initialisation pour les valeurs de classe de base en cas d'appel par le constructeur d'une classe dérivée.

Champs

AlignmentXProperty	Identifie la propriété de dépendance AlignmentX.
AlignmentYProperty	Identifie la propriété de dépendance AlignmentY.
StretchProperty	Identifie la propriété de dépendance Stretch.
TileModeProperty	Identifie la propriété de dépendance TileMode.
ViewboxProperty	Identifie la propriété de dépendance Viewbox.
ViewboxUnitsProperty	Identifie la propriété de dépendance ViewboxUnits.
ViewportProperty	Identifie la propriété de dépendance Viewport.
ViewportUnitsProperty	Identifie la propriété de dépendance ViewportUnits.

Propriétés

AlignmentX	Obtient ou définit l’alignement horizontal du contenu dans la mosaïque de base TileBrush.
AlignmentY	Obtient ou définit l’alignement vertical du contenu dans la vignette de base TileBrush.
CanFreeze	Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable)
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
HasAnimatedProperties	Obtient une valeur qui indique si un ou plusieurs objets AnimationClock sont associés à l'une ou l'autre des propriétés de dépendance de cet objet. (Hérité de Animatable)
IsFrozen	Obtient une valeur qui indique si l’objet est actuellement modifiable. (Hérité de Freezable)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
Opacity	Obtient ou définit le degré d’opacité d’un Brush. (Hérité de Brush)
RelativeTransform	Obtient ou définit la transformation appliquée au pinceau en utilisant des coordonnées relatives. (Hérité de Brush)
Stretch	Obtient ou définit une valeur qui spécifie la façon dont le contenu de ce TileBrush s’étire pour s’ajuster à ses mosaïques.
TileMode	Obtient ou définit une valeur qui spécifie comment un TileBrush remplit la zone que vous êtes en train de peindre si la mosaïque de base est plus petite que la zone de sortie.
Transform	Obtient ou définit la transformation appliquée au pinceau. Cette transformation est appliquée après que la sortie du pinceau a été mappée et positionnée. (Hérité de Brush)
Viewbox	Obtient ou définit la position et les dimensions du contenu dans TileBrush.
ViewboxUnits	Obtient ou définit une valeur qui spécifie si la valeur de Viewbox est relative à la zone englobante du contenu de TileBrush ou si la valeur est absolue.
Viewport	Obtient ou définit la position et les dimensions de la mosaïque de base pour TileBrush.
ViewportUnits	Obtient ou définit une énumération BrushMappingMode qui spécifie si la valeur de Viewport, qui indique la taille et la position de la mosaïque de base TileBrush, est relative à la taille de la zone de sortie.

Méthodes

ApplyAnimationClock(DependencyProperty, AnimationClock)	Applique AnimationClock au DependencyProperty spécifié. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applique AnimationClock au DependencyProperty spécifié. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable)
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
Clone()	Crée une copie modifiable de ce TileBrush en effectuant des copies complètes de ses valeurs.
CloneCore(Freezable)	Fait de l’instance un clone (copie complète) du Freezable spécifié utilisant des valeurs de propriété (non animée) de base. (Hérité de Freezable)
CloneCurrentValue()	Crée une copie modifiable de cet objet TileBrush, en effectuant une copie complète de ses valeurs. Cette méthode ne copie pas les références de ressource, les liaisons de données ou les animations bien qu'elle copie leurs valeurs actuelles.
CloneCurrentValueCore(Freezable)	Fait de l’instance un clone (copie complète) modifiable du Freezable spécifié à l’aide des valeurs de propriété actuelles. (Hérité de Freezable)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	Une fois implémentée dans une classe dérivée, initialise une nouvelle instance de la classe dérivée Freezable. (Hérité de Freezable)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
Freeze()	Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur true. (Hérité de Freezable)
FreezeCore(Boolean)	Rend cet objet Animatable non modifiable ou détermine s'il peut être rendu non modifiable. (Hérité de Animatable)
GetAnimationBaseValue(DependencyProperty)	Retourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable)
GetAsFrozen()	Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetAsFrozenCore(Freezable)	Transforme l’instance en clone figé du Freezable spécifié utilisant des valeurs de propriété (non animée) de base. (Hérité de Freezable)
GetContentBounds(Rect)	Obtient les limites actuelles du contenu TileBrush.
GetCurrentValueAsFrozen()	Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convertit l’instance actuelle en un clone figé du Freezable spécifié. Si l’objet a des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées. (Hérité de Freezable)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnChanged()	Appelé lorsque l’objet Freezable actuel est modifié. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Substitue l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable. (Hérité de Freezable)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
ReadPreamble()	Garantit que Freezable est accessible à partir d'un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une représentation sous forme de chaîne de ce Brush. (Hérité de Brush)
ToString(IFormatProvider)	Crée une représentation sous forme de chaîne de cet objet selon les informations de mise en forme spécifique à la culture spécifiées. (Hérité de Brush)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)
WritePostscript()	Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged(). Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance. (Hérité de Freezable)
WritePreamble()	Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)

Événements

Changed

Se produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable)

Implémentations d’interfaces explicites

IFormattable.ToString(String, IFormatProvider)

Met en forme la valeur de l’instance actuelle en utilisant le format spécifié. (Hérité de Brush)

Voir aussi

• Stretch
• Viewport
• TileMode
• AlignmentX
• AlignmentY
• Viewbox