スクリプト機能のユーティリティオブジェクトです。
メソッド名 | 機能 |
|---|---|
calcLength | 指定文字列の文字数をエミュレータ換算で取得 |
truncate | 指定文字列を指定された文字数(エミュレータ換算)で切り詰めて取得 |
指定文字列の文字数をエミュレータ換算で取得
指定された文字列の文字数をエミュレータ換算で取得します。
●呼び出し形式
calcLength(text)
●パラメータ
パラメータ | 説明 | 省略時の初期値 |
|---|---|---|
text | エミュレータ換算で文字数を取得する文字列を指定 | 省略できません |
●エミュレータ換算
文字 | 換算方法 |
|---|---|
半角文字 | 半角1文字を、1文字として換算します |
全角文字 | 全角1文字を、2文字として換算します |
リモートフォント | コード値を、2文字として換算します |
特殊キー | 特殊キーは文字として換算しません |
[[ | 2文字を、1文字として換算します |
●リターン値
関数の呼び出しに成功すると指定された文字列をエミュレータ換算した文字数を返します。エラーが発生した場合は-1を返します。
●JavaScriptを用いて記述した例
var dspemu = new WsmgrDspemu(); // インスタンスの作成
// 半角文字
dspemu.util.calcLength('123ABC'); // 文字数：6
// 全角文字
dspemu.util.calcLength('担当'); // 文字数：4
// リモートフォント
dspemu.util.calcLength('[80A1]'); // 文字数：2
// 特殊キー
dspemu.util.calcLength('[ENTER]');// 文字数：0
// [[
dspemu.util.calcLength('[['); // 文字数：1指定文字列を指定文字数で切り詰めて取得
指定された文字列の指定された文字数(エミュレータ換算)で切り詰めて取得します。
●呼び出し形式
truncate(text, length)
●パラメータ
パラメータ | 説明 | 省略時の初期値 |
|---|---|---|
text | エミュレータ換算で切り詰めする文字列を指定 エミュレータ換算についてはcalcLengthを参照 | 省略できません |
length | 切り詰め文字数を指定(1～) | 省略できません |
●リターン値
関数の呼び出しに成功すると指定された文字数で切り詰めた文字列を返します。エラーが発生した場合はnullを返します。
●JavaScriptを用いて記述した例
var dspemu = new WsmgrDspemu(); // インスタンスの作成
dspemu.util.truncate('担当123', 4); // 文字列：担当
dspemu.util.truncate('[80A1] ', 2); // 文字列：[80A1]
dspemu.util.truncate('1[ENTER]', 2); // 文字列：1[ENTER]
dspemu.util.truncate('[[', 1); // 文字列：[[
状態監視リクエストの停止
クライアントからサーバへの状態監視リクエストを停止します。
●呼び出し形式
suspendRequest([msec])
●パラメータ
パラメータ | 説明 | 省略時 |
|---|---|---|
msec | 指定された時間が経過すると状態監視リクエストを自動的に開始します。 | 状態監視リクエストの停止 |
注意
クライアントからの状態監視リクエストを停止した場合、サーバから通知される画面、回線切断などの通知を受信することが出来なくなります。
●リターン値
関数の呼び出しに成功するとtrueを返します。エラーが発生した場合はfalseを返します。
●JavaScriptを用いて記述した例
// ユーザHTMLのボタンクリック時の処理
function onButtonClick() {
// id属性 image1 の src属性を変更し画像イメージを更新
parent.dspemu.util.suspendRequest(100); // 状態監視リクエストの一時停止(100ミリ秒)
var element = document.getElementById('image1');
element.setAttribute('src', '/wsmgrweb/userconfig/img/image1.png');
}
状態監視リクエストの再開
状態監視リクエストを再開します。
●呼び出し形式
resumeRequest()
●パラメータ
ありません
●リターン値
関数の呼び出しに成功するとtrueを返します。エラーが発生した場合はfalseを返します。
●JavaScriptを用いて記述した例
// ユーザHTMLのボタンクリック時の処理
function onButtonClick() {
// id属性 image1 の src属性を変更し画像イメージを更新
parent.dspemu.util.suspendRequest(); // 状態監視リクエストの停止
var element = document.getElementById('image1');
element.onload = function () {
// イメージロード完了時のイベントで状態監視リクエストを開始
parent.dspemu.util.resumeRequest();
}
element.setAttribute('src', '/wsmgrweb/userconfig/img/image1.png');
}