ダイアログボックスを表示し、ダイアログボックスでのアクションに基づく値を返します。

メモ このメソッドは R5 で新しく追加されました。

定義位置

NotesUIWorkspace

構文

variant = notesUIWorkspace.Prompt( type%, title$, prompt$ [, default ] [, values ] )

パラメータ

type%

定数。表示するダイアログボックスの種類を示します。次のいずれかを指定します。

PROMPT_CHOOSEDATABASE (13)

メモ Release 6.0 では定数名 PROMPT_CHOOSEDATABASE は実装されていませんが、代わりにリテラル値 13 を使用できます。

PROMPT_OK (1)

PROMPT_OKCANCELCOMBO (5)

PROMPT_OKCANCELEDIT (3)

PROMPT_OKCANCELEDITCOMBO (6)

PROMPT_OKCANCELLIST (4)

PROMPT_OKCANCELLISTMULT (7)

PROMPT_PASSWORD (10)

PROMPT_YESNO (2)

PROMPT_YESNOCANCEL (11)

String 型。ダイアログボックスのタイトルバーに表示する文字列です。どの type%s の場合でも必ず指定します。ただし、"" で null 文字列を指定することもできます。文字数の最大値は 65 です。

String 型。ダイアログボックス内に表示する文字列です。どの type%s の場合でも必ず指定します。ただし、"" で null 文字列を指定することもできます。文字数の最大値は 255 です。

デフォルトの入力値として使用する値です。ダイアログボックスの入力セクションには最初にこの値が入ります。ユーザーは [OK] を選択してこの値を受け入れるか、別の値で置き換えるか、[キャンセル] をクリックします。

type% が PROMPT_OK、PROMPT_YESNO、PROMPT_YESNOCANCEL、PROMPT_PASSWORD のダイアログボックスには適用できません。他のすべての type% の場合、省略可能です。ただし、PROMPT_OKCANCELCOMBO および PROMPT_OKCANCELEDITCOMBO の場合、default を使用して入力セクションを空白にしないことをお勧めします。

default として表示された値は、values リストに含めなければなりません。含まれていない場合は、無視されます。

PROMPT_OKCANCELEDIT、PROMPT_OKCANCELLIST、PROMPT_OKCANCELCOMBO、PROMPT_OKCANCELEDITCOMBO、PROMPT_OKCANCELLISTMULT のデフォルト値は、String 型、String 型の配列、String 形式の Variant 型、String 形式の Variant 型の配列のいずれかです。

ダイアログボックスのリストボックスに表示する値です。ユーザーはこの値の中から 1 つを入力値として選択できます。type% が PROMPT_OKCANCELLIST、PROMPT_OKCANCELCOMBO、PROMPT_OKCANCELEDITCOMBO、PROMPT_OKCANCELLISTMULT の場合のみ必要です。

PROMPT_OKCANCELLIST、PROMPT_OKCANCELCOMBO、PROMPT_OKCANCELEDITCOMBO、PROMPT_OKCANCELLISTMULT の値は、String 型の配列、String 形式の Variant 型、String 形式の Variant 型の配列のいずれかです。

	Integer 形式の Variant 型	PROMPT_OK、PROMPT_YESNO、PROMPT_YESNOCANCEL
	String 形式の Variant 型	PROMPT_OKCANCELEDIT、PROMPT_OKCANCELLIST、PROMPT_OKCANCELCOMBO、PROMPT_OKCANCELEDITCOMBO、PROMPT_PASSWORD
	Variant 型の配列	PROMPT_CHOOSEDATABASE、PROMPT_OKCANCELLISTMULT

Type% PROMPT_OK は常に 1 を返します。type% PROMPT_YESNO は [はい] を選択すると 1 を返します。[いいえ] を選択すると 0 を返します。type% PROMPT_YESNOCANCEL は、[はい] を選択すると 1 を返し、[いいえ] を選択すると 0 を返し、[キャンセル] を選択すると -1 を返します。PROMPT_OKCANCELLISTMULT は、[OK] を選択すると、戻り値は文字列配列を含む variant になり、[キャンセル] を選択すると EMPTY になります。PROMPT_CHOOSEDATABASE は、サーバー、ファイルパス、データベースのタイトルという順序でこれら 3 つの要素の文字列を含む値を返します。[キャンセル] を押すと戻り値は EMPTY になります。その他すべての type%s の場合、[OK] を押すと、戻り値は文字列であり、[キャンセル] を押すと EMPTY になります。

クロスリファレンス

式言語の @Prompt 関数

例

用語集