DDE commands

 

---

 

Applications such as word processors may communicate with the Zetafax client program directly using DDE commands. Provided adequate details have first been given using the DDE commands, when a document is "printed" using the Zetafax Windows printer driver no dialogs will be displayed and the fax or faxes will be submitted to the Zetafax server automatically.

 

DDE conversation

 

Before issuing any addressing commands, a DDE conversation must be established between the application and the Zetafax client program. The name of the DDE server is Zetafax, and the topic for the purposes of addressing faxes is Addressing.

 

The Zetafax client program should be put under the control of DDE by issuing a DDEControl DDE Execute call.

 

Addressing commands can then be issued using DDE Poke calls. Details of the commands which may be used are given below.

 

A message file should be created by printing using the Zetafax Windows printer driver. Alternatively an ASCII file, or a suitable Epson or TIFF file, may be copied to the spool file location used by the Zetafax client program (usually C:\WINDOWS\ZETAFAX.SPL, set by the LogArea: entry in the ZETAFAX.INI file).

 

The message can be submitted to the Zetafax server for sending with a Send DDE Execute call, or for preview with a Preview DDE Execute call.

 

Further messages can be submitted by specifying a new addressee, organization, and fax number, creating a new message file, and then issuing a Send or Preview DDE Execute call.

 

Note:  Each of the addressing settings, such as the choice of letterhead, will remain unchanged between messages until the appropriate DDE Poke call is made to alter it. If these settings need to be reset to their default values between messages, the Zetafax client program should be released from DDE control with a DDERelease DDE Execute call and then put back under DDE control with a DDEControl DDE Execute call.

 

After submitting the message or messages the Zetafax client program should be released from the control of DDE by issuing a DDERelease DDE Execute call.

 

The DDE conversation should finally be terminated properly.

 

Commands

 

The following WM_DDE_EXECUTE commands may be issued using the Addressing topic:  

 

 

 

Poke items

 

The following table lists the items that may be poked (WM_DDE_POKE) using the Addressing topic whilst the Zetafax client program is under DDE control on all Zetafax configurations:

 

 

For a description of each command and its parameters see SUBMIT file Message Addressing lines.

 

With an API license the following additional items may be poked:

 

 

 

For a full description of each command and its parameters, see SUBMIT file Message Option lines.

 

Related topics

Example DDE macros