## 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

Topic: APLX Help : System Classes : Methods : Show

[ Previous | Next | Contents | Index ]