1 /*

     2 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Focus change interface class for sct controls.

    15 *

    16 */

    17 

    18 

    19 #ifndef AKNSCTFOCUSHANDLER_H

    20 #define AKNSCTFOCUSHANDLER_H

    21 

    22 /**

    23  *  Focus change interface class for sct controls.

    24  * *

    25  *  @lib 5.0

    26  *  @since S60 v5.0

    27  */

    28 class MAknSctFocusHandler

    29     {   

    30 public:

    31         /**

    32      	* Returns pointer to the focused control.

    33 	    *

    34      	* @since S60 5.0

    35      	* @return pointer to the focused control.

    36      	*/

    37         virtual CCoeControl* FocusedControl() = 0;

    38 

    39     	/**

    40      	* Enter control and highlight position (aX, aY).

    41     	*

    42      	* @since S60 5.0

    43      	* @param aX horizontal coordinate.

    44      	* @param aY vertical coordinate.

    45      	* @return whether entry was successful.

    46      	*/

    47         virtual TBool EnterControl(TInt aX, TInt aY) = 0;   

    48 

    49     	/**

    50      	* Move control highlight to position (aX, aY).

    51     	*

    52      	* @since S60 5.0

    53      	* @param aX horizontal coordinate.

    54      	* @param aY vertical coordinate.

    55      	*/

    56         virtual void MoveFocus(TInt aX, TInt aY) = 0;

    57 

    58 	    /**

    59      	* Return whether possible to exit control with a key.

    60     	*

    61      	* @since S60 5.0

    62      	* @param aKeycode keycode for checking exit.

    63      	* @return whether it is possible to exit with a key.

    64      	*/

    65         virtual TBool ExitWithKey(TInt aKeycode) = 0;          

    66 

    67     	/**

    68      	* Leaves focused control.

    69 	    *

    70      	* @since S60 5.0

    71      	* @return whether leave was successful.

    72      	*/

    73         virtual TBool LeaveControl() = 0;      

    74     };

    75 

    76 #endif // AKNSCTFOCUSHANDLER_H