23.5 WsmgrWindowリファレンス

エミュレータ画面上にユーザが作成したHTMLページを表示するための設定を行うためのオブジェクトです。ユーザHTMLを表示するには、viewオブジェクトのloadメソッドに指定する必要があります。

注意

本オブジェクトは、エミュレータと同一ウィンドウで利用してください。

■WsmgrWindow

エミュレータ画面上にユーザHTMLを表示するための情報を設定します。

●オブジェクト生成方法

new WsmgrWindow(url)

●パラメータ

パラメータ	説明	省略時の初期値
Url	ユーザHTMLのURLを指定絶対パス指定以外の場合、サーバのuserconfigフォルダ配下を参照します。	省略できません

●リターン値

関数呼び出しに成功するとWsmgrWindowオブジェクトを返します。エラーの場合は、例外をスローします。

●JavaScriptを用いて記述した例

var window = null;
try {
    window = new WsmgrWindow("user.htm");
} catch(e) {
    // エラー発生時の処理
}

●メソッド一覧

メソッド名	機能
setPosition	ユーザHTMLの表示設定
setSize	ユーザHTMLの表示サイズを指定
setStyle	ユーザHTMLの表示スタイルを指定
setTitle	ユーザHTMLのウィンドウタイトル設定

■setPosition

ユーザHTMLの表示位置設定

ユーザHTMLの表示位置を指定します。

●呼び出し形式

setPosition(left, top, width, height)

●パラメータ

パラメータ	説明	省略時の初期値
top	ウィンドウの左上位置のエミュレータの「行」を指定(1～24)	ウィンドウを中央に表示します
left	ウィンドウの左上位置のエミュレータの「桁」を指定(1～80)	ウィンドウを中央に表示します
width	ウィンドウの幅を「文字」単位で指定(1～)	ウィンドウの幅を変更しません
height	ウィンドウの高さを「文字」単位で指定(1～)	ウィンドウの高さを変更しません

参考

本設定はユーザHTMLの表示スタイルがfloatの場合のみ有効です。表示位置、幅を設定しなかった場合はウィンドウを中央に表示し、幅を自動調整します。

●リターン値

関数呼び出しが成功するとtrueを返します。エラーの場合はfalseを返します。

●JavaScriptを用いて記述した例

var userScreen = new WsmgrWindow("user.htm");
userScreen.setPosition(1, 1, 10, 10);

■setSize

ユーザHTMLの表示サイズを指定

ユーザHTMLの表示サイズを指定します。

●呼び出し形式

setSize(width, height)

●パラメータ

パラメータ	説明	省略時の初期値
width	ウィンドウの幅を「文字」単位で指定(1～)	省略できません
height	ウィンドウの高さを「文字」単位で指定(1～)	省略できません

参考

本設定はユーザHTMLの表示スタイルがfloatの場合のみ有効です。表示サイズの指定を行わなかった場合は自動調整されます。

●リターン値

関数呼び出しが成功するとtrueを返します。エラーの場合はfalseを返します。

●JavaScriptを用いて記述した例

var userScreen = new WsmgrWindow("user.htm");
userScreen.setWidth(10, 10);

■setStyle

ユーザHTMLの表示スタイル指定

ユーザHTMLの表示スタイルを指定します。

●呼び出し形式

setStyle(style)

●パラメータ

パラメータ	説明		省略時の初期値
Style	ユーザHTMLの表示スタイルを文字列で指定		省略できません
	"screen"	エミュレータ画面を非表示にしユーザHTMLを最大化して表示
	"emulator"	エミュレータ画面のホスト画面表示部にユーザHTMLを表示
	"float"	エミュレータ画面上にユーザHTMLを重ねて表示
	"emulator"、"float"を指定する場合はエミュレータのホスト画面サイズに収まるようにユーザHTMLを作成してください

●リターン値

関数呼び出しに成功するとtrueを返します。エラーの場合はfalseを返します。

●JavaScriptを用いて記述した例

var screen = new WsmgrWindow("user.htm");
screen.setStyle("screen");

■setTitle

ユーザHTMLのウィンドウタイトル設定

ユーザHTMLのウィンドウタイトルを設定します。

●呼び出し形式

setTitle(titleName)

●パラメータ

パラメータ	説明	省略時の初期値
titleName	ウィンドウタイトルを文字列で指定	空文字("")

参考

本設定はユーザHTMLの表示スタイルがfloatの場合のみ有効です。

●リターン値

関数呼び出しが成功するとtrueを返します。エラーの場合はfalseを返します。

●JavaScriptを用いて記述した例

var userScreen = new WsmgrWindow("user.htm");
userScreen.setTitle("業務メニュー");