LEADTOOLS Leadtools.Documents.UI(Leadtools.Documents.UIアセンブリ)

フレームを表示

DocumentViewerThumbnailsクラス






メンバ 
このドキュメントビューワでサムネイルを管理します。
オブジェクトモデル
構文
public class DocumentViewerThumbnails 
'Declaration
 
Public Class DocumentViewerThumbnails 
'Usage
 
Dim instance As DocumentViewerThumbnails
public ref class DocumentViewerThumbnails 
解説

DocumentViewerThumbnailsは、DocumentViewerサムネイルプロパティによってアクセスできます。

このクラスは、ドキュメントビューワで現在の文書セットにおけるページのサムネイル画像を管理します。

クラスは、サムネイルを表示するために、ImageViewerのインスタンスを作成します。サムネイル画像はバックグラウンドスレッドでロードされ、アプリケーションのユーザーインターフェースの応答性を保ちます。

指定されたページにビューを移動するためにサムネイルをクリックすることなどの、クラスはサムネイルでユーザーとの対話処理も処理します。

ドキュメントビューワが作成されるとき、

DocumentViewerCreateOptions.ThumbnailsContainerの値がnullであるならば、サムネイルサポートはアプリケーションによって必要とされません、そして、DocumentViewer.Thumbnailsnullで、使われるべきでありません。

さもなければ、以下は発生します:

  1. DocumentViewerThumbnailsの新しいインスタンスは、DocumentViewer.Thumbnailsプロパティで作成されて、設定されます。

  2. ImageViewerコントロールの新しいインスタンスは、作成されて、DocumentViewerCreateOptions.ThumbnailsContainerへの子コントロールとして追加されます。ドキュメントがビューワで設定されるとき、この画像ビューワはページのサムネイル画像を表示するのに用いられます。このコントロールは、このクラスのImageViewerプロパティを用いてアクセスされることができます。情報については、このImageViewerがどのように初期化されるかの、プロパティをごらんください。

ドキュメントビューワが破壊されるとき、

  1. ImageViewerコントロールは、親ThumbnailsContainerから削除されます。

  2. すべての資源は開放されます。

新しいドキュメントが設定されるとき、

新しいDocumentオブジェクトがDocumentViewer.SetDocumentを用いてDocumentViewerで設定されるとき、以下は発生します。

1つ前のドキュメントがドキュメントビューワで設定されるならば、以下は実行されます:

  1. それがまだロードしているならば、背景スレッドは停止されます。

  2. 1つ前のドキュメントのための項目は、ImageViewer.Items.Clearを呼び出すことによって、ImageViewerから削除されます。

新しい文書セットがnull(アプリケーションはちょうどこのドキュメントを閉じました)であるならば、更なるアクションは必要とされません。

新しいドキュメントオブジェクトが設定されるならば、以下は実行されます:

  1. 推奨のサムネイルピクセルサイズは、新しいドキュメントDocumentImages.ThumbnailPixelSizeから得られて、ImageViewer.ItemSizeプロパティで設定されます。

  2. ImageViewerItemは、ドキュメントにおけるページごとに作成されます。ImageViewerItem.ImageSizeの値は、正しいアスペクト比を維持管理するために、各々のページとサムネイルサイズのDocumentPage.Size値から計算されます。項目のテキストはstring"Page number"で更新されます、そして、項目はビューワコントロールに追加されます。項目は「空で」、画像データを格納しません。これは、次の手順で更新されます。

  3. 背景スレッドは、サムネイル画像をロードするために作成されます。これはアプリケーションユーザーインターフェースの応答性を保ち、パフォーマンスを最適化するために行います。スレッドは、ImageViewerのスクロール位置を追跡し、現在表示可能な項目のサムネイルをロードします。サムネイルは、DocumentPage.GetThumbnailImageを用いてドキュメントから得られます。imageが取り戻されるとき、それはImageViewerItem.Imageで設定されます。すべてのサムネイルのためのイメージが得られるまで、これは繰り返されます。IsLoadingの値は、背景スレッドがまだサムネイルをロードしているかどうか決定するのに用いられることができます。

  4. 背景ワーカーがサムネイルをロードする間、Operationイベントは発生します。特定の詳細のためのドキュメントビューワの操作と動作をカスタマイズする方法を参照してください

操作

DocumentViewerThumbnailsは、以下を処理します:

サンプル

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

必要条件

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

参照

参照

DocumentViewerThumbnailsメンバ
Leadtools.Documents.UI名前空間
LEADTOOLSドキュメントビューワの使用

Leadtools.Documents.UIは、DocumentまたはMedicalツールキットのライセンスと、解除キーが必要です。詳細は、以下を参照してください。Imaging Pro/Document/Medicalの機能