Categories: Symbian C++ | FNWiki | Code Examples

This page was last modified 08:27, 9 April 2008.

From Forum Nokia Wiki

API Purpose

Adaptive History List API can be used to keep track of the browser activity. One can retrieve the name as well as the URL of the recently visited sites.

Use cases

1. To retrieve the URL address and the name of the websites visted using the browser.These contents will be written into a file named "History.txt"
2. To clear the cache which contains the details like the URL address.

Example code

One can get to know of the recently visited links by following the steps mentioned below.

Header Files:

#include <AhleClientObserver.h> 
#include <Ahle.h>

Link against:

LIBRARY    AhleClient.lib

Capabilities Required:

CAPABILITY    ReadUserData WriteUserData

1) Derive your class from MAHLEClientObserver.

2) Create a CAhle object preferably in the constructL

iAhle  = CAHLE::NewL();
iAhle->SetObserverL(this);

3) Implement AdaptiveListChangedL( ) method. It is a pure virtual method defined in MAHLEClientObserver.

void AdaptiveListChanged(TInt aError)
{
	TRAPD(err,DoAdaptiveListChangedL())
	if(err)
	{
	//handle error here
	}
}

void DoAdaptiveListChangedL()
{
	RFs myFileSession;
	RFile myFileObject;
	
	CDesC16ArrayFlat* itemsArray = new(ELeave) CDesC16ArrayFlat(8);
	CDesC16ArrayFlat* itemsNameArray = new(ELeave) CDesC16ArrayFlat(8);
	
	CleanupStack::PushL(itemsArray);
	CleanupStack::PushL(itemsNameArray);
	
	CleanupClosePushL(myFileSession);
	CleanupClosePushL(myFileObject);
	
	myFileSession.Connect();
	
	myFileObject.Replace(myFileSession,_L("C:\\History.txt"),EFileWrite);
	
	TRAPD(err,iAhle->AdaptiveListL(*itemsArray,*itemsNameArray,TUint(100),
        _L(""),EAHLEAdaptiveSiteDetails));
	
	TBuf8<500> tempBuffer;
	//writes the recently visited links to a buffer
	for(TInt i=0;i<itemsNameArray->Count();i++)
	{
	tempBuffer.Append(itemsNameArray->MdcaPoint(i));
	tempBuffer.Append(_L8("-"));
	tempBuffer.Append(itemsArray->MdcaPoint(i));
	tempBuffer.Append(_L8("\n"));
	}
	//logs the contents of the buffer into a file
	myFileObject.Write(tempBuffer);
	
	tempBuffer.Zero();
	CleanupStack::PopAndDestroy(4);
}

4) To clear the cache which contains the browser activity details.

void ClearAdaptiveList()
{
	TInt retval;
	retval=iAhle->Clear();
		
	if(retval)
	{
	//handle error here
	}
	
}

Example Application

AHLE Example Application