open

open(): Integer updating;

The open method of the CMDPrint class initiates the common Print dialog for the CMDPrint class and returns a value indicating the success of the user actions, as listed in the following table.

Value	Description
0	User clicked the OK button. Values of the selections made are returned.
1	User clicked the Cancel button.
Other	Windows error number indicating a fault associated with the execution of the dialog.

The position of the displayed Print dialog cannot be determined. The values of the variable options for the class should be set before the open method is used.

The following example shows the use of the open method to open a common Print dialog.

vars
    cmdPrint : CMDPrint;
begin
    create cmdPrint;
    if cmdPrint.open = 0 then              // not cancelled and no error
        str := cmdPrint.printerName;       // use returned value
    endif;
epilog
    delete cmdPrint;                       // tidy
end;

When a printer is about to be opened and the previously used printer name is no longer valid, the following log message is written and the current default printer is used instead.

Printer name is no longer valid: printer-name - selecting default printer