LEADTOOLSコントロール(Leadtools.Topics.Controlsアセンブリ)

フレームを表示

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

レンダリングサイクル

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

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

メンバ 説明
コンテキスト

Windowsフォームで、System.Drawing.Graphics描画の間のビューワコントロールのオブジェクトまたはRenderRedirectの間のターゲットデバイスのそれ。

JavaScriptでは、前景キャンバスのHTMLCanvasContext2Dオブジェクト、またはRenderRedirectの間のターゲットデバイスのオブジェクト。

PaintEventArgs

このレンダリングイベントがあるならば、オリジナルのWindows.Formsは引数を描画しますSystem.Windows.Forms.Control.Paint

項目

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

Part

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

エラー

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

ImageViewerRenderEventArgs.ClipRectangle

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

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

メソッド-イベント ImageViewerRenderEventArgs.Item, Part デフォルトの操作
ImageViewer.OnEraseBackground - ImageViewer.EraseBackground JavaScriptだけ

nullImageViewerItem.View

背景を消去するか、クリアします
OnPreRenderPreRender

nullImageViewerItem.View

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

nullImageViewerItem.View

ビューのドロップシャドウを提出します
OnRenderBorderRenderBorder

nullImageViewerItem.View

ビューの境界を提出します
各項目のために

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

OnPreRenderItemPreRenderItem

項目-項

なし。
OnRenderItemRenderItem

項目-項

なし。
OnRenderBackgroundRenderBackground

項目-項

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

項目-コンテンツ

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

項目-image

項目のimageのまわりで、ドロップシャドウを提出します
OnRenderImageRenderImage

項目-image

項目にimageを与えます
OnRenderBorderRenderBorder

項目-image

imageの境界を提出します
OnRenderTextRenderText

項目-テキスト

項目のテキストを提出します
OnPostRenderItemPostRenderItem

項目-項

なし。
次項
OnPostRenderPostRender

nullImageViewerItem.View

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

nullImageViewerItem.View

なし。

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

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

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

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

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

他のレンダリング操作

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

表示

メンバ 説明
invert

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

ScreenDpi

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

UseDpi

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

AspectRatioCorrection

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

BeginRender

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

EndRender

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

ImageViewer.Invalidate

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

PaintProperties

RasterImageオブジェクトを描画する際に使用する品質を制御します。

RedirectRender

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

ClipImageToContent

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

OwnerDraw

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

参照

参照

ImageViewerを用いて
Windows.Formsによる画像ビューワの利用
画像ビューワ外観
画像ビューワの項目
画像ビューワの境界と変換
画像ビューワの変換
画像ビューワのレイアウト
画像ビューワのレンダリング
画像ビューワのスクローリング
画像ビューワの対話モード
画像ビューワのそのほかのオプション
画像ビューワのシングルアイテムモード
画像ビューワのバーチュアライザ
画像ビューワのドラッグ&ドロップ