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  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QOrganizerItem Class Reference

The QOrganizerItem class represents an event, todo, note, or journal entry More...

 #include <QOrganizerItem>

Inherited by QOrganizerEvent, QOrganizerEventOccurrence, QOrganizerJournal, QOrganizerNote, QOrganizerTodo, and QOrganizerTodoOccurrence.

Public Functions

QOrganizerItem ()
QOrganizerItem ( const QOrganizerItem & other )
~QOrganizerItem ()
void addComment ( const QString & comment )
void clearComments ()
void clearDetails ()
QOrganizerCollectionId collectionId () const
QStringList comments () const
QString description () const
QOrganizerItemDetail detail ( const QString & definitionName ) const
QOrganizerItemDetail detail ( const QLatin1Constant & definitionName ) const
T detail () const
QList<QOrganizerItemDetail> details ( const QString & definitionName = QString() ) const
QList<QOrganizerItemDetail> details ( const QString & definitionName, const QString & fieldName, const QString & value ) const
QList<QOrganizerItemDetail> details ( const QLatin1Constant & definitionName ) const
QList<QOrganizerItemDetail> details ( const QLatin1Constant & definitionName, const QLatin1Constant & fieldName, const QString & value )
QList<T> details () const
QList<T> details ( const QString & fieldName, const QString & value ) const
QString displayLabel () const
QString guid () const
QOrganizerItemId id () const
bool isEmpty () const
bool removeDetail ( QOrganizerItemDetail * detail )
bool saveDetail ( QOrganizerItemDetail * detail )
void setCollectionId ( const QOrganizerCollectionId & collectionId )
void setDescription ( const QString & description )
void setDescription ( const QOrganizerItemDescription & description )
void setDisplayLabel ( const QString & label )
void setDisplayLabel ( const QOrganizerItemDisplayLabel & label )
void setGuid ( const QString & guid )
void setId ( const QOrganizerItemId & id )
void setType ( const QString & type )
void setType ( const QOrganizerItemType & type )
QString type () const
bool operator!= ( const QOrganizerItem & other ) const
QOrganizerItem & operator= ( const QOrganizerItem & other )
bool operator== ( const QOrganizerItem & other ) const

Related Non-Members

uint qHash ( const QOrganizerItem & key )

Macros

Q_DECLARE_CUSTOM_ORGANIZER_ITEM

Detailed Description

The QOrganizerItem class represents an event, todo, note, or journal entry

A QOrganizerItem object has an id and a collection of details (like a start date and location), as well as a collection id which identifies which QOrganizerCollection the item is part of in a manager. Each detail (which can have multiple fields) is stored in an appropriate subclass of QOrganizerItemDetail, and the QOrganizerItem allows retrieving these details in various ways.

Most clients will want to use the convenient subclasses of QOrganizerItem (i.e., QOrganizerEvent (and QOrganizerEventOccurence), QOrganizerTodo (and QOrganizerTodoOccurence), QOrganizerJournal and QOrganizerNote) instead of manipulating instances of QOrganizerItem directly.

A QOrganizerItem instance represents the in-memory version of a calendar organizer item. It is possible for the contents of a QOrganizerItem to change independently of the contents that are stored persistently in a QOrganizerManager. A QOrganizerItem has an id associated with it when it is first retrieved from a QOrganizerManager, or after it has been first saved, and this allows clients to track changes using the signals in QOrganizerManager. When saved in a manager, every item is placed into a QOrganizerCollection in that manager, according to the collection id set in the item prior to save (or the default collection if no collection id was set in the item).

Different QOrganizerManagers may require an item to have certain details saved in it before it can be stored in that manager. By default, every item must have a QOrganizerItemType detail which identifies the type of the item. Different subclasses of QOrganizerItem (i.e., QOrganizerEvent (and QOrganizerEventOccurence), QOrganizerTodo (and QOrganizerTodoOccurence), QOrganizerJournal and QOrganizerNote) may have other mandatory details, depending on the manager.

See also QOrganizerManager and QOrganizerItemDetail.

Member Function Documentation

QOrganizerItem::QOrganizerItem ()

Construct an empty organizer item.

The organizer item will have an empty display label, an empty id, and an empty description and have type QOrganizerItemType::TypeNote. The isEmpty() function will return true.

QOrganizerItem::QOrganizerItem ( const QOrganizerItem & other )

Initializes this QOrganizerItem from other

QOrganizerItem::~QOrganizerItem ()

Frees the memory used by this QOrganizerItem

void QOrganizerItem::addComment ( const QString & comment )

Adds the comment comment to this item

void QOrganizerItem::clearComments ()

Clears the comments (arbitrary notes) about this item

