AknFind Class Reference

#include <mw/AknUtils.h>

class AknFind

Public Member Functions
IMPORT_C TKeyResponse	HandleFindOfferKeyEventL(const TKeyEvent &, TEventCode, CCoeControl , CEikListBox , CAknSearchField *, TBool, TBool &)
void	HandleFindPaneVisibility(CAknSearchField *, TBool, TBool, TBool &)
IMPORT_C void	HandleFindPopupProcessCommandL(TInt, CEikListBox , CAknSearchField , CCoeControl *)
IMPORT_C void	HandleFindSizeChanged(CCoeControl , CEikListBox , CAknSearchField *, TBool, TInt, TInt, TInt, TInt)
IMPORT_C void	HandleFindSizeChangedLayouts(CCoeControl , CEikListBox , CAknSearchField *, const TAknWindowLineLayout &, const TAknWindowLineLayout &, TBool, const TAknWindowLineLayout &)
IMPORT_C void	HandleFixedFindSizeChanged(CCoeControl , CAknColumnListBox , CAknSearchField *)
IMPORT_C void	HandlePopupFindSizeChanged(CCoeControl , CEikListBox , CAknSearchField *)
IMPORT_C TBool	IsAdaptiveFindMatch(const TDesC &, const TDesC &, HBufC *&)
IMPORT_C TBool	IsFindMatch(const TDesC &, const TDesC &)
IMPORT_C TBool	IsFindWordSeparator(TChar)
IMPORT_C void	UpdateItemTextAccordingToFlag(const TDesC &, TBitFlags32, TDes &)
IMPORT_C void	UpdateNextCharsFromString(HBufC *&, const TDesC &)
void	UpdateNextCharsL(HBufC *&, TChar)
void	UpdateNextCharsL(HBufC *&, const TDesC &)

Detailed Description

This class implements find requirements from component specifications. This class works also as documentation of how to use different find components. (The implementation has been copied from the example application which implements find and replaced the code with calls to these static functions).

There is no reason for an application to use this class directly. Application should use CAknSelectionListDialog instead. This class is public only because sometimes it is necessary to access the low level behaviour of find to implement similar functionality in places independent of find; or if CAknSelectionListDialog is not used for some reason.

Member Function Documentation

HandleFindOfferKeyEventL ( const TKeyEvent &, TEventCode, CCoeControl , CEikListBox , CAknSearchField *, TBool, TBool & )

IMPORT_C TKeyResponse	HandleFindOfferKeyEventL	(	const TKeyEvent &	aKeyEvent,
			TEventCode	aType,
			CCoeControl *	aListBoxParent,
			CEikListBox *	aListBox,
			CAknSearchField *	aSearchField,
			TBool	isFindPopup,
			TBool &	aNeedRefresh
		)	[static]

HandleFindPaneVisibility ( CAknSearchField *, TBool, TBool, TBool & )

void	HandleFindPaneVisibility	(	CAknSearchField *	aSearchField,
			TBool	ispopup,
			TBool	textchanged,
			TBool &	aNeedRefresh
		)	[static]

Helper function to handle find pane's visibility.

Parameter	Description
aSearchField	Pointer to search field control.
ispopup	ETrue if popup find pane, EFalse if normal find pane.
textchanged	ETrue when text in CAknSearchField has changed.
aNeedRefresh	ETrue when find pane is redrawn.

HandleFindPopupProcessCommandL ( TInt, CEikListBox , CAknSearchField , CCoeControl * )

IMPORT_C void	HandleFindPopupProcessCommandL	(	TInt	aCommand,
			CEikListBox *	aListBox,
			CAknSearchField *	aSearchField,
			CCoeControl *	aParentControl
		)	[static]

HandleFindSizeChanged ( CCoeControl , CEikListBox , CAknSearchField *, TBool, TInt, TInt, TInt, TInt )

IMPORT_C void	HandleFindSizeChanged	(	CCoeControl *	aParentControl,
			CEikListBox *	aListBox,
			CAknSearchField *	aSearchField,
			TBool	ispopup = ETrue,
			TInt	aFindWindowResourceId = R_AVKON_POPUP_FIND_WINDOW,
			TInt	aListAreaId = R_AVKON_LIST_GEN_PANE,
			TInt	aListResourceIdWithFindPopup = R_AVKON_LIST_GEN_PANE_WITH_FIND_POPUP,
			TInt	aFindWindowParentResourceId = R_AVKON_MAIN_PANE_WITH_STATUS_PANE
		)	[static]

HandleFindSizeChangedLayouts ( CCoeControl , CEikListBox , CAknSearchField *, const TAknWindowLineLayout &, const TAknWindowLineLayout &, TBool, const TAknWindowLineLayout & )

IMPORT_C void	HandleFindSizeChangedLayouts	(	CCoeControl *	aParentControl,
			CEikListBox *	aListBox,
			CAknSearchField *	aSearchField,
			const TAknWindowLineLayout &	aFindWindow,
			const TAknWindowLineLayout &	aListArea,
			TBool	aIsPopup,
			const TAknWindowLineLayout &	aFindWindowParent
		)	[static]

