Image.ImageOpened Événement

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Se produit lorsque la source d’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

RoutedEventHandler

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é en tant que 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 .

Comportement de Windows 8

Pour Windows 8, les ressources peuvent utiliser un modèle de qualificateur de ressources pour charger différentes ressources en fonction de la mise à l’échelle de l’appareil. Toutefois, les ressources ne sont pas rechargées automatiquement si le facteur de mise à l’échelle change pendant l’exécution de l’application. Dans ce cas, les applications doivent s’occuper du rechargement des ressources, en gérant l’événement DpiChanged (ou l’événement LogicalDpiChanged déconseillé) et en utilisant l’API ResourceManager pour recharger manuellement la ressource appropriée pour le nouveau facteur de mise à l’échelle. À compter de Windows 8.1, 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 source (ImageOpened ou ImageFailed) est déclenché à la suite de l’action du système qui consiste à demander la nouvelle ressource, puis à l’appliquer à l’Image. Le scénario où une modification de l’échelle au moment de l’exécution peut se produire si l’utilisateur déplace votre application vers un autre moniteur lorsque plusieurs sont disponibles.

Si vous migrez le code de votre application de Windows 8 vers Windows 8.1 vous pouvez tenir compte de ce changement de comportement, car cela entraîne des événements ImageOpened ou ImageFailed qui se produisent 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. En outre, si vous avez du code qui gérait DpiChanged/LogicalDpiChanged et réinitialise les ressources, vous devez déterminer si ce code est toujours nécessaire compte tenu du nouveau comportement de rechargement automatique Windows 8.1.

Les applications qui ont été compilées pour Windows 8, mais qui sont exécutées dans Windows 8.1, continuent d’appliquer le comportement Windows 8.

Voir aussi

• ImageFailed
• Image et ImageBrush