BitmapImage.ImageOpened Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn die Bildquelle heruntergeladen und ohne Fehler decodiert wird. Sie können dieses Ereignis verwenden, um die Größe eines Bilds zu bestimmen, bevor Sie es rendern.
// 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 darüber, dass alle asynchronen Vorgänge abgeschlossen wurden und alle Eigenschaften eines BitmapImage zur Verwendung bereit sind. Um beispielsweise die Größe des Bilds vor dem Rendern zu bestimmen, behandeln Sie ImageOpened, und überprüfen Sie den Wert der PixelWidth - und PixelHeight-Eigenschaften 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 (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 Ihrem BitmapImage als Quelle für ein Image oder ImageBrush zugewiesen haben. Wenn Sie Eigenschaften ändern möchten, die sich auf das Rendering des Bilds basierend auf den Leseeigenschaften des BitmapImage-Objekts auswirken, ist es häufig am besten, das zugrunde liegende BitmapImage-Ereignis zu behandeln, bevor Sie es als Quelle zuweisen.