tapiDialerDisplay (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Mobile specific functions / Phone functions

Automatic call
Application in the background: Specific case from Android 10

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

tapiDialerDisplay (Function)

In french: telDialerAffiche

Opens the default telephony application (dialer) and displays the specified number. No call is made.

Example

tapiDialerDisplay("0612345678")

Syntax

<Result> = tapiDialerDisplay(<Phone number>)

<Result>: Boolean

True if the telephony application (dialer) was opened,
False otherwise. To get more details on the error, use ErrorInfo.

<Phone number>: Character string

Phone number to display in the dialing screen.
If this parameter is an empty string (""), the telephony application will be opened on the dialing screen.

Remarks

Automatic call

To automatically trigger the call to the specified number, use tapiDialerCall.

Application in the background: Specific case from Android 10

Starting with Android 10, it is no longer possible to open a window when the application is in the background.

tapiDialerDisplay can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

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.

For more details, see Android 10: Behavior of applications in the background.

Component: wd300android.jar