BitmapImage.ImageOpened Ereignis

Definition

Tritt auf, wenn die Imagequelle heruntergeladen und ohne Fehler decodiert wird. Sie können dieses Ereignis verwenden, um die Größe eines Bilds vor dem Rendern zu bestimmen.

// Register
event_token ImageOpened(RoutedEventHandler const& handler) const;

// Revoke with event_token
void ImageOpened(event_token const* cookie) const;

// Revoke with event_revoker
BitmapImage::ImageOpened_revoker ImageOpened(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler ImageOpened;
function onImageOpened(eventArgs) { /* Your code */ }
bitmapImage.addEventListener("imageopened", onImageOpened);
bitmapImage.removeEventListener("imageopened", onImageOpened);
- or -
bitmapImage.onimageopened = onImageOpened;
Public Custom Event ImageOpened As RoutedEventHandler 
<BitmapImage ImageOpened="eventhandler"/>

Ereignistyp

Hinweise

Wenn ImageOpened ausgelöst wird, dient dies als Benachrichtigung, dass alle asynchronen Vorgänge abgeschlossen wurden und alle Eigenschaften eines BitmapImage zur Verwendung bereit sind. Um z. B. die Größe des Bilds vor dem Rendern zu bestimmen, behandeln Sie ImageOpened, und überprüfen Sie den Wert der Eigenschaften PixelWidth und PixelHeight für das BitmapImage , das das Ereignis ausgelöst hat. Die Ereignisdaten für das ImageOpened-Ereignis sind in der Regel nicht nützlich.

Die Image-Klasse verfügt auch über ein ImageOpened-Ereignis (ebenso wie ImageBrush). Bei den anderen ImageOpened-Ereignissen werden diese zu einem Zeitpunkt ausgelöst, zu dem das Bild wahrscheinlich bereits gerendert wurde. BitmapImage.ImageOpened wird zu einem Zeitpunkt ausgelöst, der möglicherweise bevor Sie Ihr BitmapImage als Quelle für ein Image oder ImageBrush zugewiesen haben. Wenn Sie Eigenschaften ändern möchten, die sich auf das Rendern des Bilds auswirken, basierend auf leseeigenschaften von BitmapImage, ist es häufig am besten, das zugrunde liegende BitmapImage-Ereignis zu behandeln, bevor Sie es als Quelle zuweisen.

Gilt für:

Weitere Informationen