void QOrganizerItem::clearDetails ()

Removes all details of the organizer item. This function does not modify the id or type of the organizer item. Calling isEmpty() after calling this function will return true. The empty item becomes a QOrganizerNote.

QOrganizerCollectionId QOrganizerItem::collectionId () const

Returns the id of the collection which this item is part of, in the manager in which the item has been saved, if the item has previously been saved in a manager. If the item has not previously been saved in a manager, this function will return the id of the collection into which the client wishes the item to be saved when QOrganizerManager::saveItem() is called, which is set by calling setId(); otherwise, returns a null id.

An item always belongs to exactly one collection in a particular manager after it has been saved in the manager. If the item has previously been saved in the manager, in a particular collection, and the client sets the collection id of the item to the id of a different collection within that manager and then resaves the item, the item will be moved from its original collection into the specified collection if the move operation is supported by the manager; otherwise, the QOrganizerManager::saveItem() operation will fail and calling QOrganizerManager::error() will return QOrganizerManager::NotSupportedError.

See also setCollectionId().

QStringList QOrganizerItem::comments () const

Returns the list of comments (or arbitrary notes about the item) which pertain to this item

QString QOrganizerItem::description () const

Returns the human-readable description of the item

See also setDescription().

QOrganizerItemDetail QOrganizerItem::detail ( const QString & definitionName ) const

Returns the first detail stored in the organizer item with the given definitionName

QOrganizerItemDetail QOrganizerItem::detail ( const QLatin1Constant & definitionName ) const

Returns the first detail stored in the organizer item which with the given definitionName. The definitionName argument is typically the detail name constant provided by a specific subclass of QOrganizerItemDetail.

It would usually be more convenient to use the template version of this function.

T QOrganizerItem::detail () const

Returns the first detail of the template parameter type, as returned by the template details() function. The type must be a subclass of QOrganizerItemDetail.

QList<QOrganizerItemDetail> QOrganizerItem::details ( const QString & definitionName = QString() ) const

Returns a list of details with the given definitionName The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g. QOrganizerItemPhoneNumber::DefinitionName) or by requesting a list of all the definition names using detailDefinitions() or the asynchronous definitionNames().

QList<QOrganizerItemDetail> QOrganizerItem::details ( const QString & definitionName, const QString & fieldName, const QString & value ) const

Returns a list of details of the given definitionName, with fields named fieldName and with value value. The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g. QOrganizerItemPhoneNumber::DefinitionName) or by requesting a list of all the definition names using detailDefinitions() or the asynchronous definitionNames().

QList<QOrganizerItemDetail> QOrganizerItem::details ( const QLatin1Constant & definitionName ) const

Returns a list of details of the given definitionName.

The definitionName argument is typically the detail name constant provided by a specific subclass of QOrganizerItemDetail.

It would usually be more convenient to use the template version of this function.

QList<QOrganizerItemDetail> QOrganizerItem::details ( const QLatin1Constant & definitionName, const QLatin1Constant & fieldName, const QString & value )

Returns a list of details of the given definitionName, with fields named fieldName and with value value.

QList<T> QOrganizerItem::details () const

Returns a list of details of the template parameter type. The type must be a subclass of QOrganizerItemDetail.

QList<T> QOrganizerItem::details ( const QString & fieldName, const QString & value ) const

Returns a list of details of the template parameter type which have field called fieldName, with matching value. The type must be a subclass of QOrganizerItemDetail.

QString QOrganizerItem::displayLabel () const

Returns the display label of the item

See also setDisplayLabel().

QString QOrganizerItem::guid () const

Returns the globally unique identifier which identifies this item, which is used for synchronization purposes.

See also setGuid().

QOrganizerItemId QOrganizerItem::id () const

Returns the QOrganizerItemId that identifies this organizer item.

This may have been set when the organizer item was retrieved from a particular manager, or when the organizer item was first saved in a manager. The QOrganizerItemId is only valid within a specific manager. See QOrganizerManager::saveItem() for more information.

See also setId().

bool QOrganizerItem::isEmpty () const

Returns true if this QOrganizerItem is empty, false if not.

An empty QOrganizerItem has an empty label and no extra details. The type of the organizer item is irrelevant.

bool QOrganizerItem::removeDetail ( QOrganizerItemDetail * detail )

Removes the detail from the organizer item.

The detail in the organizer item which has the same key as that of the given detail will be removed if it exists. Only the key is used for comparison - that is, the information in the detail may be different.

If the detail's access constraint includes QOrganizerItemDetail::Irremovable, this function will return false.

Returns true if the detail was removed successfully, false if an error occurred.

