一般的には、Rogue Wave® Views Studio でプロトタイプを作成し、これらをアプリケーションで使用します。以下のセクションでは、アプリケーションにプロトタイプを追加するために使用する C++ API と、これらのプロトタイプの操作方法を説明します。

このセクションでは、次の項目を説明します。

アプリケーションが必要なライブラリー・パッケージにリンクされていることを確認するために、まずグラフィック・オブジェクト、アクセサー (IlvUserAccessor のサブクラス)、および読み込もうとするプロトタイプで使用されるインタラクターに対応するヘッダー・ファイルを含めなくてはなりません。

すべての定義済みアクセサー・クラスを含めるには、ヘッダー・ファイル <ILVHOME>/include/ilviews/protos/allaccs.h を使用します。

次は、あらゆるタイプのグラフィック・オブジェクトを含むプロトタイプを読み込むことのできるアプリケーションを構築するために含めるヘッダー・ファイルの典型的なセットです。

以下のヘッダー・ファイルを追加することもできます。

使用するプロトタイプが前もってわかっている場合、allaccs.h、graphics.h、および gadgets.h の代わりに必要なヘッダー・ファイルのみを含めることで、アプリケーションのサイズを小さくすることができます。

プロトタイプ・パッケージを使用するアプリケーションをコンパイルするには、これらをライブラリー ilvproto でコンパイルする必要があります。このライブラリーも、以下のライブラリーを必要とします。ilvgrapher、ilvmgr、および使用プラットフォーム別の標準 Rogue Wave Views ライブラリー。ilvgdpro ライブラリーは、プロトタイプの古い機能を使用するアプリケーションで必要となる場合があります。

プロトタイプ・インスタンスを含む.ilv ファイルを読み込むには、read、または IlvManager、あるいは IlvContainer の readFile メソッドを使用します。

ファイルで使用されるすべてのファイルは、それらのプロトタイプ・ライブラリーから自動的に読み込まれます。プロトタイプ・ライブラリーは、表示パスを使用してファイル・システム内で検索されます。たとえば、パネルが /usr/home/yourdir/protolibs/mylib.ipl にある mylib と呼ばれるプロトタイプ・ライブラリーからのプロトタイプを含む場合、/usr/home/yourdir/protolibs/ を ILVPATH 環境変数に含める必要があります。

コンテナーあるいはマネージャー内でグループの処理を可能にするために、IlvGroupHolder クラスがすべての必要なインターフェースを提供します。IlvGroupHolder クラスのインスタンスは、自動的にコンテナーあるいはプロトタイプ・インスタンスを含むマネージャーに付加されます。このクラスは、グループ (その結果としてプロトタイプ・インスタンスも) の追加、削除、取得のメソッドを提供します。コンテナー、マネージャーあるいはグラフィック・ホルダーを、次の汎用メソッドで取得することができます。

コーディングによってプロトタイプのインスタンスを作成する場合があります。プロトタイプのインスタンスを作成するには、まずこれらを読む込みます。プロトタイプ・ライブラリー全体を読む込んだ後、それが含む 1 つ以上のプロトタイプを読み込みます。これを行うには、IlvProtoLibrary クラスのインスタンスを作成し、その load メソッドを呼び出します。

表示パスにないプロトタイプ・ライブラリーを読み込みたい場合は、コンストラクターを呼び出してライブラリーが位置するディレクトリーを指定することができます。

プロトタイプ・ライブラリーを読み込むと、そのすべてのプロトタイプあるいは特殊プロトタイプを次のメソッドで取得することができます。

または

getPrototypes メソッドで返された配列は、new[] 演算子で割り当て、必要がなくなったときは delete[] 演算子で削除します。

代わりに、各プロトタイプを個別にグローバル関数 IlvLoadPrototype で読み込むこともできます。

最初の引数は、プロトタイプ・ライブラリーの名前およびプロトタイプの名前 (ピリオドで分けられている) を指定します。2 番目の引数は、アプリケーションが作成した IlvDisplay インスタンスです。プロトタイプ・ライブラリー・ファイルおよびプロトタイプ・ファイルは、表示パスを使用してファイル・システムの内で検索されます。

プロトタイプのインスタンスを作成するには、メソッドclone を使用します。

clone メソッドの引数は、新しいインスタンスの名前です。0 を渡すことができます。これで、名前が自動的に生成されます。

IlvGroupHolder クラスのインスタンスは、自動的にコンテナーあるいはプロトタイプ・インスタンスを含むマネージャーに付加されます。このクラスは、グループ (その結果としてプロトタイプ・インスタンスも) の追加、削除、取得のメソッドを提供します。

新しいプロトタイプ・インスタンスをマネージャーあるいはコンテナーに追加するには、マネージャー/コンテナー・クラスに付加されている IlvGroupHolder の addGroup メソッドを使用することができます。

代わりに IlvProtoGraphic オブジェクトを作成し、直接これをマネージャーに配置できます。

