Item Finder API
Article Metadata
Code Example
Source file: Media:UseItemFinder.zip
Article
Created: ltomuta
(16 Jun 2007)
Last edited: hamishwillee
(08 May 2013)
Note: :This API is not part of the public SDK. It can be found in the SDK API Plug-in.
APIPurpose
Plugin utility used for automatic tags ( http, email, phone numbers )
Header:
#include <aknitemfinder.h>
Note: :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;
29 Sep
2009
Item Finder API are useful to highlight, select and retrieve items like phone number, URL in text viewer editors. This article demonstrates the use of Item Finder API to find item, scroll down for the found items and retrieve the selected item. Note that this API, Item Finder API, is not part of the public SDK. So you have to download it from SDK API Plug-in before using it. Furthermore, the author added a working demo project, which can be used for more detailed study of new opportunities for various kinds of experiments.
In series 60 5th edition extensions plug-in, the API is changed to CItemFinder and the same can be located at epoc32\include\itemfinder.h