input command

Use the input command to prompt the user for input, and then use it to run an editor command.

Syntax

input [ "label" [ "text" ] ] "command" 

Parameters

label Use the label parameter to specify the prompt that you want to display for the user.  If label contains quotes or backslashes, they must be prefixed with the backslash character.  If you do not wish to specify a prompt string but you need to specify the text parameter, then you must specify an empty string ("").
text Use the text parameter to specify the text that you want to initialize the entry field with.  If text contains quotes or backslashes, they must be prefixed with the backslash character.
command Use the command parameter to specify the command that you want to run if the user hits enter from the input prompt.  The command must include any parameters and trailing spaces.  The text that the user entered into the entry field will be appended to the command's parameters.  The command may be any valid editor command.  If the command contains quotes or backslashes, they must be prefixed with the backslash character.

Status

The status parameter is not directly affected by this command.  However, if the status parameter is not clear after running the specified command, the input prompt will not be dismissed automatically.

Examples

input "Enter fill character:" "block fill "
input "" "text" "set messageText " 

Related concepts
Editor commands, actions, and parameters

Related reference
status parameter
blockFill action
findMark action
locateLine action
nameMark action
rename action