AppointmentAdd (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Lotus Notes or Outlook calendar
Android calendar

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AppointmentAdd (Function)

In french: RendezVousAjoute

Adds an appointment:

in a Lotus Notes or Outlook calendar. The Appointment structure can be used define the details of this appointment.
in a calendar on an Android device.
in a calendar on an iOS device.
New in version 2025
in the device's default calendar.

Example

See additional examples

// Ouverture d'une session Lotus Notes
IDSession is int
IDSession = EmailStartNotesSession("MotDePasse", "ServeurMars", "mail/julie.nsf", "C:\Lotus Notes\julie.id")
// Initialisation des variables de la structure RendezVous
AppointmentReset()
// Renseignements des variables pour le nouveau rendez-vous
mAppointment.Subject = "Réunion commerciaux"
mAppointment.StartDate = "20070125100000"
mAppointment.Location = "Salle 3B"
mAppointment.NbParticipant = 3
mAppointment.Participant[1] = "Romain"
mAppointment.Participant[2] = "Lucas"
mAppointment.Participant[3] = "Stéphane"
// Ajout du rendez-vous
IF AppointmentAdd(IDSession) = True THEN
	Info("Rendez-vous ajouté")
ELSE
	Error("Erreur lors de l'ajout", ErrorInfo())
END

gRDV is Appointment
gCal is Calendar
tabCalendrier is array of Calendar 
// Récupère la liste des calendriers
tabCalendrier = AppointmentListCalendar()
gCal = tabCalendrier[1]

// Ajout d'un nouveau rendez-vous dans le premier calendrier
gRDV.Title = SAI_Titre
gRDV.StartDate = SAI_DateDeb + SAI_HeureDeb
gRDV.EndDate = SAI_DateFin + SAI_HeureFin
gRDV.Location = SAI_Lieu
gRDV.Content = SAI_Desc
IF SAI_Fuseau <> "" THEN
	gRDV.TimeZone = SAI_Fuseau
END
gRDV.Author = SAI_Auteur
gRDV.Guest = SAI_Invités
gRDV.WholeDay = INT_Jentière[1]

IF AppointmentAdd(gCal, gRDV) THEN
	ToastDisplay("RDV ajouté")
ELSE
	Error(ErrorInfo())
END

Adding an appointment to a calendar on an Android/iOS device Hide the details

<Result> = AppointmentAdd([<Calendar>, ] <Appointment>)

<Result>: Boolean

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

<Calendar>: Optional Calendar variable

Name of the Calendar variable that corresponds to the Android/iOS calendar the appointment will be added to.
New in version 2025
If this parameter is not specified, the appointment will be added to the device's default calendar.
If there are multiple accounts on the phone and a default calendar is associated with them, a window will appear to allow the user to select the desired account.

<Appointment>: Appointment variable

Name of the Appointment variable that corresponds to the appointment that will be added to the specified calendar on the Android/iOS device.

Syntax

Adding an appointment to a Lotus Notes or Outlook calendar Hide the details

<Result> = AppointmentAdd(<Session identifier>)

<Result>: Boolean

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

<Session identifier>: Integer

Session ID to be used. This ID is returned by one of the following functions: EmailStartNotesSession, EmailStartOutlookSession, NotesOpenDatabase or OutlookStartSession.

Remarks

Lotus Notes or Outlook calendar

When you create an appointment with a reminder in Outlook, the reminder appears immediately, regardless of the appointment date.
The appointments are added as "meetings". To change the type of appointment, modify the "AppointmentType" control of the new appointment (with NotesModifyItem, for example).
The different possible values for the types are as follows:
- "0": appointment
- "1": anniversary
- "2": event
- "3": meeting
- "4": reminder
Example:
NotesModifyItem(ID, "AppointmentType", "0")
In Outlook, the management mode of contacts/participants can be specified when starting the session (EmailStartOutlookSession or OutlookStartSession).
Reminder: This function cannot be used to add an appointment to an Outlook Express calendar.

Android calendar

AppointmentAdd can be used in the emulator but not in the simulator.

Business / UI classification: Business Logic

Component: wd300com.dll