CreateDialog
 
 
 
 

   

ユーザ インタフェースの作成 - クイック ナビゲーション

CreateDialog 関数を使うと、既存のロールアウト定義をフロータのダイアログに返すことができます。

1 つ以上のロールアウトのコンテナである RolloutFloater を除き、ダイアログはロールアウト自身の特殊な表示形式です。

これは、モーダル表示オプション、バックグラウンド ビットマップ表示およびマウスの各イベント ハンドラといった拡張機能を提供します。

ダイアログ作成の構文は次に示すとおりです。

CreateDialog <Rollout> [<height> <width> <position_x> <position_y>]\ 
[pos:<Point2>] [width:<integer>] [height:<integer>] \ 
[bgcolor:<color>] [fgcolor:<color>] \ 
[bitmap:<bitmap>] {bmpstyle:<bmpstyle> \ 
[menu:<RCMenu>] [style:<array>] [modal:<boolean>] \ 
[escapeEnable:<boolean>] [lockHeight:<boolean>] [lockWidth:<boolean>] 	 

オプションの modal:<boolean> キーワードを true に設定していると、ダイアログ ボックスは、そのダイアログ ボックス内以外のすべてのユーザ インタラクションを無視します。ダイアログ ボックスを閉じる場合は、 DestroyDialog() を呼び出します。通常この関数は、スクリプトを記述された[OK]ボタンに関連付けます。 escapeEnable キーワードが false に設定されているか、または指定されていない場合、ユーザは[Esc]キーを押して、スクリプト モーダル ダイアログ ボックスを閉じることもできます。

オプションの escapeEnable キーワードを true に設定すると、ダイアログ ボックスで MAXSscript エスケープ チェッカが無効になり、「MAXScript Interrupt」のメッセージは表示されません。

オプションの lockHeight キーワードが true の場合、ダイアログ ボックスの高さをインタラクティブに変更することはできません。オプションの lockWidth キーワードが true の場合、ダイアログ ボックスの幅をインタラクティブに変更することはできません。

   

パラメータ

<Rollout>

ダイアログ ボックスの作成元のロールアウト定義。

   

[pos:<Point2>] -- default:dialog will center within MAX. 	 

ダイアログ ボックスの左上隅が画面の左上隅に対応するように配置します。

   

[width:<integer>] -- default:200   

ダイアログ ボックスの幅。

   

[height:<integer>] -- default:dynamic on control extents 

ダイアログ ボックスの高さ。

   

[bgcolor:<color>] -- default:(<system button color>) 

ダイアログ ボックスの背景色。

   

[fgcolor:<color>] -- default:(color 0 0 0) 

ダイアログ ボックスの前景カラー(固定テキスト カラー)

   

[bitmap:<bitmap>] -- default:undefined 

ダイアログ ボックスの背景ビットマップ。

   

[bmpstyle:<key>] -- default:#bmp_center 

背景ビットマップを表示する方法は、

次のいずれかです。

#bmp_center 
#bmp_tile 
#bmp_stretch 

   

[menu:<RCMenu>] -- default:undefined 

ダイアログ ボックスのタイトル バー領域に表示されるメニュー。

   

[style:<array>] -- default:#(#style_titlebar, #style_border, #style_sysmenu) 

スタイル フラグの配列は、次の 1 つまたは複数になります。

#style_border: 2 重境界線を持ち、タイトルのないウィンドウを作成します。

#style_titlebar: タイトル バーを持つダイアログ ボックスを作成します。

#style_toolwindow: ツール ウィンドウを作成します。 このウィンドウにはタイトル バーがあり、浮動ツールバーとして使用できます。ツール ウィンドウには、通常のタイトル バーより小さなタイトル バーがあり、フォントを小さくしてウィンドウのタイトルを表示します。

#style_resizing: ウィンドウのサイズ変更に使用できる太い枠を持つウィンドウを作成します。

#style_minimizebox: 最小化ボタンを持つウィンドウを作成します。

#style_maximizebox: 最大化ボタンを持つウィンドウを作成します。

#style_sysmenu: ウィンドウ メニューがタイトル バーに表示されるウィンドウを作成します。

#style_sunkenedge: ウィンドウが、境界線のエッジがくぼんだ形式の 3D の形状になるように指定します。

注:スタイル キーワード パラメータを指定していない場合は、 #style_titlebar #style_border #style_sysmenu が既定のスタイルとして使用されます。

   

イベント

on <Rollout> open do 

ダイアログ ボックスが開いているときに呼び出されます。

   

on <Rollout> close do  

ダイアログ ボックスが閉じているときに呼び出されます。

   

on <Rollout> moved <Point2> do 

ダイアログ ボックスを移動しているときに呼び出されます。

   

on <Rollout> resized <Point2> do 

ダイアログ ボックスのサイズを変更しているときに呼び出されます。

   

on <Rollout> mousemove <Point2> do 

ダイアログ ボックスのクライアント領域内でマウスを動かしているときに呼び出されます。

   

on <Rollout> lbuttondown <Point2> do 

ダイアログ ボックス内でマウスの左ボタンを押したときに呼び出されます。

   

on <Rollout> lbuttonup <Point2> do 

左のマウス ボタンが解放されたときに呼び出されます。

   

on <Rollout> lbuttondblclk <Point2> do 

ダイアログ ボックス内でマウスの左ボタンをダブルクリックしたときに呼び出されます。

   

on <Rollout> mbuttondown <Point2> do 

ダイアログ ボックス内でマウスの中央ボタンを押したときに呼び出されます。

   

on <Rollout> mbuttonup <Point2> do 

マウスの中央ボタンを離したときに呼び出されます。

   

on <Rollout> mbuttondblclk <Point2> do 

ダイアログ ボックス内でマウスの中央ボタンをダブルクリックしたときに呼び出されます。

   

on <Rollout> rbuttondown <Point2> do 

ダイアログ ボックス内でマウスの右ボタンを押したときに呼び出されます。

   

on <Rollout> rbuttonup <Point2> do 

マウスの右ボタンを離したときに呼び出されます。

   

on <Rollout> rbuttondblclk <Point2> do 

ダイアログ ボックス内でマウスの右ボタンをダブルクリックしたときに呼び出されます。

注:

イベント ハンドラに渡された <Point2> 値は、ダイアログ ボックスのクライアント ウィンドウ内でのマウスの位置です。[0,0] の値は、クライアント ウィンドウの左上隅に対応します。ダイアログ ボックス ウィンドウの左上隅

   

関連するメソッド

<Point2>GetDialogPos <Rollout> 

ロールアウトで作成したダイアログ ボックスの、画面の左上からの相対位置を Point2 形式で返します。

   

SetDialogPos <Rollout> <Point2> 

ロールアウトで作成したダイアログ ボックスの、画面の左上からの相対位置を設定します。

Rollout: ダイアログ ボックスの作成で使用するロールアウト。

Point2: ダイアログ ボックスを配置する位置。

   

<Point2>GetDialogSize <rollout> 

ウィンドウのクライアント領域のサイズを返します。これは point2 <rollout>.width <rollout>.heigh の場合と同じです。

   

SetDialogBitmap <rollout> <bitmap> 

ロールアウトが関連付けられているダイアログ ボックスのバックグラウンドのビットマップを設定します。ロールアウトがダイアログ ボックス内にない場合は、何も行われません。ビットマップの値が「undefined」である場合、現在のビットマップの設定が解除されます。

   

<bitmap>GetDialogBitmap <rollout> 

ロールアウトが関連付けられているダイアログ ボックスのバックグラウンドのビットマップを取得します。ロールアウトがダイアログ ボックス内にない場合は、「undefined」が返されます。

関連事項