ImageBrush.ImageSource Propriété
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.
Obtient ou définit la source d’image affichée par cette ImageBrush. Dans le code, vous définissez cette valeur avec une sous-classe ImageSource instance. En XAML, vous définissez cette valeur 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é
Objet représentant la source d’image, à afficher par cette ImageBrush lorsqu’elle est appliquée au contenu.
Remarques
La définition d’une source d’image à partir d’un fichier ou d’un flux source d’image est par nature une action asynchrone. La définition d’une valeur URI (Uniform Resource Identifier) qui ne peut pas être résolue en un 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 s’est chargé correctement, vous pouvez gérer ImageOpened pour vérification, ainsi que ImageFailed comme un moyen de fournir une source d’image de secours ou de recomposer 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 de l’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 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 de code, ImageBrush.ImageSource nécessite un 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) 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 prend un URI (Uniform Resource Identifier). Vous pouvez également envisager de gérer l’événement ImageOpened s’il existe des problèmes de délai liés à la récupération ou au décodage de la source de l’image, auquel cas un contenu alternatif peut s’avérer nécessaire à afficher 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.
Notes
Vous pouvez utiliser la gestion automatique pour accéder aux 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 la mise à l’échelle pour obtenir directement les ressources. Pour plus d’informations, voir Système de gestion des ressources.
Sources d’images et mise à l’échelle
Vous devez créer vos sources d’images à plusieurs tailles recommandées, afin de vous assurer que votre application s’affiche bien quand Windows 8 la met à l’échelle. Lorsque vous spécifiez un ImageSource pour un ImageBrush, vous pouvez utiliser une convention de nommage qui référencera automatiquement la ressource appropriée pour la mise à l’échelle actuelle. Pour connaître les spécificités de la convention d’affectation de noms et obtenir plus d’informations, voir Démarrage rapide : Utilisation de ressources de fichiers ou d’images.
Pour plus d’informations sur la conception de la mise à l’échelle, consultez 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.