2.14.3 Bringing Up a Dialog

X-Function dialogs

X-Functions whose names begin with dlg may be called in your scripts to facilitate dialog-based interaction.

Name Brief Description
dlgChkList Prompt to select from a list
dlgFile Prompt with an Open File dialog
dlgPath Prompt with an Open Path dialog
dlgRowColGoto Go to specified row and column
dlgSave Prompt with a Save As dialog
dlgTheme Select a theme from a dialog

Possibly the most common such operation is to select a file from a directory. The following line of script brings up a dialog that pre-selects the PDF file extension (group), and starts at the given path location (init):

dlgfile group:=*.pdf init:="C:\MyData\MyPdfFiles";
type %(fname$);  // Outputs the selected file path to Script Window

The complete filename of the file selected in the dialog, including path, is stored in the variable fname$. If init is left out of the X-Function call or cannot be found, the dialog will start in the User Files folder.

The dlgsave X-Function works for saving a file using a dialog.

dlgsave ext:=*.ogs;
type %(fname$);  // Outputs the saved file path to Script Window

Origin C dialogs

The type.remind() method provides another way to open a dialog for user interaction. This method creates a private reminder message dialog. An Ini file is used to initialize the dialog. Each section in the ini file is used for a single message. The same functionality can be created in Origin C using the global function PrivateReminderMessage.

For more information, see type.remind().