fep/aknfep/UiPlugins/AknFepUiInterface/AvkonImpl/inc/AknFepUIAvkonCtrlJapaneseCandidatePane.h
/*
* Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0""
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Candidate list
*
*/
#ifndef CAKNFEPUICTRLJAPANESECANDIDATEPANE_H
#define CAKNFEPUICTRLJAPANESECANDIDATEPANE_H
// INCLUDES
#include <aknPopup.h> // CAknPopupList
#include "AknFepUICtrlCandidatePaneInterface.h"
// MAknFepUICtrlCandidatePaneInterface
// CONSTANTS
// FORWARD DECLARATIONS
// CLASS DECLARATION
class CAknFepUIManagerJapanese;
/**
* CAknFepUICtrlJapaneseCandidatePane class.
*
* @lib AknFep.lib
* @since 2.6
*/
NONSHARABLE_CLASS(CAknFepUICtrlJapaneseCandidatePane) :
public CAknPopupList,
public MAknFepUICtrlCandidatePaneInterface
{
public: // Constructors and destructor
/**
* Two-phased constructor.
*/
static CAknFepUICtrlJapaneseCandidatePane* NewL(CAknFepUIManagerJapanese* aUiMng);
/**
* Destructor.
*/
virtual ~CAknFepUICtrlJapaneseCandidatePane();
public: // New functions
/**
* Show Pop-up list
* @since 2.6
*/
void ShowWindow();
/**
* Close Pop-up list
* @since 2.6
*/
void CloseCandidateList();
/**
* Specify the cursor position of a pop-up list
* @since 2.6
* @param aItemIndex The index of the cursor position
* @param aDraw ETrue is redraw.
*/
void SetCurrentItemIndexL(TInt aItemIndex, TBool aDraw);
/**
* Specify the display position of a pop-up list
* @since 2.6
* @param aOffset Offset of a window display position
*/
void SetOffsetPosition(TPoint aOffset);
public: // Functions from MAknFepUICtrlCandidatePaneInterface
/**
* From MAknFepUICtrlCandidatePaneInterface
* Set position to display candidate list
* @since 2.6
* @param aLeftSideOfBaseLine left side of font
* @param aHeight font hight
* @param aAscent Ascent position
*/
void SetWindowPosition(const TPoint& aLeftSideOfBaseLine,
TInt aHeight,
TInt aAscent);
/**
* From MAknFepUICtrlCandidatePaneInterface
* Show candidate list popup window
* @since 2.6
* @param aItems array of candidate list
* @param aIndex selecting number when displaying
*
*/
void ShowCandidateListL(CDesCArrayFlat* aItems, TInt aIndex, TInt aResourceID=0);
/**
* From MAknFepUICtrlCandidatePaneInterface
* Hide candidate popup window
* @since 2.6
*/
void HideWindow();
/**
* From MAknFepUICtrlCandidatePaneInterface
* Return a selected candidate item number currently
* @since 2.6
*/
TInt CurrentItemIndexOfCandidate();
/**
* From MAknFepUICtrlCandidatePaneInterface
* Move a current item in an appointed direction
* @since 2.6
* @param aDirection direction
*/
TInt MoveItem(TAknFepUICtrlScroll aDirection);
protected: // Functions from CAknPopupList
/**
* From CAknPopupList Set up a window layout type
* @since 2.6
* @param aType Layout type
*/
virtual void SetupWindowLayout(AknPopupLayouts::TAknPopupLayouts aType);
/**
* From CAknPopupList Set the title for the selection list
* @since 2.6
* @param aAccept
*/
virtual void AttemptExitL(TBool aAccept);
TTypeUid::Ptr MopSupplyObject(TTypeUid aId);
/**
* from CAknPopupList of MEikCommandObserver
* @since 3.2
* @param aCommandId aCommandId Event Id from the soft-key
*/
void ProcessCommandL(TInt aCommandId);
protected: // from MEikListBoxObserver
/**
* Handle pointer up event
*
* @since S60 V3.2
* @param aListBox ListBox control
* @param aEventType
* @return None
*/
virtual void HandleListBoxEventL(CEikListBox* aListBox, TListBoxEvent aEventType);
private:
/**
* constructor.
*/
CAknFepUICtrlJapaneseCandidatePane(CAknFepUIManagerJapanese* aUiMng);
/**
* Symbian 2nd phase constructor can leave.
*/
void ConstructL();
/**
* Set the title for the selection list
* @since 2.6
* @param aTitle The character string of a title
*/
void SetTitleL(const TDesC& aTitle);
/**
* The handler function for size change
* @since 2.6
* @param aDef layout information of popup-window
* @param aHeading heading Pane object
* @param aListBox listbox object
* @param aWindowOwningControl owner control
*/
void HandleSizeChanged(TAknPopupWindowLayoutDef& aDef,
CAknPopupHeadingPane* aHeading,
CEikListBox* aListBox,
CCoeControl* aWindowOwningControl
);
/**
* The handler function for Draw
* @since 2.6
* @param aEikEnv EikEnv
* @param aGc Gc
* @param aDef layout information of popup-window
* @param aListBox listbox object
* @param aHeadingOrNull heading Pane object
*/
static void HandleDraw(CEikonEnv* aEikEnv,
CWindowGc& aGc,
const TAknPopupWindowLayoutDef& aDef,
CEikListBox* aListBox,
CAknPopupHeadingPane* aHeadingOrNull);
/**
* Set up the information on a pop-up window
* @since 2.6
* @param aDef layout information of popup-window
* @param aRect rect
* @param num total cantidate number
*/
void CalcPopupMenuWindow(TAknPopupWindowLayoutDef& aDef,
const TRect& aRect,
TInt num);
/**
* Set up the information on a pop-up window
* @since 2.6
* @param aDef layout information of popup-window
* @param num total cantidate number
* @param heading ETrue:with heading pane/ EFalse:without heading pane
*/
void SetupMenuPopupWindow(TAknPopupWindowLayoutDef& aDef,
TInt num,
TBool heading);
/**
* The handler function for size and a location
* @since 2.6
* @param aDef layout information of popup-window
* @param aContentInsidePopup
* @param aHeadingOrNull heading pane object
*/
static void HandleSizeAndPositionOfComponents(
const TAknPopupWindowLayoutDef& aDef,
CCoeControl* aContentInsidePopup,
CAknPopupHeadingPane* aHeadingOrNull);
/**
* Draws a window shadow
* @since 2.6
* @param aCoverRect the area covered by the shadow
* @param aSecondShadowRect the area used for second shadow
* @param aFirstShadowRect the area of first shadow
* @param aOutliineFrameRect the area of black outline frame
* @param aInsideAreaRect the area of content inside the window
*/
static void DrawWindowShadow(
CWindowGc& aGc,
const TAknLayoutRect& aCoverRect,
const TAknLayoutRect& aSecondShadowRect,
const TAknLayoutRect& aFirstShadowRect,
const TAknLayoutRect& aOutlineFrameRect,
const TAknLayoutRect& aInsideAreaRect);
/**
* This function returns maximum columns to be able to display in listbox, this function
* find longest candidate string in candidate list. Return 11 columns in case more than 11 columns, and minimum is 3 columns.
* @since 2.6
* @param aModel listbox model object
* @return maximum columns
*/
TInt MaximumColumns(CTextListBoxModel* aModel);
/**
* This function returns maximum rows to be able to display in listbox.
* Maximum is 7 rows and minimum is 3 columns.
* @since 2.6
* @param aModel listbox model object
* @return maximum line
*/
TInt MaximumRows(CTextListBoxModel* aModel);
/**
* Called by the framework to draw the control
* @param aRect Rectangle in which the Cone framework believes drawing
* is needed
*/
virtual void Draw(const TRect& aRect) const;
/**
* Handle key events. When a key event occurs,
* CONE calls this function for each control on the control stack,
* until one of them returns EKeyWasConsumed to indicate that
* it processed the key event.
*
* @param aKeyEvent The key event.
* @param aType The type of the event:
* EEventKey, EEventKeyUp or EEventKeyDown.
* @return Indicates whether or not the key event was used
* by this control.
*/
virtual TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent,
TEventCode aType);
/**
* show cba
* @since 2.6
*/
void ShowWindowCbaL();
/**
* Changing the cba
* @since 3.2
* @param aResourceID
*/
void UpdateCbaL(TInt aResourceID);
private: // Data
TRect iMainPaneRect;
TPoint iOffsetPosition;
TInt iSrcTextHeight;
TInt iMaximumColumns;
TInt iMaximumRows;
CAknFepUIManagerJapanese* iUiMng;
};
#endif // CAKNFEPUICTRLJAPANESECANDIDATEPANE_H
// End of File