The dialog service plugin provides INCO procedures that display various types of dialogs such as message boxes or file selector dialogs. All these procedures are asynchronous, i.e. if called with CallProcedure() from inside the INIX process, they return immediately, before the user has dismissed the dialog. To wait for the user to respond and get the result value, use CallProcedureExSync() or any other of the synchronous calling of asynchronous procedures functions (described in detail in the libinco_32 documentation).
Display a dialog containing a Message, a text input field with a Default text, and OK and Cancel buttons.
Returns the entered text if the OK button was clicked, or an empty string if the Cancel button was clicked.
Display a dialog containing an Icon, a Message, and a set of Buttons. Valid values for Buttons are:
Valid values for Icon are:
Returns a code corresponding to the button that was clicked: 2 = Yes, 4 = OK, 8 = No, 16 = Cancel.
Display a dialog containing a Message, a list box, and OK and Cancel buttons. In the list box, one of several items can be selected.
Choices is a shell-encoded list of items to be presented in the list box.
Returns the index (0-based) of the selected item if the OK button was clicked, or -1 if the Cancel button was clicked.
Display a color selection dialog. Default is the color to be initially selected, or 0xFFFFFFFF if unspecified.
Returns the chosen color if the OK button was clicked, or 0xFFFFFFFF if the Cancel button was clicked.
Colors are in the usual format 0xBBGGRR.
Display a file browser dialog to select an existing file. DefaultPath specifies the folder that is initially displayed in the dialog; if empty, the current directory is used. Wildcard is a pattern containing the wildcards * and ?, usually of the form "*.abc", that in some unspecified way restricts which files can be selected. Several patterns with human-readable descriptions can be provided in the format "BMP files|*.bmp|All files|*.*". If empty, all files can be selected.
Returns the path of the selected file if the OK button was clicked, or an empty string if the Cancel button was clicked. The zero-based index of the selected pattern from Wildcard is returned as a second result, a uint32 named index.
Display a file browser dialog for the user to indicate a file to be created. DefaultPath specifies the folder that is initially displayed in the dialog; if empty, the current directory is used. DefaultName is the proposed file name. Wildcard is a pattern containing the wildcards * and ? that in some unspecified way restricts the file names that can be entered, usually of the form "*.abc" to require a specific file name extension. Several patterns with human-readable descriptions can be provided in the format "BMP files|*.bmp|All files|*.*". If empty, no restrictions are placed on the file name.
Returns the path of the selected file if the OK button was clicked, or an empty string if the Cancel button was clicked. The zero-based index of the selected pattern from Wildcard is returned as a second result, a uint32 named index.
Display a file browser dialog to select a new or existing folder. Message can be left empty to use a default message. DefaultPath specifies the folder that is initially selected in the dialog; if empty, the initial folder is unspecified.
Returns the path of the selected folder if the OK button was clicked, or an empty string if the Cancel button was clicked.
1.8.8