Updating contact's images in S60 3rd Ed, FP2

Until S60 3rd Edition, Feature Pack 1 devices, only a thumbnail image could be assigned to a contact.

From S60 3rd Edition, Feature Pack 2 onwards, a contact also has an Image name field and an option to view the full-size image, via Image > View in contact details. When dialing a contact, a full-size image will be displayed on S60 3rd Edition, FP2 devices.

Therefore, to assign an image to a contact on S60 3rd Edition, FP2 devices, additional settings are required to update also the path to the full-size image.

 

 

 

/**
  * void AssignPicture( HBufC8* aData, TContactItemId aId )
  *
  * Updates a specified contact item (aId) with thumbnail image data (aData)
  *
  */
void CContactContainer::AssignPicture (HBufC8* aData, TContactItemId aId)
   {
   CContactDatabase* contactsDb = CContactDatabase::OpenL();
   CleanupStack::PushL( contactsDb );
 
   CContactItem* contactItem = contactsDb->OpenContactL( aId );
   CleanupStack::PushL( contactItem );
   TInt index = contactItem->CardFields().Find( KUidContactFieldPicture );
   if ( index != KErrNotFound )
     {
     contactItem->RemoveField( index );
     }
 
   CContactItemField* field;
   field = CContactItemField::NewLC( KStorageTypeStore,
                                     KUidContactFieldPicture );
   field->SetMapping( KUidContactFieldVCardMapPHOTO );
   field->AddFieldTypeL( KUidContactFieldVCardMapBMP );
   field->ResetStore();
 
   // aData contains the thumbnails image data.
   field->StoreStorage()->SetThingL( *aData );
   contactItem->AddFieldL( *field );
   CleanupStack::Pop( field );
 
   // Save and close the contacts database
   contactsDb->CommitContactL( *contactItem );
   contactsDb->CloseContactL( aId );
   CleanupStack::PopAndDestroy(2); // contactItem, contactsDb
   }
 
 
/**
  * void AssignPicturePath( const TDesC& aImagePath, TContactItemId aId )
  *
  * Updates a specified contact item (aId) with a full-size image path
  * (aImagePath)
  *
  */
void CContactContainer::AssignPicturePath( const TDesC& aImagePath,
                                            TContactItemId aId )
   {
   // create pbkengine.
   CPbkContactEngine* pbkContactEng =
       CPbkContactEngine::NewL( &iCoeEnv->FsSession());
   CleanupStack::PushL( pbkContactEng );
   // Get image field info if there is no image assigned initially
   const CPbkFieldsInfo& fieldsInfo = pbkContactEng->FieldsInfo();
   CpbkFieldInfo* pbkFieldInfo = fieldsInfo.Find( EPbkFieldIdCodImageID );
   // Open the contact item specified by aId
   CPbkContactItem* aContactItem = pbkContactEng->OpenContactL( aId );
   CleanupStack::PushL( aContactItem );
   // Get the image field info
   TPbkContactItemField* info = aContactItem->FindField( EPbkFieldIdCodImageID );
   if ( !info )
     {
      // Add the image field if it was not found
      TPbkContactItemField info = aContactItem->AddFieldL( *pbkFieldInfo );
      if( KStorageTypeText == info.StorageType() )
        {
        // set path for the new image
        CContactTextField* textstore = info.TextStorage();
        textstore->SetTextL( aImagePath );  
        }          
     }
    else
      {
      if( KStorageTypeText == info->StorageType() )
        {
        // Update with the new image path
        CContactTextField* textstore = info->TextStorage();
        textstore->SetTextL( aImagePath );  
        }    
      }
 
   // Save and close the contacts database
   pbkContactEng->CommitContactL( *aContactItem, EFalse );
   pbkContactEng->CloseContactL( aId );
   CleanupStack::PopAndDestroy( 2 ); // aContactItem, pbkContactEng
   }

 

http://wiki.forum.nokia.com/index.php/TSS001074_-_Updating_contact's_images_in_S60_3rd_Ed,_FP2_devices

Two functions are defined below. AssignPicture updates the thumbnail image for a particular contact. AssignPicturePath (needed from S60 3rd Edition, FP2 onwards) updates the path of the full-size image.