メッセージが含まれるユーザー応答ダイアログ・ボックスを表示し、ユーザーに応答を要求します。
構文
public int sendMsg(String msg, int dialogFlags);
パラメーター
- msg
- ユーザー応答ダイアログ・ボックスに表示するメッセージ。
- dialogFlags
- ユーザー応答ダイアログ・ボックスの一部として表示するボタンおよびアイコンを示す一連のフラグ。これらのボタンおよびアイコンは、表 105
に示すユーザー応答ダイアログ定数のマスクとして指定してください。
戻り値
ユーザー応答ダイアログ・ボックスを終了するためにユーザーがクリックしたボタンを示す整数。この整数値を以下のユーザー応答定数と比較してください。
- ODKConstant.ODK_OK
- ユーザーが「OK」ボタンを選択しました。
- ODKConstant.ODK_CANCEL
- ユーザーが「キャンセル」ボタンを選択しました。
- ODKConstant.ODK_RETRY
- ユーザーが「再試行」ボタンを選択しました。
- ODKConstant.ODK_IGNORE
- ユーザーが「無視」ボタンを選択しました。
- ODKConstant.ODK_ABORT
- ユーザーが「中止」ボタンを選択しました。
- ODKConstant.ODK_YES
- ユーザーが「はい」ボタンを選択しました。
- ODKConstant.ODK_NO
- ユーザーが「いいえ」ボタンを選択しました。
- ODKConstant.ODK_CLOSE
- ユーザーが「閉じる」ボタンを選択しました。
- ODKConstant.ODK_HELP
- ユーザーが「ヘルプ」ボタンを選択しました。
注記
sendMsg() メソッドは、ユーザー応答ダイアログ・ボックスがユーザーに表示されるよう、要求をビジネス・オブジェクト・ウィザードに送信します。このユーザー応答ダイアログ・ボックスの以下のコンポーネントを指定してください。
- msg ストリングには、ユーザーに対して表示する必要のある条件、質問、または情報を示すテキストを代入します。
- dialogFlags マスクには、ユーザー応答ダイアログ・ボックスの外観を表す以下の機能を代入します。
- 表示するボタン
これらのボタンの 1 つをユーザーがクリックすると、ユーザー応答ダイアログ・ボックスが終了します。これらのボタンを指定するには、表 105 の『表示するボタン』のセクションにあるダイアログ・ボタン定数を使用します。
- 表示するアイコン
アイコンにより表示するユーザー応答ダイアログ・ボックスのタイプが判別されます。ダイアログ・ボックスのタイプを指定するには、表 105 の『表示するダイアログ・ボックス・アイコン』のセクションにあるダイアログ・アイコン定数の 1 つを使用します。
表 105. ユーザー応答ダイアログ・ボックスの外観の表示
ユーザー応答ダイアログ・ボックスの外観
| ODKConstant ユーザー応答ダイアログ定数
|
表示するボタン:
|
|
| OK
|
MSG_OK
|
| OK、キャンセル
|
MSG_OKCANCEL
|
| 再試行、キャンセル
|
MSG_RETRYCANCEL
|
| 再試行、無視、中止
|
MSG_ABORTRETRYIGNORE
|
| はい、いいえ
|
MSG_YESNO
|
| はい、いいえ、キャンセル
|
MSG_YESNOCANCEL
|
表示するダイアログ・ボックス・アイコン:
|
|
| エラー・アイコン
|
MSG_ERROR
|
| クリティカル・エラー・アイコン
|
MSG_CRITICALERROR
|
| 警告アイコン
|
MSG_WARNING
|
| 情報アイコン
|
MSG_INFORMATION
|
| 疑問符 (?) アイコン
|
MSG_QUESTION
|
- 注:
- 表 105 のユーザー応答ダイアログ定数はすべて
ODKConstant インターフェースに定義されています。
dialogFlags 引き数を指定するには、ユーザー応答ダイアログ・ボックスの外観の説明となるユーザー応答ダイアログ定数のマスクを作成します。例えば、以下の sendMsg() への呼び出しによって、「再試行」ボタンや「キャンセル」ボタンだけでなくエラー・アイコンも表示するユーザー応答ダイアログ・ボックスが作成されます。
String msg = new String(bdkUtil.getMsg(1002, ODKConstant.XRD_ERROR, params));
bdkUtil.sendMsg(msg, ODKConstant.MSG_RETRYCANCEL | ODKConstant.MSG_ERROR);
参照
sendStatusMsg()
