Langage

ImageBrush.ImageSource Propriété

Définition

Espace de noms:
Microsoft.UI.Xaml.Media
Modifier

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.

public:
 property ImageSource ^ ImageSource { ImageSource ^ get(); void set(ImageSource ^ value); };
ImageSource ImageSource();

void ImageSource(ImageSource value);
public ImageSource ImageSource { get; set; }
var imageSource = imageBrush.imageSource;
imageBrush.imageSource = imageSource;
Public Property ImageSource As ImageSource
<ImageBrush ImageSource="imageUri"/>

Valeur de propriété

ImageSource

Objet représentant la source de l’image, à afficher par cette ImageBrush lorsqu’il est appliqué au contenu.

Remarques

La définition d’une source d’image à partir d’un fichier ou d’un flux source d’image est intrinsèquement une action asynchrone. La définition de la source sur une valeur URI (Uniform Resource Identifier) qui ne peut pas être résolue en fichier source d’image valide ne génère pas d’erreur. Au lieu de cela, il déclenche un événement ImageFailed sur ImageBrush. Si vous souhaitez vérifier qu’un fichier source d’image a été chargé correctement, vous pouvez gérer ImageOpened pour la vérification, plus ImageFailed comme moyen de fournir une source d’image de secours ou de recompiler votre interface utilisateur.

Définition d’ImageSource en XAML

Vous pouvez définir cette propriété en XAML, mais dans ce cas, vous définissez la valeur d’attribut ImageSource en tant que chaîne représentant un URI (Uniform Resource Identifier). Ce comportement s’appuie sur la conversion de type sous-jacente qui traite la chaîne en tant qu’URI (Uniform Resource Identifier) et appelle l’équivalent interne du constructeur BitmapImage(Uri).

L’événement ImageFailed peut se produire si la valeur d’attribut ImageSource initiale en XAML ne spécifie pas de source valide. Vous pouvez utiliser un chemin relatif pour référencer une image que vous empaquetez avec l’application ou un URI (Uniform Resource Identifier) absolu pour référencer une image à partir d’un serveur. Si vous utilisez une source d’image empaquetée dans le cadre de votre application, il est courant d’utiliser les schémas ms-appx ou ms-resource .

Définition d’ImageSource dans le code

Si vous définissez un ImageBrush à l’aide du code, ImageBrush.ImageSource nécessite une Image Bitmap ( 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 référençant un fichier, 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.

Si vous devez composer un URI par rapport à un autre objet de l’interface utilisateur pour vous aider à étendre la demande de ressource, vous pouvez parfois utiliser la propriété FrameworkElement.BaseUri comme appelée sur un autre objet de l’interface utilisateur. Cela fournit un URI de base qui est l’endroit où la page XAML provient de la structure de projet de l’application.

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.

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.

Pour plus d’informations sur les ressources d’application et sur la façon de empaqueter des sources d’images dans une application, consultez Définition des ressources d’application.

S’applique à

Voir aussi