PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • WLanguage Procedure
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Sends a fax via a connection (established beforehand by FaxConnect).
Note: 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 character string (with or without quotes)
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:
  1. Create a global procedure ("Insert .. New global procedure" in the code editor).Create a global procedure in the code editor: on the "Code" pane, in the "Procedures" group, expand "New" and select "New global procedure".
  2. 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, ...).
Components
WINDEVWEBDEV - Server codeReports and Queries wd230com.dll
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment