Image.ImageFailed Événement

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Se produit lorsqu’une erreur est associée à la récupération ou au format de l’image.

public:
 virtual event ExceptionRoutedEventHandler ^ ImageFailed;

// Register
event_token ImageFailed(ExceptionRoutedEventHandler const& handler) const;

// Revoke with event_token
void ImageFailed(event_token const* cookie) const;

// Revoke with event_revoker
Image::ImageFailed_revoker ImageFailed(auto_revoke_t, ExceptionRoutedEventHandler const& handler) const;

public event ExceptionRoutedEventHandler ImageFailed;

function onImageFailed(eventArgs) { /* Your code */ }
image.addEventListener("imagefailed", onImageFailed);
image.removeEventListener("imagefailed", onImageFailed);
- or -
image.onimagefailed = onImageFailed;

Public Custom Event ImageFailed As ExceptionRoutedEventHandler 

<Image ImageFailed="eventhandler"/>

Type d'événement

ExceptionRoutedEventHandler

Remarques

Les conditions dans lesquelles cet événement peut se produire sont les suivantes :

• Fichier introuvable
• Format de fichier (non reconnu ou non pris en charge) non valide
• Erreur de décodage du format de fichier inconnu après le chargement
• Rechargement de ressources qualifié par le système Vous pouvez peut-être utiliser errorMessage dans les données d’événement pour déterminer la nature de l’échec.

ImageFailed et ImageOpened s’excluent mutuellement. Un événement ou un autre se déclenche toujours chaque fois qu’une valeur Source est définie ou réinitialisée dans une image.

L’un des scénarios de gestion d’ImageFailed consiste à définir l’UriSource de la source BitmapImage sous-jacente sur un autre fichier image local. Cela peut servir de valeur de secours à afficher au lieu d’un espace vide. Par exemple, si vous essayez d’afficher une image externe où il est possible que la source ne soit plus là, ou lorsque l’utilisateur n’a pas de connexion Internet, vous pouvez définir UriSource pour référencer une image d’espace réservé ou de secours locale qui fait partie de votre package d’application et qui est toujours disponible.

Lorsque l’élément Image ne se trouve pas dans l’arborescence visuelle dynamique, l’élément Image ne déclenche pas les événements ImageOpened ou ImageFailed. Si vous devez recevoir ces événements alors que l’élément n’est pas dans l’arborescence dynamique, utilisez BitmapImage. ImageOpened/Événements ImageFailed .

private void Image_ImageFailed(object sender, ExceptionRoutedEventArgs e) {
    Image img = sender as Image;
    BitmapImage fallbackImage = new BitmapImage(new Uri("ms-appx:///Images/fallback.png"));
    img.Width = 100; //set to known width of this source's natural size
     //might instead want image to stretch to fill, depends on scenario
    img.Source = fallbackImage;
}

Ressources d’image

Les ressources peuvent utiliser un modèle de qualificateur de ressources pour charger différentes ressources en fonction de la mise à l’échelle propre à l’appareil. Toute ressource qui a été récupérée à l’origine pour votre application est automatiquement réévaluée si le facteur de mise à l’échelle change pendant l’exécution de l’application. En outre, lorsque cette ressource est la source d’image d’un objet Image, l’un des événements de chargement de la source (ImageOpened ou ImageFailed) est déclenché à la suite de l’action du système qui demande la nouvelle ressource, puis l’applique à l’Image. Le scénario où un changement d’échelle au moment de l’exécution peut se produire si l’utilisateur déplace votre application vers un autre moniteur quand plusieurs sont disponibles. Par conséquent, les événements ImageOpened ou ImageFailed peuvent se produire au moment de l’exécution lorsque le changement d’échelle est géré, même dans les cas où la source est définie en XAML.