LEADTOOLSアノテーション(非推奨)

フレームを表示
注意:このトピックは、Document/Medicalのみを対象とします。アノテーションはベクター描画関数に基づいており、表示画像のオーバーレイとしてビットマップに関連づけられています。LEADTOOLSは、線分、四角形、ホットスポット、改訂オブジェクト、多角形、およびコンテナなどの数多くのアノテーション型をサポートします。コンテナは特殊なアノテーションオブジェクトで、そのほかのコンテナオブジェクトなど、そのほかのアノテーションオブジェクトを位置指定したりグループ化できます。各種アノテーションオブジェクトのサポートは各種アノテーションオブジェクトクラスによって提供されます。これらのクラス名の形式はAnnXXXXObjectで、XXXXにオブジェクトの型が入ります。利用できるアノテーションオブジェクトクラスの全リストについては、アノテーションObjectsのタイプを参照します。LEADTOOLSは、ビットマップとは別に、アノテーションを維持管理します。アプリケーションコードは、イメージとアノテーションの関係を維持管理する役割を果たします。たとえば、LEADTOOLSに付属しているアノテーションのサンプルでは、対応する画像ファイルと名前が同じで拡張子が異なるアノテーションファイルが作成されます。画像ファイルがロードされると、関連づけられるアノテーションファイルを検索し、同様にロードします。 バージョン14 SP1より前のバージョンでは、アノテーションを保存するときに以下のいずれかの形式を指定してAnnCodecs.Saveメソッドを呼び出していました。 バージョン14.5以前は、アノテーションファイルの保存に推奨される形式はネイティブ形式でした。バージョン14.5では、アノテーション用の新しいテキストベースの形式があります。 - AnnCodecsFormat.Xml。これは、LEADアノテーションをXML (Extensible Markup Language)形式で保存するためのテキストベースの形式です。Xml形式は、アノテーションを保存するための優先形式として、ネイティブ形式を置換しています。 Xml形式を使用する利点は、数多くあります。 非自動アノテーション非自動アノテーションでは、アノテーションの作成と対話処理を必要に応じてカスタマイズできます。非自動アノテーションをプログラミングする際は、以下の点を念頭に置いてください。 非自動アノテーションプログラムを作成することのチュートリアルのために、非自動アノテーションプログラムを実装してランモードで非自動アノテーションを使うことを参照します。

オートメーション化したアノテーション

自動アノテーションを組み込むには、オートメーションオブジェクトをRasterImageViewerに関連付ける必要があります。この自動オブジェクトを使用して、すべてのオブジェクトのデフォルトプロパティを保持できます。たとえば、デフォルトのフォントとデフォルトの線幅を設定するために、それを使うことができます。しかし、倍率がこれらのデフォルトの測定の外観に影響を及ぼすことを心にとめておきます。値は、オブジェクトの作成時に効果を有する倍率に基づいて設定されます。自動化されたアノテーションに関連づけられる機能は、以下の通りです。 以下を実行するかどうかを選択できるオプションなど、自動アノテーションのユーザーインターフェースにはアノテーションオブジェクトの動作を制御するオプションがあります。 詳細については、「バージョン14.5の新しいアノテーション特集」を参照してください。オートメーション化したアノテーションプログラムを作成することのチュートリアルのために、自動アノテーションの操作を参照します。

アノテーションクラス

