BitmapImage.ImageOpened Événement
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.
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 restituer.
// Register
event_token ImageOpened(RoutedEventHandler const& handler) const;
// Revoke with event_token
void ImageOpened(event_token const* cookie) const;
// Revoke with event_revoker
BitmapImage::ImageOpened_revoker ImageOpened(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler ImageOpened;
function onImageOpened(eventArgs) { /* Your code */ }
bitmapImage.addEventListener("imageopened", onImageOpened);
bitmapImage.removeEventListener("imageopened", onImageOpened);
- or -
bitmapImage.onimageopened = onImageOpened;
Public Custom Event ImageOpened As RoutedEventHandler
<BitmapImage ImageOpened="eventhandler"/>
Type d'événement
Remarques
Lorsque ImageOpened se déclenche, cela sert de notification indiquant que toutes les opérations asynchrones sont terminées et que toutes les propriétés d’un BitmapImage sont prêtes à être utilisées. Par exemple, pour déterminer la taille de l’image avant de la restituer, gérez ImageOpened et case activée la valeur des propriétés PixelWidth et PixelHeight sur bitmapImage qui a déclenché l’événement. Les données d’événement de l’événement ImageOpened ne sont généralement pas utiles.
La classe Image a également un événement ImageOpened (tout comme ImageBrush). Pour les autres événements ImageOpened , ceux-ci se déclenchent à un moment où l’image a probablement déjà été rendue. BitmapImage.ImageOpened se déclenche à un moment qui est potentiellement avant que vous n’ayez affecté votre BitmapImage à la source d’une image ou d’un objet ImageBrush. Si vous souhaitez modifier les propriétés qui affectent le rendu de l’image en fonction des propriétés de lecture de BitmapImage, il est souvent préférable de gérer l’événement BitmapImage sous-jacent avant de l’affecter en tant que source.