EventSearchParameters
Since: BlackBerry 10.0.0
#include <bb/pim/calendar/EventSearchParameters>
To link against this class, add the following line to your .pro file: LIBS += -lbbpim
The EventSearchParameters class includes parameters for calendar event searches.
This class packages parameters that you can use to search for specific calendar events. For example, an EventSearchParameters object could contain information such as start time, end time, or even specific events to search for.
To search for specific events, you can call CalendarService::events() and pass as a parameter an EventSearchParameters object that contains information about the events that you want to search for. When you search for events using EventSearchParameters, you should provide at least the detail level, start time, and end time that you want to search for.
Overview
Public Functions Index
EventSearchParameters () | |
EventSearchParameters (const EventSearchParameters &other) | |
~EventSearchParameters () | |
void | addEvent (const EventKey &event) |
void | addFolder (const FolderKey &folder) |
QString | attendeePrefix () const |
DetailLevel::Type | details () const |
QDateTime | end () const |
QList< EventKey > | events () const |
QList< FolderKey > | folders () const |
bool | isExpand () const |
bool | isValid () const |
bool | isVisibleOnlyEnabled () const |
int | limit () const |
QString | locationPrefix () const |
EventSearchParameters & | operator= (const EventSearchParameters &other) |
QString | prefix () const |
void | resetEvents () |
void | resetFolders () |
void | setAttendeePrefix (const QString &attendeePrefix) |
void | setDetails (DetailLevel::Type details) |
void | setEnd (const QDateTime &end) |
void | setEvents (const QList< EventKey > &events) |
void | setExpand (bool expand) |
void | setFolders (const QList< FolderKey > &folders) |
void | setLimit (int limit) |
void | setLocationPrefix (const QString &locationPrefix) |
void | setPrefix (const QString &prefix) |
void | setSort (QList< QPair< SortField::Type, bool > > sort) |
void | setSort (QPair< SortField::Type, bool > sort) |
void | setStart (const QDateTime &start) |
void | setSubjectPrefix (const QString &subjectPrefix) |
void | setVisibleOnlyEnabled (bool visibleOnly) |
QList< QPair< SortField::Type, bool > > | sort () const |
QDateTime | start () const |
QString | subjectPrefix () const |
Public Functions
Copy constructor.
This function constructs an EventSearchParameters containing exactly the same values as the provided EventSearchParameters.
Parameters | |
---|---|
other |
The EventSearchParameters to be copied. |
BlackBerry 10.0.0
Destructor.
BlackBerry 10.0.0
void
Adds an event key to this EventSearchParameters.
This function appends a new event key to the existing list of event keys for this EventSearchParameters.
Parameters | |
---|---|
event |
The event key to add. |
BlackBerry 10.0.0
void
Adds a folder key to this EventSearchParameters.
This function appends a new folder key to the existing list of folder keys for this EventSearchParameters.
Parameters | |
---|---|
folder |
The folder key to add. |
BlackBerry 10.0.0
QString
Retrieves the attendee prefix search parameter of this EventSearchParameters.
This function returns the string that's used in the prefix search on attendees.
The attendee prefix search parameter of this EventSearchParameters.
BlackBerry 10.3.0
DetailLevel::Type
Retrieves the detail level of this EventSearchParameters.
The detail level controls the set of attributes in events that are populated when a search is performed.
Monthly: Events have accountId, allDay, busyStatus, endTime, folderId, id, parentId, and startTime.
Weekly: Events have all the attributes in the monthly level plus birthday and subject.
Full: Events have all the attributes in the weekly level plus attendees, bbmConference, body, guid, location, meetingSequence, meetingStatus, recurrence, reminder, sensitivity, timezone, and url.
Agenda: Events have all the attributes in the weekly level plus bbmConference, guid, location, meetingSequence, meetingStatus, recurrence, reminder, sensitivity, timezone, and url.
WeeklyStatus: Events have all the attributes in the weekly level plus the response status of the owner
AgendaStatus: Events have all the attributes in the agenda level plus the reponse status of the owner
Search requests with lower detail levels are faster.
The detail level of this EventSearchParameters.
BlackBerry 10.0.0
QDateTime
Retrieves the end time of this EventSearchParameters.
This function returns the end of the query's time range. Any event that crosses the range should be returned. The end time is considered to be in the local time zone (the system's time zone).
The end time of this EventSearchParameters.
BlackBerry 10.0.0
QList< EventKey >
Retrieves the list of event keys for this EventSearchParameters.
An event key contains the primary key for an event in the database. When the list is non-empty, the search is performed directly for the events that have the provided keys.
The list of event keys for this EventSearchParameters.
BlackBerry 10.0.0
QList< FolderKey >
Retrieves the list of folder keys for this EventSearchParameters.
A folder key contains the primary key for a calendar folder in the database. When the list is non-empty, the search returns only events that belong to the provided folders.
The list of folder keys for this EventSearchParameters.
BlackBerry 10.0.0
bool
Indicates whether recurring events are expanded in the search results.
If recurring events are expanded, all occurrences of all events (including each occurrence of a recurring event) in the specified time range are returned.
true if recurring events are expanded, false otherwise.
BlackBerry 10.0.0
bool
Indicates whether this EventSearchParameters is valid.
This function determines whether the attributes of this EventSearchParameters object have acceptable values.
true if this EventSearchParameters is valid, false otherwise.
BlackBerry 10.0.0
bool
Indicates if the visibleOnly filter is active.
The visibleOnly flag determines if the event search is done only in visible calendars or not.
True, if search is done only for visible calendars, or false otherwise
BlackBerry 10.2.0
int
Retrieves the limit for the number of search results.
This function returns the maximum number of returned events.
The limit for the number of results.
BlackBerry 10.0.0
QString
Retrieves the location prefix search parameter of this EventSearchParameters.
This function returns the string that's used in the prefix search on locations.
The location prefix search parameter of this EventSearchParameters.
BlackBerry 10.3.0
EventSearchParameters &
Assignment operator.
This operator copies all values from the provided EventSearchParameters into this EventSearchParameters.
Parameters | |
---|---|
other |
The EventSearchParameters from which to copy all values. |
A reference to this EventSearchParameters.
BlackBerry 10.0.0
QString
Retrieves the prefix search parameter of this EventSearchParameters.
This function returns the string that's used in the prefix search. By setting the prefix, you can instruct the search to return only events whose subject or location fields start with the specified string. The search will also return events whose participants have names or emails starting with the given string.
The prefix search parameter of this EventSearchParameters.
BlackBerry 10.0.0
void
Sets the attendee prefix search parameter of this EventSearchParameters.
Parameters | |
---|---|
prefix |
The new attendee prefix search parameter. |
BlackBerry 10.3.0
void
Sets the detail level of this EventSearchParameters.
Parameters | |
---|---|
details |
The new detail level. |
BlackBerry 10.0.0
void
Sets the end time of this EventSearchParameters.
Parameters | |
---|---|
end |
The new end time. |
BlackBerry 10.0.0
void
Sets the list of event keys for this EventSearchParameters.
This function replaces the current list of event keys with the provided list.
Parameters | |
---|---|
events |
The new list of event keys. |
BlackBerry 10.0.0
void
Sets whether recurring events are expanded in the search results.
If recurring events are expanded, all occurrences of all events (including each occurrence of a recurring event) in the specified time range are returned.
Parameters | |
---|---|
expand |
If true recurring events are expanded, if false recurring events are not expanded. |
BlackBerry 10.0.0
void
Sets the list of folder keys for this EventSearchParameters.
This function replaces the current list of folder keys with the provided list.
Parameters | |
---|---|
folders |
The new list of folder keys. |
BlackBerry 10.0.0
void
Sets the limit for the number of search results.
Parameters | |
---|---|
limit |
The new limit for the number of search results. |
BlackBerry 10.0.0
void
Sets the location prefix search parameter of this EventSearchParameters.
Parameters | |
---|---|
prefix |
The new location prefix search parameter. |
BlackBerry 10.3.0
void
Sets the prefix search parameter of this EventSearchParameters.
Parameters | |
---|---|
prefix |
The new prefix search parameter. |
BlackBerry 10.0.0
void
Sets the sort parameters for this EventSearchParameters.
This function replaces the current list of sort parameters with the provided list.
Parameters | |
---|---|
sort |
The new list of sort parameters. |
BlackBerry 10.0.0
void
Sets the sort parameter for this EventSearchParameters.
This function replaces the current list of sort parameters with the provided parameter.
Parameters | |
---|---|
sort |
The new sort parameter. |
BlackBerry 10.0.0
void
Sets the start time of this EventSearchParameters.
Parameters | |
---|---|
start |
The new start time. |
BlackBerry 10.0.0
void
Sets the subject prefix search parameter of this EventSearchParameters.
Parameters | |
---|---|
prefix |
The new subject prefix search parameter. |
BlackBerry 10.3.0
void
Sets the visibleOnly parameter for this EventSearchParameters.
The visibleOnly parameters allow to search events only through visible calendars
The list of event keys for this EventSearchParameters.
BlackBerry 10.2.0
QList< QPair< SortField::Type, bool > >
Retrieves the sort parameters of this EventSearchParameters.
This function specifies the attributes by which the returned events will be sorted and whether they will be in ascending or descending order for each attribute.
The sort parameters of this EventSearchParameters.
BlackBerry 10.0.0
QDateTime
Retrieves the start time of this EventSearchParameters.
This function returns the start of the query's time range. All events that enter the range should be returned. The start time is considered to be in the local time zone (the system's time zone).
The start time of this EventSearchParameters.
BlackBerry 10.0.0
QString
Retrieves the subject prefix search parameter of this EventSearchParameters.
This function returns the string that's used in the prefix search on subjects.
The subject prefix search parameter of this EventSearchParameters.
BlackBerry 10.3.0