RunDbox()
Summary
Runs a dialog box or opens a toolbox or toolbar.
Syntax
return_value = RunDbox(string dbox_name, argument1, argument2,..., argument8)
| Argument | Contents |
|---|---|
| dbox_name | The name of the dialog box to run |
| argument1, etc. | Arguments to the dialog box |
Returns
The return value of the dialog box, if any, or null otherwise.
Notes
-
If extra arguments are passed to a dialog box, they are ignored. If too few arguments are passed to a dialog box, the dialog box receives null for the missing arguments.
-
If dbox_name specifies a dialog box, then RunDbox() does not return until the dialog box terminates.
-
If dbox_name specifies a toolbox or toolbar, the RunDbox() call returns immediately after the toolbox or toolbar opens, and execution of the macro continues with the next statement.
Error Codes
| Error Type | Meaning |
|---|---|
| Error | When the called dialog box encounters an error and does not trap it, RunDbox() signals that error |
| NotFound | The dialog box does not exist or encountered a NotFound error |
See Also
| Function | Summary |
|---|---|
| RunMacro() | Runs a macro |
| Return() | Returns from a called macro or dialog box |