以下の段落では、アノテーションのサポートを導入する際に使用する主要なクラスについて簡単に説明します。AnnAutomationObjectクラスは、アノテーションを自動化するために必要なすべてのプロパティを定義しますオブジェクト。このクラスのインスタンスを作成し、必要なプロパティに値を入力し、Objectsコレクションに追加します。いつでも、Objectsコレクションを列挙し、必要なプロパティを追加、削除または変更できます。CreateDefaultObjectsメソッドは、デフォルトのアノテーションオブジェクトのためにデフォルトのAnnAutomationObjectオブジェクトを作成します。LEADTOOLSは、デフォルトのアノテーションオブジェクトのためにオートメーションプロパティを作成します。このクラスのメンバをオーバーライドするか、または独自の派生クラスを作成することにより、プロパティの動作を変更できます。オーバーライドする方法に関する情報を含む自動モードで、ユーザーインターフェースを通して使われるデフォルトのテキスト文字列に関する情報については、LEADTOOLS for .NETアノテーションオートメーションのローカライゼーションを参照します。CreateDefaultObjectsメソッドを使って、デフォルトの自動アノテーションオブジェクトを作成し、CreateDefaultObjectContextMenuメソッドで、特定のIDに関連づけられるコンテキストメニューを作成します。ObjectsまたはCreateDefaultObjectsで自動オブジェクトのセットアップが終わったらCreateToolBarメソッドを呼び出します。このメソッドを呼び出すと、ToolBarが作成されます。作成されたツールバーはフォームに追加できます。FindObjectメソッドを使って特定のIDに関連づけられるAnnAutomationObjectを検索します。ユーザー自動オブジェクトの作成に関するチュートリアルは、「LEADTOOLSアノテーションによる道具ユーザー定義のObjects」を参照してください。AnnAutomationManagerクラスは、アノテーションツールバー同様にアプリケーション内ですべてのAnnAutomationオブジェクトのコレクションを保持します。カーソル、キーボード、コンテキスト依存メニュー、プロパティダイアログ、その他各種のユーザーインタフェースオプションおよび設定もここに保存されます。オートメーション化したアノテーションアプリケーションは、通常アプリケーションにつき1つのAnnAutomationManagerオブジェクトを作成します。アノテーションで機能するとき、多くのオブジェクトの背景色(内部を塗りつぶすカラー)はオブジェクトの「ブラシ」を変更することによって変更されることができます、そして、直線の特徴はオブジェクトの「ペン」を変更することによって変更されることができます。詳細については、「変更しているアノテーションオートメーション背景色」を参照してください。アノテーションペンのサポートがAnnPenクラスによって提供される間、アノテーションブラシのサポートはAnnBrushとその派生クラスによって提供されます。AnnCodecsクラスは、操作をロードして保存することを処理します。以下のメソッドで、ファイルからアノテーションをロードするか、ファイルに保存することができます。 AnnContainerクラスは、アノテーションコンテナ(アノテーションオブジェクトを保持する長方形の領域)を表します。コンテナは、こうしたオブジェクトを保持し、必要に応じて描画します。AnnDesignerクラスは、アノテーションツールキットのすべてのデザイナーのためのベースクラスです。AnnDesigner派生クラスは、オブジェクトを描画するか、編集するか、実行することに関係しているユーザーインターフェース機能性を制御します。このクラスは、コンテナのフックやマウスカーソルのクリッピングなどすべてのデザイナに共通する基本機能を提供します。デザイナのAnnContainerオブジェクトをContainerメンバに、RasterImageViewerオブジェクトをOwnerメンバに割り当てます。こうすると、正確なデザイナ機能に基づいてさまざまなマウスイベントがフックされ、新しいAnnObjectの描画、既存の編集(移動やリサイズなど)、または実行(コンテナが実行ユーザーモードの場合)が行われます。AnnDesignerクラスは、適宜メソッドを提供します。 AnnDrawableなクラスは、アノテーションクラスライブラリで使われるすべてのアノテーションオブジェクトのためのベースクラスです。このクラスは、アノテーションクラスライブラリですべてのアノテーションオブジェクトによって共有される共通の描画情報を保持します。このクラスのプロパティを参照すれば、特定のクラスがペン、ブラシ、フォントをサポートするかが簡単にわかり、すばやく変更できます。たとえばオートメーションモードで使用されるプロパティダイアログは、ペンオプションを表示するかどうかをテストするために、これを実行します。AnnPrinterクラスは、RasterImageとAnnContainerのプリントをサポートします。AnnPrinterクラスはRasterImagePrinterの派生クラスで、RasterImageの上にAnnContainerを印刷する処理を簡単にします。.NET frameworkを用いた印刷は、PrintPageイベントにハンドラを追加することが必要です。このイベントハンドラでは、AnnPrinterクラスの新しいインスタンスを設定し、必要に応じてそのプロパティを設定して、印刷メソッドを呼び出します。その際、Printメソッドには、印刷するRasterImage、画像ページ番号、印刷するアノテーションオブジェクトを含むAnnContainer、およびPrintPageEventHandlerから取得したPrintPageEventArgsオブジェクトを渡します。AnnTransformerクラスは、機能性を1つの座標系からもう一つにアノテーションポイント、長方形、長さなどを変換するために提供するアノテーションサポートクラスです。このクラスはTransformerクラスに由来して、アノテーションに特有のオブジェクトに対処するために、追加の機能性を提供します。単位を考慮し、変換したオブジェクトでは元のオブジェクトと同じ単位を使います。イベントは、アプリケーションを適応させるために、以下のイベントを使います: アノテーションオブジェクト名を使用することができるアノテーションオブジェクト名は、コンテナで複数のオブジェクトを区別します。LEADTOOLSは任意の特別な方法でオブジェクト名を使用しません、そして、値は特別な意味を持っていません。使っているアノテーションオブジェクト名に関する情報については、「アノテーションオブジェクト名」を参照してください。アノテーションインターフェースLEADTOOLSは、オートメーションモードでいろいろなアノテーションオブジェクトの用途に、いくつかのインターフェースを提供します。オートメーションモードでは、アノテーションオブジェクトのために、適切なタブで、アノテーションフレームワークは、ダイアログを示すために、適切なインターフェースを使用します。IAnnPictureObjectインターフェースは、このインターフェースを実装するそれらのクラスから、アノテーションオブジェクトにより用いられる標準的なピクチャプロパティをサポートします。IAnnPrimarySecondaryPictureObjectインターフェースは、このインターフェースを実装するそれらのクラスから、アノテーションオブジェクトにより用いられる標準的な一次および二次ピクチャプロパティをサポートします。IAnnProtractorObjectインターフェースは、分度器を描画するために、アノテーションフレームワークにより用いられます。分度器アノテーションオブジェクトは、角度を作成するためにポイントで連結される2つのルーラーから構成されます。IAnnRulerObjectインターフェースは、ルーラーを描画するために、アノテーションフレームワークにより用いられます。IAnnTextObjectインターフェースは、テキスト文字列を描画するために、アノテーションフレームワークにより用いられます。ユーザーインターフェース、自動モードでユーザーインターフェースを通して使われるデフォルトのテキスト文字列に関する情報のためのオートメーションMode、オーバーライドする方法に関する情報を含むことは、LEADTOOLS for .NETアノテーションオートメーションのローカライゼーションに言及します。以下のメソッドとプロパティは、Windowsクリップボード操作をサポートします: 以下のメソッドは、アノテーションオブジェクトを集めるか、グループ解除させました: AnnNewGroupEditDesignerクラスは、AnnRectangleEditDesignerクラスを拡張し、アノテーションコンテナ上でAnnGroupObjectアノテーションオブジェクトを編集する機能を提供します。このクラスは、AnnGroupEditDesignerクラスにおけるサイズ変更と回転機能を改善しています。グループ化とグループ解除の詳細については、「アノテーションオブジェクトのグループ化とグループ解除」を参照してください。LEADTOOLSアノテーション機能は、アノテーションオートメーション操作を元に戻すために、Undoエンジンを含みます。AnnAutomation.UndoCapacityプロパティは、取り消すことができる操作の数を指定します。デフォルトのアクション数は10です。LEADTOOLSは、非自動操作において取り消し機能を扱うメソッドやプロパティを数多く提供します。詳細については、「アンドゥオートメーション操作」を参照してください。現在のユーザモードを取得または設定するには、UserModeプロパティを使います。AnnUserMode.Designは、オブジェクトを作成するためにあります;AnnUserMode.Runモードは、表示するためにあります。ユーザモードをRunに切り替えると、自動ToolBarが自動的に非表示になります。ユーザモードをDesignに設定すると、ToolBarが表示されます。UserModeプロパティが変更されるときはいつでも、UserModeChangedイベントは発生されます。以下のプロパティとメソッドで、オートメーションモードで使用するインターフェースを作成してカスタマイズできます。 オートメーション化したアノテーションプログラムを作成することのチュートリアルのために、自動アノテーションの操作を参照します。LEADTOOS DICOMアノテーションに関する情報については、「DICOMアノテーションの操作」を参照してください。

トピック

アノテーションファイル
アノテーションファイルフォーマット
WPFアノテーション
アノテーションオブジェクト
オートメーション
ルーラーアノテーションObjectsを較正すること
固定アノテーション
アノテーションオブジェクトのグループ化とグループ解除
アノテーションのためのブラシスタイルの説明
アノテーションのためのペンスタイルの説明
アノテーションハイパーリンクの実装
アノテーションセキュリティ の実装
LEADTOOLSアノテーションによるユーザー定義オブジェクトの実装
アノテーションのための低レベルの座標系
バージョン14.5の新しいアノテーション機能
アノテーションのためのポリゴンフィルModeの説明
アノテーションデフォルトを設定すること
アンドゥオートメーション操作
© 1991-2016のLEAD Technologies, Inc. All Rights Reserved.