BitmapImage.DownloadProgress イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
BitmapImage コンテンツのダウンロードの進行状況で大幅な変更が発生したときに発生します。
public:
virtual event DownloadProgressEventHandler ^ DownloadProgress;// Register
event_token DownloadProgress(DownloadProgressEventHandler const& handler) const;
// Revoke with event_token
void DownloadProgress(event_token const* cookie) const;
// Revoke with event_revoker
BitmapImage::DownloadProgress_revoker DownloadProgress(auto_revoke_t, DownloadProgressEventHandler const& handler) const;public event DownloadProgressEventHandler DownloadProgress;function onDownloadProgress(eventArgs) { /* Your code */ }
bitmapImage.addEventListener("downloadprogress", onDownloadProgress);
bitmapImage.removeEventListener("downloadprogress", onDownloadProgress);
- or -
bitmapImage.ondownloadprogress = onDownloadProgress;Public Custom Event DownloadProgress As DownloadProgressEventHandler <BitmapImage DownloadProgress="eventhandler"/>
イベントの種類
例
// somewhere in initialization
bitmapImage.DownloadProgress += new EventHandler<DownloadProgressEventArgs>(bi_DownloadProgress);
bitmapImage.ImageOpened += new EventHandler<ExceptionRoutedEventArgs>(bi_ImageOpened);
...
//progressBar is an existing control defined in XAML or extracted from a XAML template
void bi_DownloadProgress(object sender, DownloadProgressEventArgs e)
{
progressBar.Value = e.Progress;
}
void bi_ImageOpened(object sender, RoutedEventArgs e)
{
progressBar.Visibility = Visibility.Collapsed;
}
注釈
BitmapImage オブジェクトの非同期読み込みとデコードがユーザーに認識されるまでの時間が長い場合、アプリはソースの DownloadProgress を処理し、ProgressRing または ProgressBar を表示して進行状況の状態を示すことができます。 これらは、イメージが最終的に表示される UI 領域、または UI の他の場所に表示される場合があります。 DownloadProgressEventArgs.Progress を使用して ProgressBar の UI を変更します。