ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / Appointment functions (Lotus Notes/Android/iOS)
  • Special cases
  • Required permissions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Lists the appointments found on the mobile device (Android/iOS) and corresponding to the specified criteria.
Example
// Liste tous les rendez-vous de la journée 
DateDébut is Date = DateSys()
DateFin is Date = DateSys()
DateFin.Day += 1
tabRDV is array of Appointment = AppointmentList(Null, DateDébut, DateFin)

//--------------------------------------------------------------

// Liste tous les rendez-vous à venir à partir de la semaine prochaine
DateDébut is Date = DateSys()
DateDébut.Day += 7
tabRDV is array of Appointment = AppointmentList(Null, DateDébut)

//--------------------------------------------------------------

// Liste les rendez-vous à venir du calendrier <MonCalendrier> 
// qui contiennent la chaîne "voiture" dans le titre ou la description du rendez-vous
tabRDV is array of Appointment = AppointmentList(MonCalendrier, "", "", ...
		aptTitle + aptContent, "voiture")

//--------------------------------------------------------------

// Recherche un rendez-vous correspondant à un identifiant donné
tabRDV is array of Appointment = AppointmentList(Null, "", "", aptIdentifier, nId)
Syntax
<Result> = AppointmentList([<Calendar> [, <Start> [, <End> [, <Filter> [, <Search value>]]]]])
<Result>: Array of Appointment variables
Array of Appointment variables initialized with the list of appointments corresponding to the specified criteria.
If an error occurred, the array is empty and the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo.
<Calendar>: Optional Calendar variable
  • Name of the Calendar variable that describes the calendar (organizer) containing the appointments to list.
  • NULL to list the appointments found in all available calendars.
Please note: If a Calendar is specified, it must exist.
<Start>: Optional DateTime
Local start date and time for the appointments to list.
  • If <Start> and <End> are not specified, only the future appointments will be listed (from today's date and time).
  • If only <Start> is specified, all the appointments found after this date will be retrieved (the limit date is set to 01/01/2031).
  • If <Start> must not be specified and if at least one of the following parameters must be specified, use an empty string ("").
Note If only the date is indicated (without specifying hours, minutes and seconds), only events from the date indicated at 0 hours 0 minutes 0 seconds will be taken into account.
<End>: Optional DateTime
Local end date and time for the appointments to list.
  • If <Start> and <End> are not specified, only the future appointments will be listed (from today's date and time).
  • If only <End> is specified, all the appointments found before this date will be listed (the limit date defined by Google is 01/01/1970).
  • If <End> must not be specified and if at least one of the following parameters must be specified, use an empty string ("").
Remark: If only the date is indicated (without specifying hours, minutes and seconds), only events up to the date indicated at 0 hours 0 minutes 0 seconds will be taken into account (events of the day will therefore not be taken into account).
<Filter>: Optional Integer constant (or combination of constants)
Properties on which the list of appointments must be filtered:
aptContentFilters on the appointment description (contains search).
aptIdentifierFilters on the appointment identifiers (exact-match search).
aptLocationFilters on the appointment location (contains search).
aptTitleFilters on the appointment title (contains search).

Note: If several filters are specified (combination of constants), an appointment will be listed if at least one of the filtered properties matches the searched value.
<Search value>: Optional character string
Value sought in the filtered properties of the appointment. This search is not case sensitive.
Remarks

Special cases

  • The appointment search is always performed taking into account the current time zone. However, the StartDate and EndDate properties of type Appointment are always in the time zone associated with the appointment.
  • Android AppointmentList can be used in the emulator but not in the simulator.
Android

Required permissions

This function changes the permissions required by the application.
Permission required: READ_CALENDAR
This permission allows the application to read the calendar data of the user.
Component: wd300android.aar
Minimum version required
  • Version 18
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help