Codes to display dialogs

The following codes can be used to display various dialogs when the command is run. This lets you provide information (like selecting a file or a folder, or entering a string) at "run-time" rather than incorporating the value into the command itself.

 

Long form

Short form

Description

{dlgopen}

{Rf}

Displays an Open File dialog, which lets you select an existing filename to pass to the command.

{dlgmulti}

{Rm}

Displays an Open File dialog in multiple selection mode, which lets you select one or more existing files.

{dlgsave}

{RF}

Displays a Save File dialog, which lets you enter a new filename to pass to the command.

{dlgfolder}

{Rd}

Displays a Select Folder dialog, which lets you select a folder to pass to the command.

{dlgstring}

{Rs}

Displays a dialog that lets you enter an arbitrary string.

{dlgstringS}

{RS}

The same as {dlgstring} except the contents of the string field are automatically selected (only applies if a default value is specified - see below).

{dlgpassword}

{Rp}

The same as {dlgstring} except the contents of the string field are obscured - useful for entering passwords.

{dlgchoose}

{Rc}

Displays a drop-down list that lets you choose from a list of values.

{dlgchooseS}

{RC}

The same as {dlgchoose} except the value list is automatically sorted.

 

 

You will almost certainly want to use the following parameters to control the behavior of these codes.