javaextensions/pim/cntadapter/inc.s60/cpimcontactlistadapter.h
changeset 76 4ad59aaee882
parent 23 98ccebc37403
child 83 26b2b12093af
child 87 1627c337e51e
equal deleted inserted replaced
69:773449708c84 76:4ad59aaee882
   193      * list adapter may then release all resources it has reserved.
   193      * list adapter may then release all resources it has reserved.
   194      * No method of the list adapter can be invoked after call to Close.
   194      * No method of the list adapter can be invoked after call to Close.
   195      */
   195      */
   196     void Close();
   196     void Close();
   197 
   197 
   198     void DoClose();
   198     void CPIMContactListAdapter::DoClose();
   199 
   199 
   200 public: // MPIMContactListAdapter
   200 public: // MPIMContactListAdapter
   201 
   201 
   202     /**
   202     /**
   203      * Provides access to the \ref MPIMListAdapter representation of this
   203      * Provides access to the \ref MPIMListAdapter representation of this
   221      * The method leaves on error. Such error always means that the list
   221      * The method leaves on error. Such error always means that the list
   222      * adapter is non-functional.
   222      * adapter is non-functional.
   223      */
   223      */
   224     void CreateContactItemL(MPIMContactItem& aContactItem);
   224     void CreateContactItemL(MPIMContactItem& aContactItem);
   225 
   225 
   226     void DoCreateContactItemL(MPIMContactItem& aContactItem);
   226     void CPIMContactListAdapter::DoCreateContactItemL(
       
   227         MPIMContactItem& aContactItem);
   227 
   228 
   228     /**
   229     /**
   229      * Reads an existing contact item from the native database.
   230      * Reads an existing contact item from the native database.
   230      * The adapter maps the Item ID in \a aContactItem to a native database
   231      * The adapter maps the Item ID in \a aContactItem to a native database
   231      * entry identifier, reads the entry and sets the data of
   232      * entry identifier, reads the entry and sets the data of
   246      *        native database.
   247      *        native database.
   247      * @li Other - The list adapter is non-functional.
   248      * @li Other - The list adapter is non-functional.
   248      */
   249      */
   249     void ReadContactItemL(MPIMContactItem& aContactItem);
   250     void ReadContactItemL(MPIMContactItem& aContactItem);
   250 
   251 
   251     void DoCallReadContactItemL(MPIMContactItem& aContactItem);
   252     void CPIMContactListAdapter::DoCallReadContactItemL(
       
   253         MPIMContactItem& aContactItem);
   252 
   254 
   253     /**
   255     /**
   254      * Reads an existing contact item from the native database
   256      * Reads an existing contact item from the native database
   255      * This version reads only minimal contact item data and should be used
   257      * This version reads only minimal contact item data and should be used
   256      * when listing contacts through the API. Contacts Model view definition
   258      * when listing contacts through the API. Contacts Model view definition
   267      *        be retrieved, although the Item ID of \a aContactItem is not
   269      *        be retrieved, although the Item ID of \a aContactItem is not
   268      *        \ref KPIMNullItemID. The entry is probably removed from the
   270      *        \ref KPIMNullItemID. The entry is probably removed from the
   269      *        native database.
   271      *        native database.
   270      * @li Other - The list adapter is non-functional.
   272      * @li Other - The list adapter is non-functional.
   271      */
   273      */
   272     void ReadMinimalContactItemL(MPIMContactItem& aContactItem);
   274     void ReadMinimalContactItemL(
   273 
   275         MPIMContactItem& aContactItem);
   274     void DoCallReadMinimalContactItemL(MPIMContactItem& aContactItem);
   276 
       
   277     void CPIMContactListAdapter::DoCallReadMinimalContactItemL(
       
   278         MPIMContactItem& aContactItem);
   275 
   279 
   276     /**
   280     /**
   277      * Reads an existing contact item from the native database
   281      * Reads an existing contact item from the native database
   278      * This version reads only minimal contact item data and should be used
   282      * This version reads only minimal contact item data and should be used
   279      * when listing contacts through the API. This version takes a matching
   283      * when listing contacts through the API. This version takes a matching
   309      *        from the database
   313      *        from the database
   310      */
   314      */
   311     void ReadContactFieldL(MPIMContactItem& aContactItem,
   315     void ReadContactFieldL(MPIMContactItem& aContactItem,
   312                            TPIMContactField aContactField);
   316                            TPIMContactField aContactField);
   313 
   317 
   314     void DoReadContactFieldL(
   318     void CPIMContactListAdapter::DoReadContactFieldL(
   315         MPIMContactItem& aContactItem,
   319         MPIMContactItem& aContactItem,
   316         TPIMContactField aContactField);
   320         TPIMContactField aContactField);
   317 
   321 
   318     /**
   322     /**
   319      * Writes an existing contact item to the native database.
   323      * Writes an existing contact item to the native database.
   337      *        client. The operation may succeed later.
   341      *        client. The operation may succeed later.
   338      * @li Other - The list adapter is non-functional.
   342      * @li Other - The list adapter is non-functional.
   339      */
   343      */
   340     void WriteContactItemL(MPIMContactItem& aContactItem);
   344     void WriteContactItemL(MPIMContactItem& aContactItem);
   341 
   345 
   342     void DoWriteContactItemL(MPIMContactItem& aContactItem);
   346     void CPIMContactListAdapter::DoWriteContactItemL(
       
   347         MPIMContactItem& aContactItem);
   343 
   348 
   344     /**
   349     /**
   345      * Removes an existing contact from the native database.
   350      * Removes an existing contact from the native database.
   346      * The adapter maps \a aItemID to a native database entry and removes
   351      * The adapter maps \a aItemID to a native database entry and removes
   347      * it.
   352      * it.
   408      *
   413      *
   409      * @param aContactItem PIM Contact item to which the data is read
   414      * @param aContactItem PIM Contact item to which the data is read
   410      * @param aContactItemViewDef View definition which is used for
   415      * @param aContactItemViewDef View definition which is used for
   411      *        reading the contact item from the database
   416      *        reading the contact item from the database
   412      */
   417      */
   413     void DoReadContactItemL(
   418     void CPIMContactListAdapter::DoReadContactItemL(
   414         MPIMContactItem& aContactItem,
   419         MPIMContactItem& aContactItem,
   415         const CContactItemViewDef& aContactItemViewDef);
   420         const CContactItemViewDef& aContactItemViewDef);
   416 
   421 
   417     void IsDatabaseReadyL();
   422     void IsDatabaseReadyL();
   418 
   423