The Spool Library: 5.1 Print Control Messages: Common Response Messages

| Up: GEOS SDK TechDocs | Up | Prev: 5 Print Control Messages | Next: 5.2 Flow of Control Messages 
MSG_PRINT_CONTROL_VERIFY_COMPLETED, MSG_PRINT_CONTROL_SET_DOC_NAME

These messages are normally used only to respond to messages sent out by the Print Control.

MSG_PRINT_CONTROL_VERIFY_COMPLETED

void	MSG_PRINT_CONTROL_VERIFY_COMPLETED(
        Boolean 	continue);

If you have decided to verify the user's Print dialog box choices, you must send this message back to the Print Control in response to MSG_PRINT_VERIFY_PRINT_REQUEST . If true is passed, the Print Control will continue preparing the job for printing. If the value passed is false , the print will be cancelled. It is up to the application to explain the problem to the user.

Source: Unrestricted, normally the PCI_output object.

Destination: Any PrintControl object.

Parameters: continue Flag signalling whether printing should continue or be cancelled.

Return: Nothing.

Interception: Unlikely.

MSG_PRINT_CONTROL_SET_DOC_NAME

void	MSG_PRINT_CONTROL_SET_DOC_NAME(
        char	* string);

This message must be sent by the PCI_docNameOutput before the print job can be spooled. It is sent in response to a MSG_PRINT_GET_DOC_NAME from the Print Control. The string argument should be something that will allow the user to recognize the print job in the Printer Control Panel.

Source: Unrestricted--normally the PCI_docNameOutput object.

Destination: Any PrintControl object.

Parameters: string The document's name, as a null-terminated string. Maximum length of this string is FILE_LONGNAME_LENGTH+1.

Return: Nothing.

Interception: Unlikely.

| Up: GEOS SDK TechDocs | Up | Prev: 5 Print Control Messages | Next: 5.2 Flow of Control Messages