Creates layout for a find pane and for a list. This method must be called in SizeChanged() method of an container.

Since: 2.6

Parameter	Description
aParentControl	Parent control.
aListBox	Pointer to listbox control.
aSearchField	Pointer to search field control.
aFindWindow	LAF specific table line for find window.
aListArea	LAF specific table for list box area.
aIsPopup	ETrue if popup find pane, EFalse if normal find pane.
aFindWindowParent	LAF specific table line for find parent.

HandleFixedFindSizeChanged ( CCoeControl , CAknColumnListBox , CAknSearchField * )

IMPORT_C void	HandleFixedFindSizeChanged	(	CCoeControl *	aParentControl,
			CAknColumnListBox *	aListBox,
			CAknSearchField *	aSearchField
		)	[static]

This is the new typesafe (and easier to use) version of HandleFindSizeChanged(). Use this instead of (deprecated) HandleFindSizeChanged().

Parameter	Description
aParentControl	Parent control.
aListBox	Column list, optional and available only with column lists.
aSearchField	Pointer to search field control.

HandlePopupFindSizeChanged ( CCoeControl , CEikListBox , CAknSearchField * )

IMPORT_C void	HandlePopupFindSizeChanged	(	CCoeControl *	aParentControl,
			CEikListBox *	aListBox,
			CAknSearchField *	aSearchField
		)	[static]

This is the new typesafe(and easier to use) version of HandleFindSizeChanged(). Use this instead of (deprecated) HandleFindSizeChanged().

Parameter	Description
aParentControl	Parent control.
aListBox	Pointer to listbox control.
aSearchField	Pointer to search field control.

IsAdaptiveFindMatch ( const TDesC &, const TDesC &, HBufC *& )

IMPORT_C TBool	IsAdaptiveFindMatch	(	const TDesC &	aItemText,
			const TDesC &	aSearchText,
			HBufC *&	aNextChars
		)	[static]

Checks if aItemText matches aSearchText. Calls UpdateNextCharsL() if findutil is not supported.

Since: 5.0

Parameter	Description
aItemText	List box item text.
aSearchText	Searched text.
aNextChars	Reference to the next characters for the adaptive search grid The HBufC buffer may be re-allocated by this method. In that case the pointer reference is modified to point to the re-allocated object.

Returns: ETrue if list box item text aItemText matches aSearchText otherwise EFalse.

IsFindMatch ( const TDesC &, const TDesC & )

IMPORT_C TBool	IsFindMatch	(	const TDesC &	aItemText,
			const TDesC &	aSearchText
		)	[static]

Checks if aItemText matches aSearchText.

Parameter	Description
aItemText	List box item text.
aSearchText	Searched text.

Returns: ETrue if list box item text aItemText matches aSearchText otherwise EFalse.

IsFindWordSeparator ( TChar )

IMPORT_C TBool

IsFindWordSeparator

(

TChar

aCh

)

[static]

Tests if aCh is a word separator character as described in S60.

Parameter	Description
aCh	Comperative character.

Returns: ETrue if aCh is a word separator character as described in S60 otherwise EFalse.

UpdateItemTextAccordingToFlag ( const TDesC &, TBitFlags32, TDes & )

IMPORT_C void	UpdateItemTextAccordingToFlag	(	const TDesC &	aInputText,
			TBitFlags32	aColumnFlag,
			TDes &	aOutText
		)	[static]

Update next chars from the list box item text according to the bitflag. Use to exclude columns from the listbox string. For example icon index columns.

Since: 5.0

Parameter	Description
aInputText	List box item text
aColumnFlag	The bit flag shows which columns take into account
aOutText	Updated list box item text accoding to bit flag

UpdateNextCharsFromString ( HBufC *&, const TDesC & )

IMPORT_C void	UpdateNextCharsFromString	(	HBufC *&	aNextChars,
			const TDesC &	aItemString
		)	[static]

Update next chars from the list box item text, when search field if empty. This need to be done for update next characters for adaptive grid works faster then calling IsAdaptiveFindMatch().

Since: 5.0

Parameter	Description
aNextChars	Reference to the next characters for the adaptive search grid The HBufC buffer may be re-allocated by this method. In that case the pointer reference is modified to point to the re-allocated object.
aItemString	List box item text.

UpdateNextCharsL ( HBufC *&, TChar )

void	UpdateNextCharsL	(	HBufC *&	aNextChars,
			TChar	aCh
		)	[static]

Update next characters if find pane state was changed.

Since: 5.0

Parameter	Description
aNextChars	Next characters for the adaptive search grid
aCh	Criteria from the search field.

UpdateNextCharsL ( HBufC *&, const TDesC & )

void	UpdateNextCharsL	(	HBufC *&	aNextChars,
			const TDesC &	aItemString
		)	[static]

For Devanagari adaptive search Update next characters if find pane state was changed.

Since: 5.0

Parameter	Description
aNextChars	reference to the next characters for the adaptive search grid
aItemString	string we are searching.