TileBrush Classe

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Décrit un moyen de peindre une région à l’aide d’une ou plusieurs vignettes.

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éfinir 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 peindrez 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 dessin, utilisez le DrawingBrush.

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

Lorsque vous utilisez la TileBrush peinture d’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 mosaïques d’images qui créent un motif.

Lorsque vous peintz 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 TileBrush composants se rapportent les uns aux autres.

Composants d’un TileBrush avec une seule vignette

Composants d’un TileBrush avec un TileMode de vignette

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 du ImageBrush.

• Si le pinceau est un DrawingBrush, ce contenu est un dessin. La Drawing propriété spécifie le contenu du 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 : A 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 des valeurs sont relatives à la zone de Viewport sortie (comportement par défaut) ou si elles sont des valeurs absolues.

Zone de sortie : la zone de sortie est la zone que le pinceau peint, par exemple l’un FillEllipse ou l’autre Background d’un Button.

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

Fonctionnalités gratuites

A 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 des objets freezables.

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 des Freezable types, consultez la vue d’ensemble des objets Freezable.

Constructeurs

Nom	Description
TileBrush()	Fournit l’initialisation des valeurs de classe de base lorsqu’elles sont appelées par le constructeur d’une classe dérivée.

Champs

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

Propriétés

Nom	Description
AlignmentX	Obtient ou définit l’alignement horizontal du contenu dans la TileBrush vignette de base.
AlignmentY	Obtient ou définit l’alignement vertical du contenu dans la TileBrush vignette de base.
CanFreeze	Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable)
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
HasAnimatedProperties	Obtient une valeur qui indique si un ou plusieurs AnimationClock objets sont associés à l’une 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	Obtient une valeur qui indique si cette instance est actuellement scellée (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 à l’aide de coordonnées relatives. (Hérité de Brush)
Stretch	Obtient ou définit une valeur qui spécifie la façon dont le contenu de cet TileBrush élément s’étend pour s’adapter à ses vignettes.
TileMode	Obtient ou définit une valeur qui spécifie comment un TileBrush remplissage de la zone que vous peinturez si la vignette de base est inférieure à la zone de sortie.
Transform	Obtient ou définit la transformation appliquée au pinceau. Cette transformation est appliquée une fois la sortie du pinceau mappée et positionnée. (Hérité de Brush)
Viewbox	Obtient ou définit la position et les dimensions du contenu dans une TileBrush vignette.
ViewboxUnits	Obtient ou définit une valeur qui spécifie si la Viewbox valeur est relative à la zone englobante du TileBrush contenu ou si la valeur est absolue.
Viewport	Obtient ou définit la position et les dimensions de la vignette de base pour un TileBrush.
ViewportUnits	Obtient ou définit une BrushMappingMode énumération qui spécifie si la valeur du Viewport, qui indique la taille et la position de la TileBrush vignette de base, est relative à la taille de la zone de sortie.

Méthodes

Nom	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, la propriété HandoffBehavior spécifiée est utilisée. (Hérité de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, celle-ci HandoffBehavior est utilisée. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable)
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (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 un DependencyPropertyKey. (Hérité de DependencyObject)
Clone()	Crée une copie modifiable de cette TileBrush opération en effectuant des copies approfondies de ses valeurs.
CloneCore(Freezable)	Rend l’instance un clone (copie approfondie) de la propriété de base (non animée) spécifiée Freezable . (Hérité de Freezable)
CloneCurrentValue()	Crée une copie modifiable de cet TileBrush objet en effectuant des copies approfondies de ses valeurs. Cette méthode ne copie pas les références de ressources, les liaisons de données ou les animations, bien qu’elle copie leurs valeurs actuelles.
CloneCurrentValueCore(Freezable)	Rend l’instance un clone modifiable (copie approfondie) de l’élément spécifié Freezable à l’aide de valeurs de propriété actuelles. (Hérité de Freezable)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	En cas d’implémentation dans une classe dérivée, crée une nouvelle instance de la Freezable classe dérivée. (Hérité de Freezable)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
Freeze()	Rend l’objet actuel non modifiable et définit sa IsFrozen propriété sur true. (Hérité de Freezable)
FreezeCore(Boolean)	Rend cet Animatable objet non modifiable ou détermine s’il peut être rendu inmodifiable. (Hérité de Animatable)
GetAnimationBaseValue(DependencyProperty)	Retourne la valeur non animée de l’objet spécifié DependencyProperty. (Hérité de Animatable)
GetAsFrozen()	Crée une copie figée des valeurs de Freezablepropriété de base (non animées). É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)	Rend l’instance un clone figé de la propriété spécifiée à Freezable l’aide de valeurs de propriété de base (non animées). (Hérité de Freezable)
GetContentBounds(Rect)	Obtient les limites actuelles du TileBrush contenu.
GetCurrentValueAsFrozen()	Crée une copie figée de l’utilisation Freezable 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)	Rend l’instance actuelle un clone figé du fichier spécifié Freezable. Si l’objet a des propriétés de dépendance animée, 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)
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)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
OnChanged()	Appelé lorsque l’objet actuel Freezable est modifié. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ce membre prend en charge l’infrastructure WPF (Windows Presentation Foundation) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un DependencyObjectType membre de données qui vient d’être défini. (Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Remplace l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) l’appel de tous Changed les gestionnaires en réponse à une propriété de dépendance modifiée de type Freezable. (Hérité de Freezable)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
ReadPreamble()	Garantit l’accès Freezable à partir d’un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API qui lit 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 source de valeur. (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 la 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 en fonction des informations de mise en forme spécifiques à la culture spécifiées. (Hérité de Brush)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
WritePostscript()	Déclenche l’événement Changed pour la Freezable méthode et appelle sa OnChanged() méthode. Les classes dérivées Freezable de doivent appeler cette méthode à la fin de toute API qui modifie les 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 l’objet Freezable n’est pas figé et qu’il est accessible à partir d’un contexte de threading valide. Freezable Les hériteurs doivent appeler cette méthode au début de toute API qui écrit dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)

Événements

Nom	Description
Changed	Se produit lorsque l’objet Freezable qu’il contient est modifié. (Hérité de Freezable)

Implémentations d’interfaces explicites

Nom	Description
IFormattable.ToString(String, IFormatProvider)	Met en forme la valeur de l’instance actuelle à l’aide du format spécifié. (Hérité de Brush)

Voir aussi

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