スクリプトで書かれたユーティリティでの複数のロールアウトの管理

MAXScript では、1 つのユーティリティで複数のロールアウトを管理する機能が提供されています。これは 1 つのロールアウトでは扱いにくい大きなスクリプトで書かれたユーティリティなどで有用です。ユーティリティ定義自体に、ユーザインタフェース項目によって定義される 1 つのメインロールアウトがあります。他のロールアウトは、ユーティリティ定義本体の中でネストされたロールアウトとして定義されます。後者のロールアウトは、スクリプトコントロール内の[ユーティリティ](Utilities)パネルに追加したり、パネルから削除したりすることができます。

ユーティリティ定義内の rollout 句で追加ロールアウトを定義します。

utility foo "name"
(
local ...
spinner ...
...
rollout baz "name"
(
local ...
checkbox ..
on ...
)
...
)

ネストされたロールアウトには、ユーティリティ定義に含めることができる、さらに深くネストされたロールアウト以外のすべての定義を含めることができます。ネストされたロールアウトは、親ユーティリティのロールアウトが開いたり閉じたりするときに自動的に開閉するわけでありません。ユーティリティのオープンハンドラおよびクローズハンドラや関数で明示的に開閉する必要があります。

これには 2 つの関数があります。

addRollout <rollout> [ rolledUp:<boolean> ] removeRollout <rollout>

addRollout() 関数の rolledUp: パラメータでは、ロールアップされた状態でロールアウトが追加されるかどうかを指定します。この既定値は false で、ロールアウトは完全に開いた状態で追加されます。追加のロールアウトは、 addRollout() 呼び出し順に整理されるので、呼び出す順番に注意して、希望する順序を確保してください。

ネストされたロールアウトは、メインユーティリティのロールアウトが閉じられたときにも自動的には削除されません。通常、メインユーティリティのクローズハンドラで明示的に削除する必要があります。

メインユーティリティが開かれたり、閉じられるときに、常に追加のロールアウトを開閉するには、メインユーティリティオープンおよびクローズハンドラに addRollout() および removeRollout() 呼び出しを記述します。

例

on foo open do
(
...
addRollout panel_1
addRollout panel_2 rolledUp:true
...
)
on foo close do
(
...
removeRollout panel_1
removeRollout panel_2
...
)

既に閉じられたロールアウトでの removeRollout() 呼び出しは可能ですが、何も実行しません。ユーティリティ開発中にネストしたロールアウトを閉じることを忘れた場合、MAXScript ユーティリティ全体を閉じると、残りの開いているスクリプトで書かれたロールアウトはすべて削除されます。

ロールアウト定義がユーティリティ内でネストされているため、すべてのローカルおよび関数そしてユーティリティ内の他の項目はネストされたロールアウトに対しては可視で、MAXScript 内の標準のネストされたスコープの後に続きます。つまり、ユーティリティのローカル、ユーザインタフェース項目および関数に「リーチアウト」してアクセスします。

逆に、ネストされたロールアウトのユーザインタフェース項目とローカルはそのロールアウトのプロパティとして示されるので、メインユーティリティや他のロールアウト内のコードはその項目およびローカルに｢リーチイン｣して、アクセスできます。次の例では、スピナーの bar 変更ハンドラが、ネストされたロールアウト baz のチェックボックスの状態を参照します。

例

utility foo "name"
(
local ...
local ...
spinner bar ...
...
rollout baz "name"
(
local ...
checkbox baz_enable ...
on ...
)
...
on bar changed val do
if baz.baz_enable.checked == true then...

ロールアウトボディのカッコの前に category:<integer> ヘッダーパラメータを指定すれば、ロールアウトのグループ化をコントロールできます。カテゴリ番号によって、ロールアウトが並べ替えられます。以下の例では、ロールアウトは特定の順番で定義および追加されます。ただし、表示されるときは、そのカテゴリ番号の順番に並べ替えられます。

例

(
rollout first_rollout "1st Rollout" category:2
(
label rights "First"
)
rollout second_rollout "2nd Rollout" category:1
(
label second "Second"
)
rf = newRolloutFloater "Rollout Order Test" 200 140
addRollout first_rollout rf
addRollout second_rollout rf
)

スクリプトで書かれたユーティリティでの複数のロールアウトの管理

関連事項