ダイアログのビルド

ユーザ インタフェースをプラグインに提供する標準的な方法は、カスタム プロパティを作成して、そのプロパティ ページをダイアログとして使用することです。

データをプロパティ ページのロジックの一部として操作する場合、ベースとなるカスタム プロパティ セットを作成するか、CustomProperty または CustomProperty オブジェクトを作成する必要があります。このケースは、参照先のデータが実際のシーン データに直接関連付けられておらず、プロパティ ページを閉じた後に削除される場合でも、当てはまります。

1. 次のどちらかの状況が当てはまる場合は、XSILoadPlugin コールバックおよび XSIUnloadPlugin コールバック(「プロパティ コールバック」を参照)を使用して、カスタム プロパティを自己インストール プラグインにします。

   • カスタム プロパティをシーンに保存しようと計画している場合(たとえば、プロパティ ページを閉じた後もデータおよびレイアウトを永続させたい場合)

   • カスタム プロパティを配布しようと計画しているが、知的知識を保護したい場合

2. CustomProperty オブジェクトを作成して Parameter オブジェクトとともに登録します(「カスタム プロパティを定義する」を参照してください)。

3. PPGLayout または PPGLayout オブジェクトを使用して CustomProperty オブジェクトのレイアウトを定義し、必要に応じてコントロールまたはロジックを追加します(「プロパティ ページ コントロール」を参照)。

4. ユーザ フレンドリなプレゼンテーションを実現するには、レイアウト調整が必要な場合もあります(「コントロール属性を設定する」を参照)。 これには以下が含まれます。

   • 個々のコントロール(PPGItem または PPGItem オブジェクト)にいくつかの属性を設定できます。たとえば、コントロール項目に対して設定できるその他の属性としては、特にサイズが挙げられます。

   • 関連するコントロールをグループ化して、列に整列することができます。 たとえば、ビットマップ ウィジット列を左側に作成し、それに対応するテキスト ボックス列を右側に作成することもできます。

   • ラベル付きボックス領域内の関連するコントロールをグループ化することができます。 たとえば、X、Y および Z の位置を表す 3 つの数値コントロールのセットをグループ化することもできます。

   • 関連タブ コントロールを使って情報をいくつかのページに分割し、アクセスを容易にすることができます。

5. ロジックを作成して、PPGLayout オブジェクトに関連付けます(「プロパティ コールバック」を参照)。 ロジックには、プロパティ ページ上でユーザ アクションに応答する関数が含まれています。 ロジック コードは、スクリプティングを使って実装できます。この場合は、 ロジック コードをシーンに直接埋め込むことも、スクリプト ファイルに保存することもできます。 それ以外に、C++ コードを使用して、ロジック コードをライブラリ ファイル(*.dll または *.so)内に実装できます。

6. ヘルプ ページをプロパティ ページに関連づけます(「ヘルプ ファイルのを提供する」を参照してください)。 HTML ファイルにロケーションを設定することができます。 たとえば、カスタマイズ上にヘルプを提供する Web ページへの URL を提供することもできます。