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 es gerendert wird.
// 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 sind und alle Eigenschaften eines BitmapImages zur Verwendung bereit sind. Um beispielsweise die Größe des Bilds zu ermitteln, bevor es gerendert wird, behandeln Sie ImageOpened, und überprüfen Sie den Wert der PixelWidth - und PixelHeight-Eigenschaften auf dem BitmapImage , das das Ereignis ausgelöst hat. Die Ereignisdaten für das ImageOpened-Ereignis sind in der Regel nicht hilfreich.
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. Die BitmapImage.ImageOpened wird zu einem Zeitpunkt ausgelöst, der potenziell vor dem Zuweisen ihres BitmapImages zur Quelle eines Bilds oder ImageBrush gehört. Wenn Sie Eigenschaften ändern möchten, die sich auf das Rendern des Bilds basierend auf den Leseeigenschaften des BitmapImage auswirken, empfiehlt es sich häufig, das zugrunde liegende BitmapImage-Ereignis zu behandeln, bevor es als Quelle zugewiesen wird.