Image.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 Imagequelle heruntergeladen und ohne Fehler decodiert wird. Sie können dieses Ereignis verwenden, um die natürliche Größe der Bildquelle 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
Image::ImageOpened_revoker ImageOpened(auto_revoke_t, RoutedEventHandler const& handler) const;public event RoutedEventHandler ImageOpened;function onImageOpened(eventArgs) { /* Your code */ }
image.addEventListener("imageopened", onImageOpened);
image.removeEventListener("imageopened", onImageOpened);
- or -
image.onimageopened = onImageOpened;Public Custom Event ImageOpened As RoutedEventHandler <Image ImageOpened="eventhandler"/>
Ereignistyp
Hinweise
Wenn ImageOpened ausgelöst wird, dient dies als Benachrichtigung, dass alle asynchronen Vorgänge abgeschlossen wurden und alle Eigenschaften des Objekts, das als Bildquelle verwendet wird, einsatzbereit sind. Um beispielsweise die Größe des Bilds zu bestimmen, behandeln Sie ImageOpened, und überprüfen Sie den Wert der Eigenschaften PixelWidth und PixelHeight für das Objekt, auf das als Image.Source verwiesen wird. Die Ereignisdaten für das ImageOpened-Ereignis sind in der Regel nicht nützlich.
Wenn sich das Image-Element nicht in der visuellen Livestruktur befindet, löst das Image-Element keine ImageOpened- oder ImageFailed-Ereignisse aus . Wenn Sie diese Ereignisse empfangen müssen, während sich das Element nicht in der Livestruktur befindet, verwenden Sie BitmapImage. ImageOpened/ImageFailed-Ereignisse .
Bildressourcen
Ressourcen können ein Ressourcenqualifizierermuster verwenden, um je nach gerätespezifischer Skalierung verschiedene Ressourcen zu laden. Alle Ressourcen, die ursprünglich für Ihre App abgerufen wurden, werden automatisch neu ausgewertet, wenn sich der Skalierungsfaktor ändert, während die App ausgeführt wird. Wenn diese Ressource die Bildquelle für ein Image-Objekt ist, wird eines der Quellladeereignisse (ImageOpened oder ImageFailed) ausgelöst, als Ergebnis der Systemaktion, die neue Ressource anzufordern und dann auf das Image anzuwenden. Das Szenario, in dem eine Änderung der Laufzeitskalierung auftreten kann, ist, wenn der Benutzer Ihre App auf einen anderen Monitor verschiebt, wenn mehrere verfügbar sind. Daher können ImageOpened- oder ImageFailed-Ereignisse zur Laufzeit auftreten, wenn die Skalierungsänderung behandelt wird, auch wenn die Quelle in XAML festgelegt ist.