FaxSend (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WLanguage procedure

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FaxSend (Function)

In french: FaxEnvoie

Sends a fax according to the connection that was established beforehand (FaxConnect).

Remark: This function can be used in Windows 2000, XP or later. In Windows Vista (and later), the management of faxes is available with Windows Professional et Windows Integral Edition.

Example

ConnectID is int
ConnectID = FaxConnect()
...
ResSendFax is boolean
ResSendFax = FaxSend(ConnectID, "MyFax", "Message.txt", "0102030405")
...
FaxDisconnect(ConnectID)

Syntax

<Result> = FaxSend(<Connection identifier> , <Fax name> , <Content file of fax> , <Fax number> [, <Name of cover file> [, <WLanguage procedure>]])

<Result>: Boolean

True if the fax was sent,
False if an error occurred (in most cases, this error is caused by a configuration problem). To find out the error details, use ErrorInfo.

<Connection identifier>: Integer

Connection identifier, returned by FaxConnect.

<Fax name>: Character string (with quotes)

Name used to identify the outgoing fax. The status of the outgoing fax is returned by FaxStatus.

<Content file of fax>: Character string (with quotes)

Name and path of the file containing the text of the fax (a UNC path can be used). All the types of files that have a "Print" option in their popup menu in the explorer can be faxed.
Caution: Depending on the type of file to fax, the drivers and the applications required to manage this type of file must be installed on the computer. For example, to send a PDF file, the drivers required to manage the PDF format must be installed on the computer.

<Fax number>: Character string (with quotes)

Fax number of the recipient. Caution: if a specific area code or country code is required, it must specified.

<Name of cover file>: Optional character string (with quotes)

Name and path of the file containing the cover page of the fax. This file must use the format of cover pages (.cov). This file can also be created by the fax manager of Windows. See Sending faxes for more details.

<WLanguage procedure>: Optional procedure name

Name of the WLanguage procedure ("callback") called whenever the status of the outgoing fax changes. This procedure is used to handle the fax.
This procedure has the following format:

PROCEDURE <Procedure name>(<Fax name>, <Fax status>)

The parameters of this procedure are optional.
There is no need to pass parameters to this procedure. These parameters are automatically filled for each outgoing fax.

Remarks

WLanguage procedure

Whenever the status of the outgoing fax changes, FaxSend automatically calls the <WLanguage procedure>. This procedure is a global or local procedure of WINDEV or WEBDEV.

To create this procedure:

Create a global procedure in the code editor: on the "Code" pane, in the "Procedures" group, expand "New" and select "New global procedure".
Fill the declaration of the procedure as follows:

PROCEDURE <Procedure name> (<Fax name>, <Fax status>)
- <Fax name> is the name of the fax used. This name was defined by FaxSend.
- <Fax status> is one of the constants for fax status (see FaxStatus).

Caution: This procedure must contain no call to the debugger (no breakpoint, no STOP keyword, no auto-stop expression, etc.).

Component: wd260com.dll