epoc32/include/mw/touchlogicalfeedback.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 1 666f914201fb
child 4 837f303aceeb
permissions -rw-r--r--
Final list of Symbian^2 public API header files
     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