独自の名前付きプロパティー・クラスを作成するのは簡単で、次の 3 つの手順に従います。

次のセクションでは、2 つの値を格納する非常に簡単な例を使用して、グラフィック・オブジェクトと関連付けられる名前付きプロパティーの作成方法を説明します。ただし、メンバー関数を使用して名前付きプロパティーを作成してより複雑なデータ・メンバーを処理したり、既存クラスへのポインターを格納する名前付きプロパティーを作ったりすることもできます。名前付きプロパティーを使用すると、必要最小限のコーディングで、アプリケーション・クラスの API を変更することなく、複雑なアプリケーション・データを軽量なグラフィック・オブジェクトにリンクできます。

ここでは整数と文字列の両方を含む名前付きプロパティーを作成し、それを簡単にアクセス可能にし、永続性を持たせます。

一般的な操作は次のとおりです。

ここで作成する名前付きプロパティーは、IlvNamedProperty のサブクラスである必要があります。名前付きプロパティーは整数と文字列を格納します。完全なヘッダー・ファイルは以下のとおりです。

2 つのデータ・メンバー _integer と _string (およびそのアクセサー) の他に、_Symbol スタティック・データ・メンバーおよびクラスの宣言部分に表示される
2 つのマクロ DeclarePropertyInfo と DeclarePropertyIOConstructors に焦点を当てます。

クラスのデストラクターは、IlvNamedProperty ベース・クラスの 1 つと同様、仮想のものです。

まず、このクラスへのアクセスに使用するシンボルを定義します。このシンボルを簡単に定義するには、シンボルをプロパティー・クラス _Symbol のスタティック・データ・メンバーにし、パブリック・アクセサー GetSymbol を提供します。これにより、インスタンスとオブジェクトの関連付けに使用するシンボルを認識する必要なく、どのアプリケーションでも MyProperty のインスタンスでも取得できるようになります。

パブリックおよびスタティック・アクセサーの GetSymbol は、適切な IlSymbol を返し、必要に応じてそれを作成するように定義付けられます。

下記のコードは実装ファイルからの抽出であり、プロパティー・シンボルのアクセサーと 0 に初期化するスタティック・データ・メンバーの両方を定義します。シンボルは MyProperty::GetSymbol で最初に問い合わせを行うときに作成されます。

ここでは、コンストラクターとデストラクターを扱います。ここで必要なのは、親クラスである IlvNamedProperty のコンストラクターを呼び出し、データ・メンバーを初期化することです。

最初に MyProperty タイプのプロパティーを作成する際に、スタティック・メンバー関数である GetSymbol が呼び出され、スタティック・データ・メンバー _Symbol を有効値に設定します。

setString メンバー関数によって string パラメーターがコピーされ、_string データ・メンバーが有効であるかどうかチェックされます。このために、このデータ・メンバーをコンストラクターの初期化指定子で 0 に初期化することが必要です。このパラメーターは、有効である場合、デストラクターによって破壊されます。

下記は文字列をコピー、格納する setString メンバー関数の定義です。

このコードは非常に簡単です。有効な文字列、つまり非ヌル文字列が格納された場合、文字列は破壊されます。パラメーターが有効、つまり非ヌルの場合、この文字列がコピーされ、格納されます。パラメーターが有効でない場合、データ・メンバーは単に 0 にリセットされます。

この段階で、この例のクラスは整数と文字列値の両方を格納、取得できます。

この例で名前付きプロパティーを完成させるには、クラス・レベルの情報と永続性に関連するメンバー関数を追加する必要があります。これをもっとも簡単に行うには、次の 2 つのマクロをクラス宣言の本文に使用します。

これらのマクロにより、クラスにコピー機能および永続性機能を非常に簡単に追加できます。

メンバー関数を宣言したら、コピーおよび永続性機能をクラスに追加するために、コピー・コンストラクターとパラメーターとして IlvInputFile を参照するコンストラクターを定義します。

最初のコンストラクターはそのソース・パラメーターのコピーで MyProperty の新しいインスタンスを初期化します。

2 つ目のコンストラクターは、提供された入力ストリームを読み込んで、そのインスタンスを読み込まれたもので初期化します。

これでクラスの新しいインスタンスを読み込み、保存できます。このためには、write メンバー関数を定義します。これは暗示的に DeclarePropertyInfo マクロで宣言されます。

保存順は読み込み順と同じになります。

保存する追加情報がない名前付きプロパティーを定義する場合もあります。この場合は、クラス宣言で DeclarePropertyInfo ではなく DeclarePropertyInfoRO マクロを使用して、無効になる write メンバー関数を削除します。

Rogue Wave Views に読み込みおよびコピー・コンストラクターへのエントリー・ポイントを提供するには、別のマクロを実装ファイルに追加する必要があります。これは次のように、関数の本文外で行います。

このマクロを呼び出すと実際に、読み込みコンストラクターを呼び出す read スタティック・メンバー関数が作成されます。これはまた、コピー・コンストラクターを呼び出す copy メンバー関数の定義も行います。

名前付きプロパティーをアプリケーションで実行する最終手順として、以下のように MyProperty クラスを Rogue Wave Views に登録します。

IlvRegisterPropertyClass マクロの呼び出しにより、MyProperty クラスを Rogue Wave Views の永続性メカニズムに登録します。

これでこの新しい名前付きプロパティーを、関連付けられるあらゆるグラフィック・オブジェクトの拡張として使用できます。

グラフィック・オブジェクトの API が、ベース・クラスをサブクラス化をすることなく永続的に拡張されました。