Dialog.Show method (Word)
Displays and carries out actions initiated in the specified built-in Word dialog box. Returns a Long that indicates which button was clicked to close the dialog box.
Syntax
expression.Show( _TimeOut_ )
expression Required. A variable that represents a 'Dialog' object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| 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 dismisses it. |
Return value
Long
Remarks
The following table shows the meaning of the values that the Show method returns.
| 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. |
Example
This example displays the Find and Replace dialog box with the word "Blue" preset in the Find what text box.
With Dialogs(wdDialogEditFind)
.Find = "Blue"
.Show
End With
This example displays and carries out any action initiated in the Open dialog box. The file name is set to . so that all file names are displayed.
With Dialogs(wdDialogFileOpen)
.Name = "*.*"
.Show
End With
This example displays and carries out any action initiated in the Zoom dialog box. If there are no actions initiated for approximately 9 seconds, the dialog box is closed.
Dialogs(wdDialogViewZoom).Show TimeOut:=9000
See also
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.