LoadedImageSurface.LoadCompleted Ereignis

Definition

Namespace:

Microsoft.UI.Xaml.Media

Tritt auf, wenn das Image heruntergeladen, decodiert und in die zugrunde liegende ICompositionSurface geladen wurde.

// 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"/>

Ereignistyp

TypedEventHandler<LoadedImageSurface,LoadedImageSourceLoadCompletedEventArgs>

Beispiele

In diesem Beispiel legen wir die Größe eines SpriteVisual so fest, dass sie genau der decodierten Größe eines erfolgreich geladenen LoadedImageSurface entspricht.

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
    }
}

Hinweise

Das LoadedImageSurface-instance verfügt erst dann über geladene Bilder oder Größeninformationen, wenn dieses Ereignis ausgelöst wird. Das LoadCompleted-Ereignis wird unabhängig von Erfolg oder Fehler ausgelöst, und die LoadedImageSourceLoadCompletedEventArgs können verwendet werden, um die status zu bestimmen.

Das LoadCompleted-Ereignis wird jedes Mal ausgelöst, wenn die Oberfläche einer instance von LoadedImageSurface mit einem Bild aufgefüllt wird. Dies umfasst u. a.:

• Das erste Mal, wenn ein LoadedImageSurface initialisiert wird
• Das Gerät wird nach einem verlorenen Zustand wiederhergestellt.
• Eine DPI-Änderung bewirkt, dass eine andere Bildquelle geladen wird.
• Die App wird nach einem geringen Arbeitsspeicherzustand wiederhergestellt.

Häufige Verwendungen des LoadCompleted-Ereignisses sind das Erstellen eines temporären Bilds, wenn das Laden oder Ändern der Größe eines Visuals auf die decodierte Größe von LoadedImageSurface lange dauern kann.