Help / WLanguage / WLanguage functions / Mobile specific functions / Phone functions
  • Special cases
  • Application in the background: Specific case from Android 10
  • Required permissions
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
tapiDialerCall (Function)
In french: telDialerCompose
Opens the default telephony application (dialer) found on the phone and dials the specified number.
<Result> = tapiDialerCall(<Phone number>)
<Result>: Boolean
  • True if the telephony application was successfully started,
  • False otherwise. If an error occurs, you can get the details of the error with ErrorInfo.
<Phone number>: Character string
Phone number to dial.
The function will return False if this parameter corresponds to an empty string ("").
Caution: the number must contain no space character.

Special cases

  • AndroidAndroid Widget To display the dial screen without dialing a number, use tapiDialerDisplay.
  • It is not possible to automatically call emergency numbers
  • No USSD code can be dialed.
AndroidAndroid Widget

Application in the background: Specific case from Android 10

From Android 10, it is no longer possible to open a window when the application is in the background.
tapiDialerCall can open a window. If this function is used while the application is in the background, a fatal error will occur.
  • It is possible to determine if the application is in the background using InBackgroundMode.
  • If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.
AndroidAndroid Widget

Required permissions

The call to this function modifies the permissions required by the application.
Required permission: CALL_PHONE.
Component: wd300android.aar
Minimum version required
  • Version 15
This page is also available for…
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help