Fax Sending: 2.2 Drawing the Contents: Supplying the Document's Name

Up: GEOS SDK TechDocs| Up | Prev: 2.1 Declaring the Objects | Next: 2.3 Supplying the Fax's Contents

The process object (or whatever object is specified in the PrintControl 's PCI_docNameOutput field) must supply the fax's name when queried. (On the Nokia 9000i Communicator, this name is not especially important; this is just a required part of the PrintControl 's API.) The name need not be unique.

To fulfill its responsibility, the object must handle MSG_PRINT_GET_DOC_NAME , responding by sending MSG_PRINT_CONTROL_SET_DOC_NAME . If the message is not handled in this manner, the fax will never be sent.

The following is an acceptable handler:

Code Display 4-3 Handling MSG_PRINT_CONTROL_SET_DOC_NAME for faxing

The printCtrlOD value is an argument to the message.

@method MyProcessClass, MSG_PRINT_GET_DOC_NAME {
    @send printCtrlOD::MSG_PRINT_CONTROL_SET_DOC_NAME("Good Morning");
}

Up: GEOS SDK TechDocs| Up | Prev: 2.1 Declaring the Objects | Next: 2.3 Supplying the Fax's Contents