AppointmentCreate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / Appointment functions (Lotus Notes/Android/iOS)

Special cases
Application in the background: Specific case from Android 10

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AppointmentCreate (Function)

In french: RendezVousCrée

Opens a new appointment window in the device's native calendar application.

New in version 2025

This function is now available for iPhone/iPad applications.

Example

apt is Appointment
IF AppointmentCreate(apt) THEN
Info(StringBuild("The %1 appointment was added to the %2 calendar", ...
apt.Name, apt.Calendar.Name))
END

New in version 2025

apt is Appointment
...
AppointmentCreate(apt, ProcApt)

	INTERNAL PROCEDURE ProcApt(Status)
		SWITCH Status 
			CASE aptCanceled
			Trace("Appointment canceled by the user")
			CASE aptFailed
			Trace("Unable to create appointment")
			CASE aptSuccess
			Info("Appointment created successfully")
		END
	END

Syntax

Creating an appointment (synchronous syntax) Hide the details

<Result> = AppointmentCreate(<Appointment>)

<Result>: Boolean

True if an appointment was created,
False otherwise. To get more details on the error, use ErrorInfo.

<Appointment>: Appointment variable

Name of the Appointment variable to be populated with the data from the appointment created in the device's native application.

New in version 2025

Creating an appointment (asynchronous syntax) Hide the details

AppointmentCreate(<Appointment> , <WLanguage procedure>)

<Appointment>: Appointment variable

Name of the Appointment variable to be populated with the data from the appointment created in the device's native application.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called when the appointment is created. This procedure determines whether the appointment was created.
For more details on this procedure, see Parameters of the procedure used by AppointmentCreate.

Remarks

Special cases

To create a new appointment programmatically without opening any window, use AppointmentAdd.
If synchronous syntax is used, AppointmentCreate blocks the application until the user confirms or cancels the creation of the new appointment.
New in version 2025
Asynchronous syntax allows the user to keep using the application while the appointment creation window is displayed.
AppointmentCreate can be used in the emulator but not in the simulator.

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.

AppointmentCreate 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.aar