Dialog.Show Method

  • Article
Word Developer Reference

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.

Visual Basic for Applications 
  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.

Visual Basic for Applications 
  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.

Visual Basic for Applications 
  Dialogs(wdDialogViewZoom).Show TimeOut:=9000

See Also