The 'Show' method

Argument: None
Result: None, or Integer scalar for pre-defined dialogs

Valid for: Any displayable object

For standard visible objects other than a Window, Form, Dialog, or Document, the Show method is equivalent to setting the visible property of an object to 1, i.e. it makes it visible if it was previously hidden. For a window-type object, it also makes the window come to the front if it was previously obscured by other windows.

For the pre-defined dialogs (ChooseColor, ChooseFont, ChooseDir, OpenFile, SaveFile, and MsgBox), the Show method displays the dialog in the modal state. The dialog remains open until the user selects a button which closes the dialog. The result of the Show method indicates which button was pressed.

For the ChooseColor, ChooseFont, ChooseDir, OpenFile, and SaveFile dialogs, the Show method returns 1 to indicate the OK button was pressed, or 0 to indicate the Cancel button. If the return value is 1, you should read the object's properties (such as the color property of the ChooseColor dialog) to find out what the user selected.

The possible return values for the MsgBox dialog depend on the style property which determines which of the buttons are displayed. The result will be one of:

    1   =  OK
    2   =  Cancel
    3   =  Abort
    4   =  Retry
    5   =  Ignore
    6   =  Yes
    7   =  No