TextInput([string[, string[, integer[, integer]]]])

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object-Free API » TextInput([string[, string[, integer[, integer]]]]) Version 2.0

説明

TextInput 関数は、テキスト入力ポップアップを開き、入力された内容を文字列として返します。これは、ユーザインターフェース機能の一部です。

引数

  • string (オプション):
    ポップアップのタイトル文字列。タイトルバーには、デフォルトで先頭に "Edit" と表示されます。これは削除できません。
  • string (オプション):
    あらかじめ入力欄に表示されているテキスト文字列。これによって、ユーザにガイダンスを提示できます。
  • integer (オプション):
    ポップアップが表示されるX軸上の位置を指定します(すべての画面)。 "0" で画面の左端に、nil または undefined で中央位置になります。
  • integer (オプション):
    ポップアップが表示されるY軸上の位置を指定します(すべての画面)。 "0" で画面の上端に、nil または undefined で中央位置になります。

戻り値

  • string:
    ユーザ入力を返します。

テキスト入力ポップアップを表示し、入力された値を Command Line History に出力します。

Lua
return function()
-- Create a pop-up with the title and an input field containing some default text
-- The returned text is store in a Lua variable
local input = TextInput("This is the title","Please provide your input here")
-- Print the returned text value
Printf("You entered this message: %s",tostring(input))
end