<gglConnection variable>.FillCalendar (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / Google functions / Google Calendar

Managing dates and times
Possible error cases:

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<gglConnection variable>.FillCalendar (Function)

In french: <Variable gglConnexion>.RemplitAgenda

Fills a calendar that was previously retrieved: the events corresponding to the calendar are retrieved (by using criteria if necessary). This function must be used after the call to <gglConnection variable>.ListCalendar.

Example

// Connection
Cnt is gglConnection
...
IF Cnt.Connect() = False THEN
	Error(ErrorInfo())
	RETURN
END
arrCalendars is array of 0 gglCalendar 
arrCalendars = Cnt.ListCalendar() 
// First calendar
Calendar is gglCalendar = arrCalendars[1]
// Example of different calls to GglFillCalendar
// Retrieve all the future events:
Cnt.FillCalendar(Calendar)
// Retrieve all the forthcoming events containing "PC Soft"
Cnt.FillCalendar(Calendar, "", "", "PC Soft")
// Retrieve all the forthcoming events that do not contain "work"
Cnt.FillCalendar(Calendar, "", "", "-work")
// Retrieve all the future events 
Cnt.FillCalendar(Calendar, TimeSys())
// Retrieve all the past events
Cnt.FillCalendar(Calendar, "", TimeSys())
// Retrieve the events between 01/01/2008 and 01/01/2009 included
Cnt.FillCalendar(Calendar, "20080101", "20090102")
// Other possibility:
Cnt.FillCalendar(Calendar, "20080101", "20090101235959")
// Retrieve the events between 11/01/2008 and 12/01/2008 excluded
Cnt.FillCalendar(Calendar, "20081101", "20081201")
// Browse the events of a calendar
Evt is gglEvent
FOR EACH Evt OF Calendar 
	Trace(Evt.Title)
END

Syntax

<Result> = <Google connection>.FillOrganizer(<Calendar> [, <Beginning of events> [, <End of events> [, <String to find>]]])

<Result>: Boolean

True if the events have been retrieved,
False otherwise. To get more details on the error, use ErrorInfo.

<Google connection>: gglConnection variable

Name of the gglConnection variable to be used. This connection was validated by <gglConnection variable>.Connect.

<Calendar>: gglCalendar variable

Name of the gglCalendar variable to fill.

<Beginning of events>: Optional DateTime

Start date and time of events to retrieve.
If <Beginning of events> and <End of events> are not specified, only the future events are retrieved (events from today's date).
If only <Beginning of events> is specified, all the events found after this date will be retrieved (the limit date defined by Google is 01/01/2031).

<End of events>: Optional DateTime

End date and time of events to retrieve.
If <Beginning of events> and <End of events> are not specified, only the future events are retrieved (events from today's date).
If only <End of events> is specified (in this case, <Beginning of events> is equal to an empty string), all the events found before this date are retrieved (the limit date defined by Google is 01/01/1970).

<String to find>: Optional character string

Text to find in the calendar events.
If this parameter is specified, only the events containing the specified text will be listed. The search is performed on the name and description of the calendar. This search is not case sensitive.
This parameter corresponds to an empty string ("") by default.

Remarks

Managing dates and times

The dates are automatically converted to the UTC format.
If only the date is specified (without specifying the hours, minutes and seconds):
- in <Beginning of events>, all the events found from the specified date at 0 hour 0 minute 0 second will be taken into account.
- in <End of events>, all the events found until the specified date at 0 hour 0 minute 0 second will be taken into account (therefore, the events of the day will not be taken into account).
Don't forget to configure the time zone and the time of the computer that performs the search.

Possible error cases:

The Internet connection is not valid.
The authentication was not performed properly.
The XML response of the server cannot be read.
The calendar was not found.

Component: wd300ggl.dll