ImageBrush.ImageFailed 事件

定義

命名空間:

Microsoft.UI.Xaml.Media

發生於與影像擷取或格式相關聯的錯誤時。

public:
 virtual event ExceptionRoutedEventHandler ^ ImageFailed;

// Register
event_token ImageFailed(ExceptionRoutedEventHandler const& handler) const;

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

// Revoke with event_revoker
ImageBrush::ImageFailed_revoker ImageFailed(auto_revoke_t, ExceptionRoutedEventHandler const& handler) const;

public event ExceptionRoutedEventHandler ImageFailed;

function onImageFailed(eventArgs) { /* Your code */ }
imageBrush.addEventListener("imagefailed", onImageFailed);
imageBrush.removeEventListener("imagefailed", onImageFailed);
- or -
imageBrush.onimagefailed = onImageFailed;

Public Custom Event ImageFailed As ExceptionRoutedEventHandler 

<ImageBrush ImageFailed="eventhandler"/>

事件類型

ExceptionRoutedEventHandler

備註

如果引發此事件，這表示 ImageSource 值已異步判斷為無法使用，或不適合使用。 發生此事件的條件包括：

• 找不到檔案
• 無效 (無法辨識或不支援的檔案格式)
• 上傳 ImageBrush 之後發生未知的檔格式譯碼錯誤，在此情況下將不會顯示任何內容。 應用程式映像沒有預設的「遺漏影像」佔位元影像，因為瀏覽器可能無法解析影像 URI 時。 如果您想要像這樣的行為，您必須實作它。

ImageFailed 和 ImageOpened 互斥。 每當 ImageBrush 設定或重設 ImageSource 值時，一律會提出一個事件或另一個事件。