Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Modules  ·  Fonctions  · 

Organizer QML API

QML Support for the Organizer API.

Overview

To be able to use this component the QML import statement needs to reference the module before it can used. Simply add the following to the QML file:

 import QtOrganizer 5.0

The Organizer API enables a client to request calendar, schedule and personal data from local or remote backends. The QML Organizer API delivers these capabilities in an easy to use form.

The following describes the API. You can also study the Examples or try the Tutorials to help get started quickly.

Organizer Items

The OrganizerItem element provides a generic interface for accessing events, todos, journals and notes. To actually access specific fields of an item, convenience sub elements of OrganizerItem are offered. These are Event, Todo, Journal and Note. Additionally, EventOccurrence and TodoOccurrence can be used for manipulating occurrences of events or todos.

Recurring Items

A recurring item is an item that occurs more than once; for example, a meeting that occurs every week for the next 10 weeks. A recurring item is created by creating an Event or Todo and setting a RecurrenceRule on it to specify the rules for when it should recur. See Recurrence and RecurrenceRule for detail references.

Collections

Every item stored in an organizer store belongs to exactly one collection. A collection can have properties such as a name, a "color", a specified icon, a description, and so on. Collections may be added, modified, or removed if the backend store supports those operations. There will always be at least one (default) collection in an organizer manager, into which items are saved if no other collection is specified.

Organizer Item Details

Several sub elements of Detail are provided as part of the API. They are general in design but are intended to fulfill specific use-cases. Please note that certain backends may choose not to support one or more of these elements as they appear here.

Organizer Filters

The Organizer QML plugin supplies filters to search for organizer items with particular values for various properties in the organizer item, such as IDs, collections, and details, etc.

Reference documentation

Main Classes

QtOrganizer5::Collection

The Collection element represents a collection of items in an organizer manager.

QtOrganizer5::Detail

The Detail element represents a single, complete detail about a organizer item.

QtOrganizer5::Filter

The Filter element is used to filter items made available through a backend.

QtOrganizer5::OrganizerItem

The OrganizerItem element represents the in-memory version of a organizer item.

QtOrganizer5::OrganizerModel

The OrganizerModel element provides access to organizer items from the organizer store.

QtOrganizer5::RecurrenceRule

The RecurrenceRule element represents a rule by which a organizer item repeats.

Item Classes

QtOrganizer5::Event

The Event element provides an event in time which may reoccur.

QtOrganizer5::EventOccurrence

The EventOccurrence element provides an occurrence of an event.

QtOrganizer5::Journal

The Journal element provides a journal which is associated with a particular point in time.

QtOrganizer5::Note

The Note element provides a note which is not associated with any particular point in time.

QtOrganizer5::Todo

The Todo element provides a task which should be completed.

QtOrganizer5::TodoOccurrence

The TodoOccurrence element provides an occurrence of an event.

Detail Leaf Classes

QtOrganizer5::AudibleReminder

The AudibleReminder element contains information about an audible reminder of an item.

QtOrganizer5::Classification

The Classification element contains classification-information of an item.

QtOrganizer5::Comment

The Comment element contains the comment text of an organizer item.

QtOrganizer5::Description

The Description element contains the description text of an organizer item.

QtOrganizer5::EmailReminder

The EmailReminder element contains information about an email reminder of an item.

QtOrganizer5::EventAttendee

The EventAttendee element contains information about an attendee of an event.

QtOrganizer5::EventRsvp

The EventRsvp element contains Rsvp-information of an event.

QtOrganizer5::EventTime

The EventTime element contains the start and end dates and times of a recurring event series, or occurrence of an event.

QtOrganizer5::ExtendedDetail

The ExtendedDetail element contains a extended detail of an organizer item.

QtOrganizer5::Guid

The Guid element contains the GUID string of an organizer item.

QtOrganizer5::ItemType

The ItemType element contains the type of an organizer item.

QtOrganizer5::JournalTime

The JournalTime element contains the entry date and time of a journal item.

QtOrganizer5::Location

The Location element contains information about a location which is related to the organizer item in some manner.

QtOrganizer5::Parent

The Parent element contains information about the event or todo that generated this item.

QtOrganizer5::Priority

The Priority element contains the priority of the organizer item, which may be used to resolve scheduling conflicts.

QtOrganizer5::QtOrganizer::DisplayLabel

The DisplayLabel element contains the display label of an organizer item.

QtOrganizer5::Recurrence

The Recurrence element contains a list of rules and dates on which the recurrent item occurs, and a list of rules and dates on which exceptions occur.

QtOrganizer5::Reminder

The Reminder element contains information about when and how the user wants to reminded of the item.

QtOrganizer5::Tag

The Tag element contains the tag string of an organizer item.

QtOrganizer5::Timestamp

The Timestamp element contains the created and last modified timestamp of an organizer item's creating date and time.

QtOrganizer5::TodoProgress

The TodoProgress element contains information about the progress of a todo item.

QtOrganizer5::TodoTime

The TodoTime element contains the start and due dates and times of a recurring todo series, or occurrence of an todo item.

QtOrganizer5::Version

The Version element contains versioning information of an organizer item.

QtOrganizer5::VisualReminder

The VisualReminder element contains information about a visual reminder of an item.

Item Selection And Sorting

QtOrganizer5::CollectionFilter

The CollectionFilter element provides a filter based around the collection one organizer item belongs to.

QtOrganizer5::DetailFilter

The DetailFilter element provides a filter based around a detail value criterion.

QtOrganizer5::DetailRangeFilter

The DetailRangeFilter element provides a filter based around a detail value range criterion.

QtOrganizer5::IdFilter

The IdFilter element provides a filter based around a list of organizer item IDs.

QtOrganizer5::IntersectionFilter

The IntersectionFilter element provides a filter which intersects the results of other filters.

QtOrganizer5::InvalidFilter

the InvalidFilter element provides a filter which will never match any organizer items.

QtOrganizer5::QtOrganizer::FetchHint

The FetchHint element provides hints to the manager about which organizer item information needs to be retrieved in an asynchronous fetch request or a synchronous function call.

QtOrganizer5::SortOrder

The SortOrder element defines how a list of organizer item should be ordered according to some criteria.

QtOrganizer5::UnionFilter

The UnionFilter element provides a filter which unions the results of other filters.

Examples

The following sample applications show examples of API usage:

Tutorials

The following tutorials are useful to work through the use of the Qt Quick Organizer API::

© 2012 Nokia Corporation and/or its subsidiaries. Documentation contributions included herein are the copyrights of their respective owners.


The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.

Documentation sources may be obtained from www.qt-project.org.


Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
Developpez.com

Nous contacter

Participez

Informations légales

 
Services

Forum Qt

Blogs

Hébergement

 
Partenaires

Hébergement Web