ImageBrush Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Peint une zone avec une image. La source d’image est généralement obtenue à partir de formats de fichiers tels que joint Photographic Experts Group (JPEG).
public ref class ImageBrush sealed : TileBrush/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageBrush final : TileBrush[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ImageBrush : TileBrushPublic NotInheritable Class ImageBrush
Inherits TileBrush<ImageBrush .../>
- Héritage
- Attributs
Exemples
Cet exemple XAML montre comment définir la propriété De premier plan d’un TextBlock sur un ImageBrush, dont l’image est utilisée comme remplissage pour le texte rendu par TextBlock.
<!-- TextBlock with an image brush applied to the text. -->
<TextBlock FontFamily="Verdana" FontSize="72"
FontStyle="Italic" FontWeight="Bold">
SHRUBBERY
<TextBlock.Foreground>
<ImageBrush ImageSource="forest.jpeg"/>
</TextBlock.Foreground>
</TextBlock>
Remarques
Un pinceau ImageBrush est un type de pinceau qui définit son contenu comme une image qui peut éventuellement être étirée et alignée. Les utilisations d’un objet ImageBrush incluent des effets décoratifs pour le texte ou les arrière-plans d’image pour les contrôles ou les conteneurs de disposition.
Il est utile d'utiliser un objet ImageBrush au lieu d'un contrôle Image dans deux scénarios principaux :
- Vous souhaitez peindre une zone non rectangulaire telle qu’une ellipse ou une bordure avec une image
- Vous souhaitez utiliser un seul ImageBrush pour peindre plusieurs zones ou UIElements avec la même image, ce qui est plus efficace que l’utilisation de plusieurs contrôles Image
Si vous définissez un ImageBrush à l’aide du code, utilisez le constructeur par défaut, puis définissez ImageBrush.ImageSource. Cela nécessite une BitmapImage (et non un URI)) dans le code. Si votre source est un flux, utilisez la méthode SetSourceAsync pour initialiser la valeur. Si votre source est un URI (Uniform Resource Identifier), qui inclut du contenu dans votre application qui utilise les schémas ms-appx ou ms-resource , utilisez le constructeur BitmapImage qui accepte un URI (Uniform Resource Identifier). Vous pouvez également envisager de gérer l’événement ImageOpened s’il y a des problèmes de délai liés à la récupération ou au décodage de la source de l’image, auquel cas il peut être nécessaire d’afficher un contenu alternatif tant que la source de l’image n’est pas disponible. Consultez l’exemple d’images XAML pour obtenir un exemple de code.
Note
Vous pouvez utiliser la gestion automatique pour accéder à des ressources non qualifiées avec des qualificateurs d’échelle et de culture actuels, ou vous pouvez utiliser ResourceManager et ResourceMap avec des qualificateurs pour la culture et l’échelle pour obtenir les ressources directement. Pour plus d’informations, consultez le système de gestion des ressources.
La propriété Stretch est importante pour la façon dont l’image est appliquée lorsqu’elle est utilisée en tant que pinceau. Certaines images sont correctes lorsqu’elles sont étirées comme appliquées à une propriété Brush particulière avec le comportement de remplissage , tandis que d’autres images ne s’étendent pas correctement et peuvent nécessiter une valeur None ou Uniform pour Stretch. Expérimentez des valeurs différentes pour Stretch afin de voir quel comportement semble le mieux lorsqu’il est appliqué à l’interface utilisateur.
Sources d’image et mise à l’échelle
Vous devez créer vos sources d’images à plusieurs tailles recommandées pour vous assurer que votre application est très performante quand Windows 8 la met à l’échelle. Lorsque vous spécifiez une ImageSource pour un ImageBrush, vous pouvez utiliser une convention d’affectation de noms qui référencera automatiquement la ressource appropriée pour la mise à l’échelle actuelle. Pour plus d’informations sur la convention d’affectation de noms et plus d'informations supplémentaires, consultez Démarrage rapide : Utilisation des ressources de fichier ou d'image.
Pour plus d’informations sur la conception de la mise à l’échelle, consultez les instructions d’expérience utilisateur pour la disposition et la mise à l’échelle.
Constructeurs
| Nom | Description |
|---|---|
| ImageBrush() |
Initialise une nouvelle instance de la classe ImageBrush . |
Propriétés
| Nom | Description |
|---|---|
| AlignmentX |
Obtient ou définit l’alignement horizontal du contenu dans la vignette de base TileBrush . (Hérité de TileBrush) |
| AlignmentY |
Obtient ou définit l’alignement vertical du contenu dans la vignette de base TileBrush . (Hérité de TileBrush) |
| Dispatcher |
Retourne |
| DispatcherQueue |
Obtient le |
| ImageSource |
Obtient ou définit la source d’image affichée par cet ImageBrush. Dans le code que vous définissez avec une instance de sous-classe ImageSource , en XAML, vous définissez cela avec un URI sur un fichier source d’image. |
| ImageSourceProperty |
Identifie la propriété de dépendance ImageSource . |
| Opacity |
Obtient ou définit le degré d’opacité d’un pinceau. (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 ce TileBrush s’étend pour s’adapter à ses vignettes. (Hérité de TileBrush) |
| Transform |
Obtient ou définit la transformation appliquée au pinceau. (Hérité de Brush) |
Méthodes
| Nom | Description |
|---|---|
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
| GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Définit une propriété qui peut être animée. (Hérité de Brush) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
En cas de substitution dans une classe dérivée, définit une propriété qui peut être animée. (Hérité de Brush) |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à une dependencyProperty spécifique sur cette instance DependencyObject . (Hérité de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |
Événements
| Nom | Description |
|---|---|
| ImageFailed |
Se produit lorsqu’une erreur est associée à la récupération ou au format d’image. |
| ImageOpened |
Se produit lorsque la source de l’image est téléchargée et décodée sans échec. Vous pouvez utiliser cet événement pour déterminer la taille d’une image avant de la rendre. |