ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / Phone functions
  • Differences between tapiDial and tapiLineDial
  • Limitation
  • Required configuration
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Dials a phone number for a voice line.
Note: Depending on the operating system and modem driver used, a call management window may appear when using the tapiDialfunction. . This window is used to automatically end the current call.
Example
IF tapiDial(SAI_NuméroTéléphone, "TestEtatLigne") = True THEN 
	Info("Cliquez sur OK pour raccrocher") 
	tapiHangUp() 
END
PROCEDURE TestEtatLigne(ValeurEtatLigne is int) 
SWITCH ValeurEtatLigne 
	CASE tapiLineBusy: Message("La ligne est occupée") 
	CASE tapiLineConnected: Message("OK, connecté")
	CASE tapiLineDialing: Message("Numérotation en cours") 
	CASE tapiLineDialTone: Message("Tonalité")
	CASE tapiLineDisconnected: Message("Le correspondant a raccroché")
	CASE tapiLineProceeding: Message("Recherche du correspondant")
	CASE tapiLineRingBack: Message("Sonnerie chez le correspondant")
END
Syntax
<Result> = tapiDial(<Number to dial> [, <WLanguage procedure> [, <Duration> [, <Custom parameter>]]])
<Result>: Boolean
  • True if the line is open: you can pick up the handset and speak,
  • False otherwise. To get more details on the error, use tapiError.
<Number to dial>: Character string
Phone number to dial. To specify a prefix (0 for an external line for example), use a comma in the number. For example: "0.0467789066".
<WLanguage procedure>: Optional procedure name
Name of WLanguage procedure used to manage the progress of dialing. For more details on this procedure, see Parameters of the procedure used by tapiDial.
Warning: This procedure must not contain any calls to the debugger (no breakpoint, no STOP keyword, no auto-stop expression, ...).
<Duration>: Optional integer or optional Duration
Maximum wait duration (in seconds). When this timeout is exceeded, the function assumes that there is no response (nobody picked up).
This parameter can correspond to:
  • an integer corresponding to the number of seconds,
  • a Duration variable,
  • the duration in a readable format (e.g., 1 s or 10 ms).
<Custom parameter>: Any type, optional
Parameter passed to the WLanguage procedure.
Remarks

Differences between tapiDial and tapiLineDial

  • tapiDial is used in the context of a single outgoing call. The identifier of this call is not available.
  • tapiLineDial is used in a context where there may be several simultaneous calls. tapiLineDial returns the call identifier. Therefore, it can be easily handled (to transfer a call for example).

Limitation

tapiDial cannot be called in the procedure for call detection (defined by tapiListen).

Required configuration

Telephony functions use TAPI 2.0 technology and/or TAPI 3.1 technology. These technologies can be used on all systems.
Component: wd300com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/21/2024

Send a report | Local help