OpenForm

<< Click to Display Table of Contents >>

マニュアル > コントロールリファレンス > 基本 > ビューコントロール > メソッド >

OpenForm


 

ビューコントロールで表示している基本フォームを切り替える。

 


構文1

OpenForm(

         basedFormName

         [,systemParam]

         [,openParam]

         )

 


パラメータ

basedFormName


型:

文字


基本フォーム名。ビューに埋め込むフォームの名前です。基本フォームを元にビューが作成されます。

 

systemParam

 

型:

汎用

 

システムパラメータ。1要素は"パラメータ名:値"とする。複数要素を指定する場合は c("パラメータ名1:値1","パラメータ名2:値2",...) のように配列で指定する。尚、本パラメータはマップ値には対応していません。

 

パラメータ

デフォルト値

説明

formName

""

フォーム表示後のフォーム名を文字で指定します。スクリプトから参照するための新たなフォーム名となります。省略するとbasedFormNameで指定した名前が採用されます。現在表示されているフォーム名と重複させてはなりません。

stretch

""

ビューコントロールの大きさに合わせてフォームの大きさを広げる。

 

NONE

ストレッチしない。

STRETCH_FULL

ビューコントロールの大きさに合わせて引き伸ばし表示する。

STRETCH_KEEPRATE

ビューコントロールの大きさに合わせて引き伸ばし表示する(縦横比保持)。

RESIZE_FULL

ビューコントロールの大きさに合わせてフォームサイズを調整する。

RESIZE_KEEPRATE

ビューコントロールの大きさに合わせてフォームサイズを調整する(縦横比保持)。

FORM

フォームのStrechプロパティの設定に合わせる。

 

※本引数を指定しない、あるいは空文字を指定した場合は、ビューコントロールのStrechプロパティの設定が採用されます。

 

※STRETCH_XXXとRESIZE_XXXの違いについて

STRETCH_XXXの場合、画面を広げたときにフォームのサイズ(Width/Heightプロパティ)はそのままで、拡大縮小比率を自動調整することにより引き伸ばし表示しています。そのため、絵や文字すべてが拡大縮小されます。一方、RESIZE_XXXの場合、拡大縮小比率は100%のまま固定で、フォームの実際のサイズ(Width/Heightプロパティ)を自動調整します。そのため、コントロールや文字のサイズはそのまま維持します。画面を広げたときに画面上のコントロール位置やサイズを自動的に調整したい場合は、各コントロールのAutoResizeX/AutoResizeYプロパティを設定します。例えばAutoResizeXに"RIGHT"を指定すると、画面を広げた際、コントロールの位置が右辺に追従して自動的に移動します。

 

visualTheme

""

ビジュアルテーマ名を文字で指定します。

 

 

例)1要素のみの場合

this.OpenForm("Form01","formName:frmForm01");

 

例)複数要素の場合

this.OpenForm("Form01",c("formName:frmForm01","stretch:RESIZE_FULL"));

 

 

openParam

 

型:

汎用

 

オープンパラメータ。1要素は"パラメータ名:値"とする。配列で指定する場合は c("パラメータ名1:値1","パラメータ名2:値2",...) のように指定する。MAPルートメソッドによって生成したマップ値を渡すことも可能。

オープンパラメータで渡した情報は、呼出し先フォームのスクリプトからGetOpenParamメソッドで取得することができる。

 

戻り値



型:

ブール


FALSE - 失敗。TRUE - 成功。

 


hmtoggle_plus1 解説

 

 


構文2

OpenForm(

         basedFormName

         [,formName]

         [,stretch]

         [,openParam]

         )

 


パラメータ

basedFormName


型:

文字


基本フォーム名。ビューに埋め込むフォームの名前です。基本フォームを元にビューが作成されます。

 

formName


型:

文字


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

 

stretch

 

型:

文字

 

ビューコントロールの大きさに合わせてフォームの大きさを広げる。

 

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

"STRETCH_FULL" - ビューコントロールの大きさに合わせて引き伸ばし表示する

"STRETCH_KEEPRATE" - ビューコントロールの大きさに合わせて引き伸ばし表示する(縦横比保持)

"RESIZE_FULL" - ビューコントロールの大きさに合わせてフォームサイズを調整する

"RESIZE_KEEPRATE" - ビューコントロールの大きさに合わせてフォームサイズを調整する(縦横比保持)

FORM:フォームのStrechプロパティの設定に合わせる

 

※本引数を指定しない、あるいは空文字を指定した場合は、ビューコントロールのStrechプロパティの設定が採用されます。

 

※STRETCH_XXXとRESIZE_XXXの違いについて

STRETCH_XXXの場合、画面を広げたときにフォームのサイズ(Width/Heightプロパティ)はそのままで、拡大縮小比率を自動調整することにより引き伸ばし表示しています。そのため、絵や文字すべてが拡大縮小されます。一方、RESIZE_XXXの場合、拡大縮小比率は100%のまま固定で、フォームの実際のサイズ(Width/Heightプロパティ)を自動調整します。そのため、コントロールや文字のサイズはそのまま維持します。画面を広げたときに画面上のコントロール位置やサイズを自動的に調整したい場合は、各コントロールのAutoResizeX/AutoResizeYプロパティを設定します。例えばAutoResizeXに"RIGHT"を指定すると、画面を広げた際、コントロールの位置が右辺に追従して自動的に移動します。

 

openParam

 

型:

汎用

 

オープンパラメータ。1要素は"パラメータ名:値"とする。配列で指定する場合は c("パラメータ名1:値1","パラメータ名2:値2",...) のように指定する。MAPルートメソッドによって生成したマップ値を渡すことも可能。

オープンパラメータで渡した情報は、呼出し先フォームのスクリプトからGetOpenParamメソッドで取得することができる。

 

戻り値



型:

ブール


FALSE - 失敗。TRUE - 成功。

 


hmtoggle_plus1 解説

 


参照