LoadedImageSurface.LoadCompleted Evento

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Xaml.Media

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Si verifica quando l'immagine è stata scaricata, decodificata e caricata nell'oggetto ICompositionSurface sottostante.

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

Tipo evento

TypedEventHandler<LoadedImageSurface,LoadedImageSourceLoadCompletedEventArgs>

Esempio

In questo esempio vengono impostate le dimensioni di un SpriteVisual in modo che corrispondano esattamente alle dimensioni decodificate di un oggetto LoadedImageSurface caricato correttamente.

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

Commenti

L'istanza di LoadedImageSurface non avrà un'immagine caricata o informazioni di ridimensionamento, fino a quando questo evento non viene generato. L'evento LoadCompleted viene generato indipendentemente dall'esito positivo o dall'errore e da LoadedImageSourceLoadCompletedEventArgs può essere usato per determinare lo stato.

L'evento LoadCompleted viene generato ogni volta che la superficie di un'istanza di LoadedImageSurface viene popolata con un'immagine. ad esempio:

La prima volta che viene inizializzato un oggetto LoadedImageSurface
Il dispositivo recupera da uno stato perso
Una modifica DPI causa il caricamento di un'origine immagine diversa
L'app recupera da uno stato di memoria insufficiente

Gli usi comuni dell'evento LoadCompleted sono per inserire un'immagine temporanea se l'origine immagine potrebbe richiedere molto tempo per caricare o ridimensionare un oggetto visivo esattamente alla dimensione decodificata del file LoadedImageSurface.

Si applica a

Condividi tramite