(Leadtools.Controls)

フレームを表示

ItemErrorイベント




ビューワが項目画像データを更新しようとするときにエラーが起きると発生します。
構文
イベントデータ

イベントハンドラは、このイベントに関連するデータを格納するタイプImageViewerItemErrorEventArgsの引数を受け取ります。以下のImageViewerItemErrorEventArgsプロパティは、このイベントに特有の情報を提供します。

プロパティ説明
Data このエラーのための追加のデータ。
Error ビューワによってキャッチされたエラーを取得します。
Item エラーを引き起こした項目。
Reason エラーが発生した理由。
RemoveEmptyItem それに1つ前のデータがないならば、項目を削除するべきかどうか示します。
解説

エラーは、画像ビューワが非同期で項目のどれの画像データでも更新している、または、外側がユーザープログラムに基づいた対話操作(例えばドラッグ/ドロップ操作のドロップ一部の間)を指示するならば、発生するかもしれません。始められた(非同期でイメージをロードする)あと、これらの操作は利用者コード(ドロップ)から発生しないか、あとで発生しませんので、ユーザーはこれらのエラーを処理することができるためにItemErrorイベントにハンドラを関連づけなければなりません。

ImageViewerItem.Urlの値が新しい値に設定されるとき、画像ビューワはRasterCodecs.LoadAsyncまたはRasterCodecs.LoadSvgAsyncを用いて非同期で画像データをロードするために現在のRasterCodecsInstanceを使います。これは、以下のどれによる引き金でもありえます:

エラーが発生するならば、それはイベントがImageViewerItemErrorEventArgsで以下の値を設定して発生するItemErrorを発生します:

メンバ
項目

エラーを呼び出した項目

理由

ImageViewerItemChangedReason.Url

データ

LoadAsyncCompletedまたはLoadSvgAsyncCompletedの間、ビューワによって内部的に使われるCodecsLoadAsyncCompletedEventArgsのインスタンスに設定します。

エラー

例外はスローされます

RemoveEmptyItem

それに1つ前のデータがないならば、自動的にこの項目を削除するために、trueに設定します。

imageまたはファイルシステム項目がビューワの上にドラッグ&ドロップされる、そして、AllowDroptrue設定されたとき、ビューワは自動的に新しい項目を更新するか、追加して、新しい画像データをそれへロードしようとします。エラーはこの点で発生するかもしれません、そして、もしそうならば、ItemErrorイベントはImageViewerItemErrorEventArgsで以下の値を設定して発生します:

メンバ
項目

エラーを呼び出した項目

理由

ImageViewerItemChangedReason.Drop

データ

使われているImageViewerItemDragDropEventArgsのインスタンスに設定します。

エラー

例外はスローされます

RemoveEmptyItem

それに1つ前のデータがないならば、自動的にこの項目を削除するために、trueに設定します。

ImageViewerItemErrorEventArgs
サンプル

サンプルのために、参照しますItemChanged

必要条件

ターゲットプラットホーム

参照

参照

ImageViewerクラス
ImageViewerメンバ