1 touchlogicalfeedback.h

     1 /*

     2 * Copyright (c) 2007-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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Logical feedback type enumeration. 

    15 *

    16 */

    17 

    18 

    19 #ifndef T_TOUCHLOGICALFEEDBACK_H

    20 #define T_TOUCHLOGICALFEEDBACK_H

    21 

    22 

    23 

    24 #include <e32std.h>

    25 

    26 

    27 /**  

    28  *  Pointer event types, that can be used when registering

    29  *  areas to registry. Currently only stylus down event 

    30  *  is supported (this means that there will be feedback 

    31  *  whenever stylus down event is received on registered

    32  *  area, no matter what happens _after_ stylus down event).

    33  */

    34 enum TTouchEventType

    35     {

    36     ETouchEventStylusDown

    37     };

    38 

    39     

    40 /**  

    41  *  Logical feedback types, that can be used when producing direct

    42  *  feedback, or when registering areas to area registry.

    43  *

    44  *  Notice, that client application cannot decide the actual physical

    45  *  feedback that shall be generated. It depends on device configuration,

    46  *  and current settings. In current devices the user changeable settings

    47  *  includes vibra and sound feedbacks.

    48  *

    49  *  Instructions for using these feedback types:

    50  *

    51  *  ETouchFeedbackNone      - Use for disabling feedback for some areas of

    52  *                            window when using area registry.

    53  *

    54  *  ETouchFeedbackBasic     - Use as default feedback for pen down events.

    55  *                            For example, pressing a button or tab.

    56  *

    57  *  ETouchFeedbackSensitive - Sensitive feedback for those situations,

    58  *                            where the triggering action is not very 

    59  *                            important (e.g. change focus in list), or when

    60  *                            there can be a large amount of feedbacks in

    61  *                            a short time (e.g. text selection which gives

    62  *                            feedback on every new selected character).

    63  *                            Also used for scrolling and dragging.

    64  *

    65  */

    66 enum TTouchLogicalFeedback

    67     {

    68     ETouchFeedbackNone,

    69     ETouchFeedbackBasic,   

    70     ETouchFeedbackSensitive

    71     };

    72 

    73 

    74 #endif // T_TOUCHLOGICALFEEDBACK_H