LoadedImageSurface.LoadCompleted Evento
Definizione
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.
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
Esempio
In questo esempio, le dimensioni di un oggetto SpriteVisual vengono impostate 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 o informazioni di ridimensionamento caricate finché non viene generato questo evento. L'evento LoadCompleted viene generato indipendentemente dall'esito positivo o negativo e è possibile usare LoadedImageSourceLoadCompletedEventArgs 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 viene ripristinato da uno stato perso
- Una modifica DPI causa il caricamento di un'origine immagine diversa
- L'app viene ripristinata da uno stato di memoria insufficiente
Gli usi comuni dell'evento LoadCompleted sono l'impostazione di un'immagine temporanea se l'origine dell'immagine può richiedere molto tempo per caricare o ridimensionare un oggetto visivo esattamente in base alle dimensioni decodificate di LoadedImageSurface.