Image.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 naturelle de la source d’image.
// Register
event_token ImageOpened(RoutedEventHandler const& handler) const;
// Revoke with event_token
void ImageOpened(event_token const* cookie) const;
// Revoke with event_revoker
Image::ImageOpened_revoker ImageOpened(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler ImageOpened;
function onImageOpened(eventArgs) { /* Your code */ }
image.addEventListener("imageopened", onImageOpened);
image.removeEventListener("imageopened", onImageOpened);
- or -
image.onimageopened = onImageOpened;
Public Custom Event ImageOpened As RoutedEventHandler
<Image 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 de l’objet utilisé comme source d’image sont prêtes à être utilisées. Par exemple, pour déterminer la taille de l’image, gérez ImageOpened et case activée la valeur des propriétés PixelWidth et PixelHeight sur l’objet référencé sous le nom Image.Source. Les données d’événement de l’événement ImageOpened ne sont généralement pas utiles.
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 .
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.