BitmapImage.DownloadProgress Événement

Définition

Espace de noms:

Windows.UI.Xaml.Media.Imaging

Se produit lorsqu’un changement important s’est produit dans la progression du téléchargement du contenu 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"/>

Type d'événement

DownloadProgressEventHandler

Exemples

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

Remarques

Dans les cas où le chargement et le décodage asynchrones d’un objet BitmapImage sont suffisamment longs pour être visibles par l’utilisateur, une application peut gérer DownloadProgress sur la source et afficher un ProgressRing ou ProgressBar pour indiquer l’état de progression. Celles-ci peuvent s’afficher dans la région d’interface utilisateur dans laquelle l’image s’affiche éventuellement, ou ailleurs dans l’interface utilisateur. Utilisez DownloadProgressEventArgs.Progress pour modifier l’interface utilisateur d’un ProgressBar.

Voir aussi

• DownloadProgressEventArgs
• ProgressBar