PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Special cases
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Lists the appointments found on the mobile device (Android/iOS) and corresponding to the specified criteria.
Versions 21 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 21
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
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> [, <Sought 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 the details of the error, use ErrorInfo.
<Calendar>: Optional Calendar variable
  • Name of Calendar variable describing the calendar (organizer) containing the appointments to list.
  • NULL to list the appointments found in all available calendars.
Caution: A calendar must exist if it is specified.
<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 ("").
Remark: If only the date is specified (without specifying the hours, minutes and seconds), the events will be taken into account from the specified date at 0 hour 0 minute 0 second.
<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 specified (without specifying the hours, minutes and seconds), the events will be taken into account until the specified date at 0 hour 0 minute 0 second (therefore, the events for the day will 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).

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

Special cases

  • The search for appointments is always performed by taking the current time zone into account. On the contrary, ..StartDébut and ..EndFin of Appointment type are always expressed in the time zone associated with the appointment.
  • Android AppointmentList can be used in the emulator but not in the simulator.
  • Android AppointmentList is available only for devices running Android 4.0 or later (API level 14). A fatal error occurs if the function is used with an earlier system version.
    Reminder: To determine the version of Android the application is running on, use SysAndroidVersion.
Android

Required permissions

The call to this function modifies the permissions required by the application.
Required permission: READ_CALENDAR
This permission allows the application to read the calendar data of the user.
Component: wd270android.aar
Minimum version required
  • Version 18
Comments
Click [Add] to post a comment