LoadedImageSurface.LoadCompleted Evento

Definição

Namespace:

Microsoft.UI.Xaml.Media

Ocorre quando a imagem foi baixada, decodificada e carregada no ICompositionSurface subjacente.

// 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 de evento

TypedEventHandler<LoadedImageSurface,LoadedImageSourceLoadCompletedEventArgs>

Exemplos

Neste exemplo, definimos o tamanho de um SpriteVisual para corresponder exatamente ao tamanho decodificado de um LoadedImageSurface carregado com êxito.

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

Comentários

A instância LoadedImageSurface não terá uma imagem carregada ou informações de dimensionamento, até que esse evento seja acionado. O evento LoadCompleted é acionado independentemente de êxito ou falha e LoadedImageSourceLoadCompletedEventArgs pode ser usado para determinar o status.

O evento LoadCompleted é acionado sempre que a superfície de uma instância de LoadedImageSurface é preenchida com uma imagem. Isso inclui:

• A primeira vez que um LoadedImageSurface é inicializado
• O dispositivo se recupera de um estado perdido
• Uma alteração de DPI faz com que uma fonte de imagem diferente seja carregada
• O aplicativo se recupera de um estado de memória insuficiente

Os usos comuns do evento LoadCompleted são para colocar uma imagem temporária se a origem da imagem pode levar muito tempo para carregar ou redimensionar um visual exatamente para o tamanho decodificado do LoadedImageSurface.