DialogStringEntry() 関数

この関数は、画面に英数字キーボードを表示し、オペレータがタグ変数ディクショナリにあるメッセージ型タグ変数の現在の文字列の値を画面上で変更できるようにします。

カテゴリ

その他

構文

[Result=]DialogStringEntry(MessageTag_Text、UserPrompt_Text);

パラメータ

MessageTag_Text

変更するメッセージ型タグ変数の名前です。この値は文字列値です。タグ変数を引用符で囲んで指定するか、引用符なしの .Name ドットフィールドを使用します。メッセージ型タグ変数をポインタとして使用することもできます。

UserPrompt_Text

キーボード上部に表示するユーザー メッセージです。

戻り値

以下の整数値のいずれかを返します。

 0 = ［キャンセル］がクリックされました。

 1 = ［OK］がクリックされました。

-1 = 内部エラーです。

-2 = 開始できませんでした。

-3 = タグ変数が定義されていません。

-4 = タグ変数がメッセージ型ではありません。

-5 = 書き込めません。

備考

この関数は、タッチ スクリーンを含むアプリケーションで主に使用されます。

例

Errmsg=DialogStringEntry(MyMessageTag.Name, "Enter a new string...");

Errmsg=DialogStringEntry("MyMessageTag","Enter a new string...");

たとえば、以下のスクリプトは英数字キーボードを開き、その上部に「新しい文字列を入力してください...」というメッセージを表示する一方、そのキーボードから MyMessageTag を変更できるようにします。

MessageTagX="MyMessageTag"; {文字列 MyMessageTag（変更するタグ変数）をメモリ メッセージ型タグ変数 MessageTagX に割り当てます}

MessageDisplay="新しい文字列を入力してください..."; {新しいメッセージ文字列をメモリ メッセージ型タグ変数 MessageDisplay に割り当てます}

Errmsg=DialogStringEntry(MessageTagX, MessageDisplay); {MessageTagX はメッセージ型タグ変数として定義されているので引用符は必要ありません}

参照項目

DialogValueEntry()