Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Item Finder API

From Wiki
Jump to: navigation, search
Article Metadata
Code ExampleArticle
Created: ltomuta (16 Jun 2007)
Last edited: hamishwillee (30 May 2013)

Note.pngNote: :This API is not part of the public SDK. It can be found in the SDK API Plug-in.


Plugin utility used for automatic tags ( http, email, phone numbers )


#include <aknitemfinder.h>

Note.pngNote: :In S60 5th edition extensions plug-in, the API is changed to CItemFinder and the same can be located at epoc32\include\itemfinder.h

Use cases

The CAKnItemFinder class provides the functionality of highlighting, selecting and retrieving items like phone number, URL, http address in text viewer editors.

Example code

iAutoFinder = CAknItemFinder::NewL(); 
//Must be called before editor creation in order to have effect
iAutoFinder->SetFindModeL(CAknItemFinder::EPhoneNumber |
CAknItemFinder::EUrlAddress |
CAknItemFinder::EEmailAddress );
iAutoFinder->SetEditor((CEikRichTextEditor**)&iDialText); // iDial is any editor.

The following code is used to scroll down for the found items through the editor

TBool iReturn = iAutoFinder->NextItemOrScrollL( CAknItemFinder::ENextDown );

The following code is used to retrieve the selected item.

HBufC* iBuff = iAutoFinder->CurrentItem().iItemDescriptor;

Sample Application

This page was last modified on 30 May 2013, at 04:34.
52 page views in the last 30 days.