AppointmentAdd (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Calendar of a Lotus Notes or Outlook messaging
Android calendar

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AppointmentAdd (Function)

In french: RendezVousAjoute

Adds an appointment:

into the calendar of a Lotus Notes or Outlook messaging. The Appointment structure is used to define the data of this contact.
Reminder: This function cannot be used to add an appointment into the calendar of an Outlook Express messaging.
Versions 18 and later
into the calendar found on an Android device.
New in version 18
into the calendar found on an Android device.
into the calendar found on an Android device.
Versions 21 and later
into the calendar found on an iOS device.
New in version 21
into the calendar found on an iOS device.
into the calendar found on an iOS device.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 21 and later

This function is now available for the iPhone/iPad applications.

New in version 21

This function is now available for the iPhone/iPad applications.

Example

See additional examples

// Start a Lotus Notes session
SessionID is int
SessionID = EmailStartNotesSession("Password", "MarsServer", ...
"email/julia.nsf", "C:\Lotus Notes\julia.id")
// Initialize the variables of the Appointment structure
AppointmentReset()
// Fill the variables for the new appointment
mAppointment.Subject = "Sales meeting"
mAppointment.StartDate ="20070125100000"
mAppointment.Location = "Room 3B"
mAppointment.NbParticipant = 3
mAppointment.Participant[1] = "Robert"
mAppointment.Participant[2] = "Lucas"
mAppointment.Participant[3] = "Stephen"
// Add the appointment
IF AppointmentAdd(SessionID) = True THEN
Info("Appointment added")
ELSE
Error("Error during the addition", ErrorInfo())
END

gAPT is Appointment
gCal is Calendar
arrCalendar is array of Calendar
// Retrieves the list of calendars
arrCalendar = AppointmentListCalendar()
gCal = arrCalendar[1]

// Add a new appointment into the first calendar
gAPT.Title = EDT_Title
gAPT.StartDate = EDT_StartDate + EDT_StartTime
gAPT.EndDate = EDT_EndDate + EDT_EndTime
gAPT.Location = EDT_Location
gAPT.Content = EDT_Desc
IF EDT_TimeZone <> "" THEN
gAPT.TimeZone = EDT_TimeZone
END
gAPT.Author = EDT_Author
gAPT.Guest = EDT_Guests
gAPT.WholeDay = CBOX_WholeDay[1]

IF AppointmentAdd(gCal, gAPT) THEN
ToastDisplay("APT added")
ELSE
Error(ErrorInfo())
END

Syntax

Adding an appointment into the calendar of a Lotus Notes ou Outlook messaging Hide the details

<Result> = AppointmentAdd(<Session identifier>)

<Result>: Boolean

True if the addition was performed,
False otherwise. To find out the error details, use ErrorInfo.

<Session identifier>: Integer

Identifier of session to use. This identifier is returned by one of the following functions: EmailStartNotesSession, EmailStartOutlookSession, NotesOpenDatabase or OutlookStartSession.

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

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

<Result>: Boolean

True if the addition was performed,
False otherwise. For more details about the error, use the function ErrorInfo.

<Calendar>: Calendar variable

Name of the variable of type Calendar corresponding to the Calendar Android/iOS in which the appointment is to be added.

<Appointment>: Appointment variable

Name of the Appointment type variable corresponding to the appointment to be added in the specified Calendar of the Android/iOS device.

Remarks

Calendar of a Lotus Notes or Outlook messaging

When creating an appointment with reminder in Outlook, the reminder is immediately displayed regardless of the appointment date.
The added appointments are "meeting" appointments (instead of "appointment" appointments). To modify the type of appointment, all you have to do is modify the "AppointmentType" control of the created 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")
Versions 18 and later
In Outlook, the management mode of contacts/participants can be specified when starting the session (EmailStartOutlookSession or OutlookStartSession).
New in version 18
In Outlook, the management mode of contacts/participants can be specified when starting the session (EmailStartOutlookSession or OutlookStartSession).
In Outlook, the management mode of contacts/participants can be specified when starting the session (EmailStartOutlookSession or OutlookStartSession).

Versions 18 and later

Android calendar

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

New in version 18

Android calendar

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

Android calendar

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

Component : wd260com.dll