プロトタイプ・インスタンスをマネージャーあるいはコンテナーに追加したときに、プロトタイプ・インスタンスの位置を設定することがよくあります。この場合は、次の手順に従います。

プロトタイプ・インスタンスをそのコンテナーあるいはマネージャーから削除するには、IlvGroupHolder クラスの removeGroup メソッドを使用します。

埋め込まれた IlvProtoGraphic を、コンテナーあるいはマネージャーから削除することもできます。

プロトタイプ・インスタンスを完全に削除するには、delete 演算子を呼び出します。カプセル化する protoGraphic を削除することもできます。

マネージャーあるいはコンテナーに含まれるすべてのグループを取得するには、付加されているグループ・ホルダーの getGroups メソッドを使用します。

グループをその名前で取得するには、getGroup メソッドを使用します。

このメソッドは指定したグループが存在しない場合、0 を返します。

プロトタイプ・インスタンスは、API に基づいて名付けられた同一のアトリビュート (プロパティーあるいはアクセサーとも呼ばれる) を通じて操作されます。この API は、クラス IlvGraphic から提供されるものと同じで、基本的に IlvGraphic::changeValue および IlvGraphic::queryValue メソッドから構成されています。

名前の付いているアトリビュートは、IlvValue クラスのインスタンスによって表示され、下記によって定義されています。

値のタイプは、IlvValue クラスによって自動的に設定されます。定義済みタイプの値を初期化するためにコンストラクターを使用します (IlInt、const char*、IlvColor* など)。代入演算子 = を使用するか、定義済みタイプへ IlvValue をキャストさせて、値を変更することもできます。IlvValue クラスは、すべての変換を自動的に処理します。詳細は、IlvValue クラスを参照してください。

プロトタイプ・インスタンスに値を設定するには、IlvValue を作成し、IlvGraphic::changeValue メソッドを呼び出します。

値を変更するときに毎回新しい IlvValue を作成する必要はありません。既存の IlvValue を使用して、このデータを代入演算子で変更することができます。

1 回の呼び出しで複数の値を設定することができます。これを行うには、IlvValue オブジェクトの配列を作成して初期化し、changeValues メソッドを呼び出します。次の例は、1 回の呼び出しでオブジェクトの位置を設定する方法を表しています。

値を取得するには、queryValue メソッドを使用します。

queryValue メソッドは、パラメーターとして IlvValue リファレンスを取ります。IlvValue は取得する値の名前で初期化する必要があります。queryValue メソッドは取得した値をその引数に保存し、そのリファレンスを返します。例では、queryValue の結果を整数変数 x に代入することで、IlInt キャスト演算子への IlvValue を呼び出します。

1 回の呼び出しで複数の値を取得するには、IlvValue オブジェクトの配列を作成し、queryValues メソッドを呼び出します。

IlvValue クラスは、必要に応じて値を自動的に変換します。つまり、設定、あるいは取得する値のタイプを正確に知っている必要はありません。たとえば、オブジェクトの位置を、下記のように文字列値を使用して設定することができます。

逆に言えば、値を取得するとき、次のようにして必要なタイプに変換することができます。

プロトタイプおよびそのインスタンスには、3 種類のアトリビュート、ユーザー定義アトリビュート、定義済みアトリビュート、およびサブ・アトリビュートがあります。

ユーザー定義アトリビュートは、Rogue Wave Views Studio でデザインしたときにプロトタイプに付加したアクセサーによって定義されるアトリビュートです。これらはプロトタイプによって異なります。ユーザー定義アトリビュートの設定あるいは取得の効果は、これを構成するアクセサー・オブジェクトによって決定されます。

たとえば、温度計を表すプロトタイプを作成したとします。temperature アトリビュートを、温度を計器の value アトリビュートにマッピングするリファレンス・アクセサーを追加して定義します。プロトタイプのインスタンスによって表示されている温度を変更するには、次のようにchangeValue メソッドを使用します。

グループの定義済みアトリビュートにより、すべてのプロパティーが持つ位置、サイズ、可視性などの共通プロパティーを変更したり取得することができます。

ほとんどの定義済みアトリビュートは、グループがマネージャーあるいはコンテナーに追加されたときにのみ有効になりますが、それよりも前に設定しておくことができます。これらはグラフィック・ノードに保存されますが、グループが追加されたときにのみ有効になります。

定義済みアトリビュートを、Table 4.2に一覧表示します。

プロトタイプのサブ・アトリビュートにより、プロトタイプに含まれているオブジェクトのアトリビュートに直接アクセスできます。サブ・アトリビュートの名前は、オブジェクトのパスとアトリビュート名を連結して作成します。サブ・アトリビュート名のコンポーネントは、ピリオドで分けられています。たとえば、プロトタイプが title と名付けられた IlvLabel を含む場合、そのラベルをアトリビュート名 title.label で設定あるいは取得できます。

Table 4.2に一覧表示されている定義済みのプロパティーすべては、特殊グラフィック・ノード用にアクセスすることができます。