Display Method
Displays the specified built-in Word dialog box until either the user closes it or the specified amount of time has passed. Returns a Long that indicates which button was clicked to close the dialog box.
| Return value | Description |
|---|---|
| -2 | The Close button. |
| -1 | The OK button. |
| 0 (zero) | The Cancel button. |
| > 0 (zero) | A command button: 1 is the first button, 2 is the second button, and so on. |
expression**.Display(TimeOut)**
expression Required. An expression that returns a Dialog object.
TimeOut Optional Variant. The amount of time that Word will wait before closing the dialog box automatically. One unit is approximately 0.001 second. Concurrent system activity may increase the effective time value. If this argument is omitted, the dialog box is closed when the user closes it.
Comparing the Show and Display Methods
The Show method shows the specified built-in Word dialog box, then (if the user clicks the OK button) carries out the actions specified by the user in the dialog box. The Display method, on the other hand, displays the specified built-in Word dialog box, but takes no action after the user closes the dialog box. Therefore, you should choose the method to use as follows:
- Use the Display method if the actions the user will take in the dialog box are completed before the user closes the dialog box - for example, when the user customizes a menu or toolbar by using the Customize dialog (wdDialogToolsCustomize). You can also use the Display method if you want to ignore the actions requested by the user, if those actions are normally completed after the user closes the dialog box.
- Use the Show method if the actions the user will take in the dialog box are normally completed after the user closes the dialog box - for example, when the user selects a file to open by using the Open dialog (wdDialogFileOpen).
Example
This example displays the About dialog box for approximately ten seconds.
Dim dlgAbout As Dialog
Set dlgAbout = Dialogs(wdDialogHelpAbout)
dlgAbout.Display TimeOut:=10000
This example displays the Customize dialog box.
Dialogs(wdDialogToolsCustomize).Display
Applies to | Dialog Object
See Also | Dialogs Collection Object | Dialogs Property | Displaying Built-in Word Dialog Boxes | FileDialog Property