LoadedImageSurface.LoadCompleted Événement

Définition

Espace de noms:

Microsoft.UI.Xaml.Media

Se produit lorsque l’image a été téléchargée, décodée et chargée dans le ICompositionSurface sous-jacent.

// Register
event_token LoadCompleted(TypedEventHandler<LoadedImageSurface, LoadedImageSourceLoadCompletedEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
LoadedImageSurface::LoadCompleted_revoker LoadCompleted(auto_revoke_t, TypedEventHandler<LoadedImageSurface, LoadedImageSourceLoadCompletedEventArgs const&> const& handler) const;

public event TypedEventHandler<LoadedImageSurface,LoadedImageSourceLoadCompletedEventArgs> LoadCompleted;

function onLoadCompleted(eventArgs) { /* Your code */ }
loadedImageSurface.addEventListener("loadcompleted", onLoadCompleted);
loadedImageSurface.removeEventListener("loadcompleted", onLoadCompleted);
- or -
loadedImageSurface.onloadcompleted = onLoadCompleted;

Public Custom Event LoadCompleted As TypedEventHandler(Of LoadedImageSurface, LoadedImageSourceLoadCompletedEventArgs) 

<LoadedImageSurface LoadCompleted="eventhandler"/>

Type d'événement

TypedEventHandler<LoadedImageSurface,LoadedImageSourceLoadCompletedEventArgs>

Exemples

Dans cet exemple, nous définissons la taille d’un SpriteVisual pour qu’elle corresponde exactement à la taille décodée d’un LoadedImageSurface correctement chargé.

private Load_Completed(LoadedImageSurface sender, LoadedImageSourceLoadCompletedEventArgs e)
{
    if(e.Status == LoadedImageSourceLoadStatus.Success){
        // imageVisual is a SpriteVisual than has been previously created and whose brush references the LoadedImageSurface
        Size decodedSize = sender.DecodedSize;
        imageVisual.Size = new Vector2((float)decodedSize.Width, (float)decodedSize.Height);

    } else {
        // Handle a load failure
    }
}

Remarques

L’instance LoadedImageSurface n’aura pas d’image ou d’informations de dimensionnement chargées tant que cet événement n’aura pas été déclenché. L’événement LoadCompleted se déclenche indépendamment de la réussite ou de l’échec et l’objet LoadedImageSourceLoadCompletedEventArgs peut être utilisé pour déterminer le status.

L’événement LoadCompleted se déclenche chaque fois que la surface d’un instance de LoadedImageSurface est remplie avec une image. notamment :

• La première fois qu’un LoadedImageSurface est initialisé
• L’appareil récupère à partir d’un état perdu
• Une modification DPI entraîne le chargement d’une autre source d’image
• L’application récupère à partir d’un état de mémoire faible

Les utilisations courantes de l’événement LoadCompleted sont de placer une image temporaire si la source d’image peut prendre beaucoup de temps pour charger ou redimensionner un visuel exactement à la taille décodée de LoadedImageSurface.