LoadedImageSurface.LoadCompleted イベント

定義

名前空間:

Microsoft.UI.Xaml.Media

イメージがダウンロードされ、デコードされ、基になる ICompositionSurface に読み込まれたときに発生します。

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

イベントの種類

TypedEventHandler<LoadedImageSurface,LoadedImageSourceLoadCompletedEventArgs>

例

この例では、 SpriteVisual のサイズを、正常に読み込まれた LoadedImageSurface のデコードされたサイズと正確に一致するように設定します。

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

注釈

LoadedImageSurface インスタンスには、このイベントが発生するまで、読み込まれたイメージまたはサイズ設定情報はありません。 LoadCompleted イベントは成功または失敗に関係なく発生し、LoadedImageSourceLoadCompletedEventArgs を使用して状態を確認できます。

LoadCompleted イベントは、LoadedImageSurface のインスタンスのサーフェスにイメージが設定されるたびに発生します。 これには次のものが含まれます

• LoadedImageSurface が初めて初期化されるとき
• デバイスが失われた状態から回復する
• DPI の変更により、別のイメージ ソースが読み込まれます
• アプリがメモリ不足状態から回復する

LoadCompleted イベントの一般的な用途は、イメージ ソースの読み込みまたはサイズ変更に時間がかかる可能性がある場合に、一時的なイメージを LoadedImageSurface のデコードされたサイズに正確に配置することです。