LEADTOOLS JavaScript(Leadtools.Controls)

フレームを表示

ImageViewerレンダリングサイクルは、完全なカスタマイゼーションをサポートします。いろいろなイベントとデータは、以下のどれのためにでも、以下を許可します:

レンダリングサイクル

ImageViewer.InvalidateまたはImageViewer.RenderRedirectが通常の制御描画またはImageViewer.UpdateTransformへの反応により呼び出されるとき、レンダリングサイクルは発生します。レンダリングサイクルをカスタマイズするために、特定のイベントにサブスクライブすることができるか、ImageViewerに由来することができて、特定の仮想メソッドをオーバーライドします。すべてのこれらのメソッドとイベントは、必要な情報を保持するために、ImageViewerRenderEventArgsクラスを使用します。

ImageViewerRenderEventArgsは、以下を格納します:

メンバ 説明
コンテキスト

JavaScriptで、CanvasContextビューワの前景キャンバスのオブジェクト-ImageViewer.ForeCanvas)またはRenderRedirectの間のターゲットデバイスのそれ。

項目

描画されている項目、または描画サイクルのこの部分のnullはビュー固有です。

Part

描画されている項目の部分、または描画サイクルのこの部分がビュー固有である場合はView。

エラー

レンダリングサイクルの間、キャッチされたエラー。ImageViewer.RenderErrorイベントで使われます。

ImageViewerRenderEventArgs.ClipRectangle

適用される現在のクリッピング四角形。

画像ビューワは仮想メソッドを呼び出して、後述する順序で、イベントを発生します。ImageViewerRenderEventArgs.Contexプロパティは、ポイントしSystem.Drawing.Graphicsます(Windows.Formsで)または(JavaScriptの前景キャンバスのためのHTMLCanvasContext2Dオブジェクト)、ビューワコントロールまたは再直接尋問のターゲット。

注意:画像ビューが要素Modeを使っているならば、これらのイベントの全てが発生するというわけではありません。

メソッド-イベント ImageViewerRenderEventArgs.Item, Part デフォルトの操作
OnEraseBackgroundEraseBackground

nullImageViewerItem.View

背景(要素Modeででなく)を消去するか、クリアします
OnPreRenderPreRender

nullImageViewerItem.View

なし。コンテキストプロパティ(たとえば、アンチエイリアスまたは補間品質)を設定するのに用いられることができます
OnRenderShadowRenderShadow

nullImageViewerItem.View

ビュー(要素Modeででなく)のドロップシャドウを提出します
OnRenderBorderRenderBorder

nullImageViewerItem.View

ビュー(要素Modeででなく)の境界を提出します
各項目のために

ビューワの項目を通してのループ。項目がIsVisibleであり、空のImageSizeが無く、現在の可視ビューワ表面およびクリッピング四角形を交差する場合にのみ発生します。

OnPreRenderItemPreRenderItem

項目-項

なし。
OnRenderItemRenderItem

項目-項

なし。
OnRenderBackgroundRenderBackground

項目-項

項目状態(要素Modeででなく)に基づく背景色で、項目のコンテンツを塗りつぶします
OnRenderBorderRenderBorder

項目-コンテンツ

項目状態(要素Modeででなく)に基づく境界線の色を用いて、コンテンツ境界を提出します
OnRenderShadowRenderShadow

項目-image

項目(要素Modeででなく)のimageのまわりで、ドロップシャドウを提出します
OnRenderImageRenderImage

項目-image

項目にimage(要素Modeででなく)を与えます
OnRenderBorderRenderBorder

項目-image

image(要素Modeででなく)の境界を提出します
OnRenderTextRenderText

項目-テキスト

項目(要素Modeででなく)のテキストを提出します
OnPostRenderItemPostRenderItem

項目-項

なし。
次項
OnPostRenderPostRender

nullImageViewerItem.View

フローターとリージョンを提出します
OnRedirectRenderRedirectRender

nullImageViewerItem.View

なし。

最も一般的なカスタム描画は、これらのイベントにサブスクライブすることで実施されます。

サンプルについては、「これらのイベント」を参照してください。

新しいレンダリングサイクルを手動で呼び出すために、呼び出しはビューワの一部の全部の表面を無効にすることを無効にします。このメソッドは、ビューワの一部を指定する長方形を受け取り、最適速度が得られるよう更新します。InvalidateItemまたはInvalidateItemByIndexメソッドは、速く単一の項目を再び提出するのに用いられることができます。

レンダリングとき、エラー

通常、ImageViewerコントロールの描画は自動で行われ、ユーザーが呼び出したコードは介在しません。エラーが発生した場合、ユーザーは例外をトライ/キャッチしてエラーを処理する機能を持ちません。したがって、ImageViewerRenderErrorイベントを格納します。エラーが内部のレンダリングサイクルに起こるとき、これは発生します。イベントは同じImageViewerRenderEventArgsデータクラスを使用するので、項目と一部がエラーにもたらしたもののすべての通常のパラメータはユーザーに渡されます。また、それはエラーをキャッチして、ImageViewerRenderEventArgs.Errorプロパティでそれを設定します。

他のレンダリング操作

ImageViewerは、レンダリングに関連した以下の操作もサポートします:

表示

メンバ 説明
invert

反転色ですべての項目を示します

ScreenDpi

ドット/インチで画面解像度の値を更新します

UseDpi

表示サイズを計算するとき、項目でimageの解像度を占めます

AspectRatioCorrection

手動で、正方形でないないピクセルのために誤差を補うのに用いられるアスペクト比を変更します

BeginRender

時間的に、レンダリングを無効にします

EndRender

レンダリングを再び有効にします

無効にします

ビューの全体または一部を再描画するようリクエストします。

RedirectRender

外部のコンテキストに現在のビューを与えます

ClipImageToContent

項目の変換により境界が大きくなった場合、コンテンツの内側に画像の一部のみを表示します。

OwnerDraw

ビューおよび項目のすべての自動描画をオフまたはオンにします。

参照

参照

ImageViewerを用いて
HTML5とJavaScriptによる画像ビューワを用いて
画像ビューワコンポーネント
画像ビューワ要素モード
画像ビューワユーザー定義のHTMLディスプレイ
アプリケーションの複数の画像ビューアーを用いて
画像ビューワ外観
画像ビューワの項目
画像ビューワの境界と変換
画像ビューワの変換
画像ビューワのレイアウト
画像ビューワのスクローリング
画像ビューワの対話モード
画像ビューワのそのほかのオプション
画像ビューワのシングルアイテムモード
画像ビューワのドラッグ&ドロップ
画像ビューワ補間