Note that the caller retains ownership of the detail.

bool QOrganizerItem::saveDetail ( QOrganizerItemDetail * detail )

Saves the given detail in the list of stored details, and sets the detail's id. If another detail of the same type and id has been previously saved in this organizer item, that detail is overwritten. Otherwise, a new id is generated and set in the detail, and the detail is added to the organizer item.

If the detail's access constraint includes QOrganizerItemDetail::ReadOnly, this function will return true and save the detail in the organizer item, however attempting to save the organizer item in a manager may fail (if that manager decides that the read only detail should not be updated). Details with the QOrganizerItemDetail::ReadOnly constraint set are typically provided in a organizer item by the manager, and are usually information that is either synthesized, or not intended to be changed by the user (e.g. presence information for other organizer items).

If detail is a QOrganizerItemType, the existing organizer item type will be overwritten with detail. There is never more than one organizer item type in a organizer item.

Returns true if the detail was saved successfully, otherwise returns false.

Note that the caller retains ownership of the detail.

void QOrganizerItem::setCollectionId ( const QOrganizerCollectionId & collectionId )

Sets the id of the collection into which the client wishes the item to be saved to the given collectionId.

If the given collectionId is the null collection id, the client is specifying that the item should be saved into the collection in which the item is already saved (if the item has previously been saved in the manager, without having been removed since), or into the default collection of the manager (if the item has not previously been saved in the manager, or has been removed since the last time it was saved).

If the item has previously been saved in a particular manager, and the given collectionId is the id of a different collection than the one which the item is currently a part of in that manager, saving the item with QOrganizerManager::saveItem() will move the item from its original collection to the collection whose id is collectionId, if collectionId identifies a valid collection and the operation is supported by the manager.

See also collectionId().

void QOrganizerItem::setDescription ( const QString & description )

Sets the human-readable description of the item to description

See also description().

void QOrganizerItem::setDescription ( const QOrganizerItemDescription & description )

Sets the human-readable description of the item to description

void QOrganizerItem::setDisplayLabel ( const QString & label )

Sets the display label of the item to label

See also displayLabel().

void QOrganizerItem::setDisplayLabel ( const QOrganizerItemDisplayLabel & label )

Sets the display label of the item to label

void QOrganizerItem::setGuid ( const QString & guid )

Sets the item's globally unique identifier to guid

See also guid().

void QOrganizerItem::setId ( const QOrganizerItemId & id )

Sets the id of this organizer item to id.

Note that this only affects this object, not any corresponding structures stored by a QOrganizerManager.

If you change the id of a organizer item and save the organizer item in a manager, the previously existing organizer item will still exist. You can do this to create copies (possibly modified) of an existing organizer item, or to save a organizer item in a different manager.

See also id() and QOrganizerManager::saveItem().

void QOrganizerItem::setType ( const QString & type )

Sets the type of the organizer item to the given type.

See also type().

void QOrganizerItem::setType ( const QOrganizerItemType & type )

Sets the type of the organizer item to the given type detail.

QString QOrganizerItem::type () const

Returns the type of the organizer item. Every organizer item has exactly one type which is either set manually (by saving a modified copy of the QOrganizerItemType in the organizer item, or by calling setType()) or synthesized automatically.

See also setType().

bool QOrganizerItem::operator!= ( const QOrganizerItem & other ) const

Returns true if this organizer item's id or details are different to those of the other organizer item.

QOrganizerItem & QOrganizerItem::operator= ( const QOrganizerItem & other )

Replace the contents of this QOrganizerItem with other

bool QOrganizerItem::operator== ( const QOrganizerItem & other ) const

Returns true if this organizer item is equal to the other organizer item, false if either the id, collection id or stored details are not the same

Related Non-Members

uint qHash ( const QOrganizerItem & key )

Returns the hash value for key.

Macro Documentation

Q_DECLARE_CUSTOM_ORGANIZER_ITEM

Macro for simplifying declaring convenience leaf classes for QOrganizerItem.

The first argument is the name of the class, and the second argument is a Latin-1 string literal naming the item type.

If you are creating a convenience class for a type of QOrganizerItem, you should use this macro when declaring your class to ensure that it interoperates with other organizer item functionality.

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.

[0]; s.parentNode.insertBefore(ga, s); })();
Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
  2. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  3. RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
  4. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 12
  5. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
Page suivante

Le Qt Developer Network au hasard

Logo

La création de colonnes dans une ListView en QML

Le Qt Developer Network est un réseau de développeurs Qt anglophone, où ils peuvent partager leur expérience sur le framework. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

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 qtmobility-1.1
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 !
 
 
 
 
Partenaires

Hébergement Web