Share via

Image.ImageOpened 事件

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Controls
編輯

發生於下載並譯碼影像來源時，不會失敗。 您可以使用此事件來判斷影像來源的自然大小。

// 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"/>

事件類型

RoutedEventHandler

備註

當 ImageOpened 引發時，它會做為任何異步操作已完成的通知，以及做為影像來源之物件的所有屬性都可供使用。 例如，若要判斷影像的大小，請處理 ImageOpened，並檢查參考為 Image.Source 的物件上 PixelWidth 和 PixelHeight 屬性的值。 ImageOpened 事件的事件數據通常並不實用。

當 Image 元素不在即時可視化樹狀結構中時，Image 元素將不會引發 ImageOpened 或 ImageFailed 事件。 如果您需要在元素不在即時樹狀結構中時收到這些事件，請使用 BitmapImage。ImageOpened/ImageFailed 事件。

映像資源

資源可以使用資源限定符模式，根據裝置特定的調整來載入不同的資源。 如果應用程式執行時調整因數變更，系統會自動重新評估您應用程式原本擷取的任何資源。 此外，當該資源是 Image 物件的影像來源時，就會引發其中一個來源載入事件 (ImageOpened 或 ImageFailed) ，因為系統要求新資源的動作，然後將它套用至 Image。 運行時間調整變更可能發生的案例，是在有一個以上的可用時，當使用者將應用程式移至不同的監視器時。 因此，即使 Source 是在 XAML 中設定來源的情況下，在運行時間處理調整變更時，ImageOpened 或 ImageFailed 事件也會發生。

適用於

另請參閱