OpenDialog

<< Click to Display Table of Contents >>

マニュアル > コントロールリファレンス > 全コントロール共通 > 共通メソッド >

OpenDialog


 

フォームをダイアログとして開く。

 


構文

OpenDialog(

         ViewName,

         BasedFormName,

         [,FormName]

         [,Title = ""]

         [,Left = -1]

         [,Top = -1]

         [,Width = -1]

         [,Height = -1]

         [,Stretch = "default"]

         [,DialogType = 0]

         [,Resizable = FALSE]

         [,BasePosX = "default"]

         [,BasePosY = "default"]

         [,OpenParam]

         )

 


パラメータ

 

ViewName

 

型:

文字

 

ビュー名(任意の名前)。詳細はオブジェクト名/フォーム名/ビュー名を参照ください。空文字を指定すると、 BasedFormName名で指定した名前がビュー名となります。

 

BasedFormName

 

型:

文字

 

ダイアログとして表示したい元フォームのフォーム名を指定します。このフォームを元にダイアログが表示されます。

 

FormName

 

型:

文字

 

埋め込み後のフォーム名(任意の名前)。スクリプトから参照するための新たなフォーム名を指定します。省略するとBasedFormName名で指定した名前がスクリプトから参照するためのフォーム名となります。このフォーム名と、メインフォーム、開かれているダイアログのフォーム名は重複させてはなりません。

 

Title

 

型:

文字

 

ダイアログのタイトル。

 

Left

 

型:

数値

 

ダイアログの左座標。-1を指定すると中央に表示されます。座標の基準となる位置はBasePosX引数で指定します。(デフォルトはブラウザの左端が0。)

 

Top

 

型:

数値

 

ダイアログの上座標。-1を指定すると中央に表示されます。座標の基準となる位置はBasePosY引数で指定します。(デフォルトはブラウザの上端が0。)

 

Width

 

型:

数値

 

ダイアログの幅。-1を指定するとフォームの幅がダイアログの幅になります。

 

Height

 

型:

数値

 

ダイアログの高さ。-1を指定するとフォームの高さがダイアログの高さになります。

 

Stretch

 

型:

文字

 

ダイアログの大きさに合わせてフォームの大きさを広げる。

"NONE" - ストレッチしない

"STRETCH_FULL" - ダイアログの大きさに合わせて引き伸ばし表示する

"STRETCH_KEEPRATE" - ダイアログの大きさに合わせて引き伸ばし表示する(縦横比保持)

"RESIZE_FULL" - ダイアログの大きさに合わせてフォームサイズを調整する

"RESIZE_KEEPRATE" - ダイアログの大きさに合わせてフォームサイズを調整する(縦横比保持)

"FORM" - フォームの設定に合わせる

"DEFAULT" - デフォルト値(メインビューのStretch状態)と同じ。

 

DialogType

 

型:

数値

 

ダイアログのタイプ。

0-通常(閉じるボタンあり)

1-シンプル(閉じるボタンなし)

2-フレームなし(タイトルバーなし)

3-フル(最大化、最小化、閉じるボタンあり)

「1-シンプル」の場合、ダイアログを閉じるために、

::CloseDialogを呼び出す必要があります。

 

Resizable

 

型:

ブール

 

サイズを変更可能とするか。指定しないとサイズ変更が不可能になります。

 

BasePosX

 

型:

文字

 

基準となるX方向の位置。

"default" - DialogBasePosXルートプロパティに従う

"browser" - ブラウザの左端が0。

"parent" - 親画面(ダイアログも含む)の左端が0。

"desktop" - デスクトップの左端が0。

 

BasePosY

 

型:

文字

 

基準となるY方向の位置。

"default" - DialogBasePosYルートプロパティに従う

"browser" - ブラウザの上端が0。

"parent" - 親画面(ダイアログも含む)の上端が0。

"desktop" - デスクトップの上端が0。

 

OpenParam

 

型:

文字

 

オープンパラメータ。1要素は"パラメータ名:値"とする。配列指定の場合は c("パラメータ名1:値1","パラメータ名2:値2",...) のように指定する。

 

戻り値

 

 

型:

ブール

 

FALSE - 失敗。TRUE - 成功。

 


hmtoggle_plus1 解説

 

hmtoggle_plus1

 

hint

ダイアログ関連のメソッドは共通メソッドとして提供されています。

例えば、「this.OpenDialog (...)」のようにフォームのメソッドとして実行することも、「::OpenDialog(...)」のようにルートのメソッドとして実行することもできます。

いずれの呼び出し方でもダイアログはフォームの裏には隠れませんが、複数のダイアログを同時に表示した場合、両者には階層表示の動作に違いがあります。

 

■フォームのメソッドとして実行した場合

表示されたダイアログは呼び出し元のオブジェクトよりも必ず前面になるように表示されます(呼び出し元の裏に隠れない)。

つまり、表示されたダイアログのフォームから「this.OpenDialog (...)」のように、更に別のダイアログを表示すると、後に表示したダイアログは先に表示したダイアログより前面に表示され、呼び出し元のダイアログをクリックしたとしても、裏に隠れません。

 

■ルートのメソッドとして実行した場合

前述に対し、ルートのメソッド(「::OpenDialog(...)」)として複数のダイアログを表示させた場合には、各ダイアログは同一の階層にあるものとして位置付けられるため、オペレータは複数のダイアログをマウスで自由に前後できるようになります。

 

hint

ダイアログを開くとき、ダイアログを閉じるまで背面の画面を触れないようにしたい場合があります。そのような場合は、ダイアログをモーダル(最前面表示)として表示することで対応できます。モーダル表示では、最前面に表示されウィンドウの操作や前面/背面移動も不可になります。ダイアログをモーダル表示にする方法としては、本メソッドではなく、「OpenModalDialog」メソッドでダイアログ表示を行う方法と、本メソッドの呼び出し後にルートの「SetModalDialog」メソッドを呼び出してダイアログの表示後にモーダル表示に切り替える方法があります。SetModalDialogを呼び出す場合は、OpenDialogの直後に呼び出すようにしてください。

その他、ダイアログを閉じずに、可視状態のみを変更したい場合(表示/非表示のみを切り替えたい場合)は、ルートのShowDialogメソッドを利用してください。

 

 


サポート対象


×

スクリプトアクション

ブラウザスクリプト

×

演算式構文

 


参照