src/hbcore/inputfw/hbinputdef.h
changeset 6 c3690ec91ef8
parent 5 627c4a0fd0e7
child 7 923ff622b8b9
equal deleted inserted replaced
5:627c4a0fd0e7 6:c3690ec91ef8
    61 Enumerates known keyboard types. Specific bits are reserved
    61 Enumerates known keyboard types. Specific bits are reserved
    62 for keyboard classes. For example all, qwerty based
    62 for keyboard classes. For example all, qwerty based
    63 keyboards have bit HbQwertyKeyboardMask set and all touch keypads have
    63 keyboards have bit HbQwertyKeyboardMask set and all touch keypads have
    64 bit HbTouchInputMask set.
    64 bit HbTouchInputMask set.
    65 */
    65 */
    66 enum HbKeyboardTypeFlag
    66 enum HbKeyboardTypeFlag {
    67 {
    67     HbKeyboardNone                          = 0x00000000,
    68     HbKeyboardNone          				= 0x00000000,
    68 
    69 
    69     HbKeyboard12Key                         = 0x00000001,       /**< Deprecated, use HbKeyboardHardwarePortrait instead. */
    70     HbKeyboard12Key         				= 0x00000001,       /**< Deprecated, use HbKeyboardHardwarePortrait instead. */
       
    71     HbKeyboardHardwarePortrait                          = HbKeyboard12Key,  /**< Hardware keyboard for portrait orientation. */
    70     HbKeyboardHardwarePortrait                          = HbKeyboard12Key,  /**< Hardware keyboard for portrait orientation. */
    72     HbKeyboardQwerty        				= 0x00000001 | HbQwertyKeyboardMask,  /**< Deprecated, use HbKeyboardHardwareLandcape instead */
    71     HbKeyboardQwerty                        = 0x00000001 | HbQwertyKeyboardMask,  /**< Deprecated, use HbKeyboardHardwareLandcape instead */
    73     HbKeyboardHardwareLandcape                          = HbKeyboardQwerty, /**< Hardware keyboard for landscape mode. */
    72     HbKeyboardHardwareLandcape                          = HbKeyboardQwerty, /**< Hardware keyboard for landscape mode. */
    74     HbKeyboardVirtual12Key  				= 0x00000001 | HbTouchInputMask,    /**< Deprecated, use HbKeyboardTouchPortrait instead. */
    73     HbKeyboardVirtual12Key                  = 0x00000001 | HbTouchInputMask,    /**< Deprecated, use HbKeyboardTouchPortrait instead. */
    75     HbKeyboardTouchPortrait                             = HbKeyboardVirtual12Key,           /**< Touch keyboard for portrait mode. */
    74     HbKeyboardTouchPortrait                             = HbKeyboardVirtual12Key,           /**< Touch keyboard for portrait mode. */
    76     HbKeyboardVirtualQwerty 				= 0x00000002 | HbTouchInputMask| HbQwertyKeyboardMask, /**< Touchscreen version of qwerty keyboard */
    75     HbKeyboardVirtualQwerty                 = 0x00000002 | HbTouchInputMask | HbQwertyKeyboardMask, /**< Touchscreen version of qwerty keyboard */
    77     HbKeyboardTouchLandscape                            = HbKeyboardVirtualQwerty, /**< Touch keyboard for landscape mode. */
    76     HbKeyboardTouchLandscape                            = HbKeyboardVirtualQwerty, /**< Touch keyboard for landscape mode. */
    78     HbKeyboardSctPortrait   				= 0x00000003 | HbTouchInputMask,                       /**< Special character selection keypad for portrait view */
    77     HbKeyboardSctPortrait                   = 0x00000003 | HbTouchInputMask,                       /**< Special character selection keypad for portrait view */
    79     HbKeyboardSctLandscape  				= 0x00000004 | HbTouchInputMask| HbQwertyKeyboardMask, /**< Special character selection keypad for landscape view */
    78     HbKeyboardSctLandscape                  = 0x00000004 | HbTouchInputMask | HbQwertyKeyboardMask, /**< Special character selection keypad for landscape view */
    80     HbKeyboardHwr           				= 0x00000005 | HbTouchInputMask| HbHwrKeyboardMask    /**< Hand writing recognition keypad */
    79     HbKeyboardHwr                           = 0x00000005 | HbTouchInputMask | HbHwrKeyboardMask,   /**< Hand writing recognition keypad */
       
    80     HbKeyboardVirtual12KeyLabels            = 0x00000006 | HbTouchInputMask                        /**< Key labels for virtual 12 key keyboard */
    81 };
    81 };
    82 
    82 
    83 Q_DECLARE_FLAGS(HbKeyboardType, HbKeyboardTypeFlag)
    83 Q_DECLARE_FLAGS(HbKeyboardType, HbKeyboardTypeFlag)
    84 
    84 
    85 /*!
    85 /*!
    86 \enum HbInputModeType
    86 \enum HbInputModeType
    87 
    87 
    88 Enumerates known input modes. Specific bits are reserved
    88 Enumerates known input modes. Specific bits are reserved
    89 for classifying different input mode types. For example, all Chinese modes
    89 for classifying different input mode types. For example, all Chinese modes
    90 have bit HbChineseModeMask set and all Japanese modes have 
    90 have bit HbChineseModeMask set and all Japanese modes have
    91 bit HbJapaneseModeMask set. HbInputModeCustom is a special case.
    91 bit HbJapaneseModeMask set. HbInputModeCustom is a special case.
    92 That input mode never appears in standard input mode set, but it must
    92 That input mode never appears in standard input mode set, but it must
    93 be activated separately from UI. 
    93 be activated separately from UI.
    94 */
    94 */
    95 enum HbInputModeTypeFlag
    95 enum HbInputModeTypeFlag {
    96 {
       
    97     HbInputModeNone                    = 0x00000000,
    96     HbInputModeNone                    = 0x00000000,
    98 
    97 
    99     // Default mode
    98     // Default mode
   100     HbInputModeDefault                 = 0x00000001,                      /**< Default input mode. This may mean diffierent things for different languages. */
    99     HbInputModeDefault                 = 0x00000001,                      /**< Default input mode. This may mean diffierent things for different languages. */
   101 
   100 
   102     // Numeric input mode
   101     // Numeric input mode
   103     HbInputModeNumeric                 = 0x00000001 | HbNumericModeMask,  /**< Numeric input mode */
   102     HbInputModeNumeric                 = 0x00000001 | HbNumericModeMask,  /**< Numeric input mode */
   104 
   103 
   105     // Special modes for all languages
   104     // Special modes for all languages
   106     HbInputModeSpeechToText            = 0x00000500,                      /**< Speech-to-text input mode */ 
   105     HbInputModeSpeechToText            = 0x00000500,                      /**< Speech-to-text input mode */
   107 
   106 
   108     // Chinese modes
   107     // Chinese modes
   109     HbInputModePinyin                  = 0x00000001 | HbChineseModeMask,  /**< Chinese PinYin input */
   108     HbInputModePinyin                  = 0x00000001 | HbChineseModeMask,  /**< Chinese PinYin input */
   110     HbInputModeStroke                  = 0x00000002 | HbChineseModeMask,  /**< Chinese Stroke input */
   109     HbInputModeStroke                  = 0x00000002 | HbChineseModeMask,  /**< Chinese Stroke input */
   111     HbInputModeZhuyin                  = 0x00000003 | HbChineseModeMask,  /**< Chinese ZhuYin input */
   110     HbInputModeZhuyin                  = 0x00000003 | HbChineseModeMask,  /**< Chinese ZhuYin input */
   122     // Handwriting modes
   121     // Handwriting modes
   123     HbInputModeHwrLatin                = 0x00000001 | HbHwrModeMask,                       /**< Latin based hand writing recognition */
   122     HbInputModeHwrLatin                = 0x00000001 | HbHwrModeMask,                       /**< Latin based hand writing recognition */
   124     HbInputModeHwrLatinFull            = 0x00000002 | HbHwrModeMask,                       /**< Latin based hand writing recognition, full screen */
   123     HbInputModeHwrLatinFull            = 0x00000002 | HbHwrModeMask,                       /**< Latin based hand writing recognition, full screen */
   125     HbInputModeHwrChinese              = 0x00000003 | HbHwrModeMask | HbChineseModeMask,   /**< Chinese hand writing recognition */
   124     HbInputModeHwrChinese              = 0x00000003 | HbHwrModeMask | HbChineseModeMask,   /**< Chinese hand writing recognition */
   126     HbInputModeHwrChineseFull          = 0x00000004 | HbHwrModeMask | HbChineseModeMask,   /**< Chinese hand writing recognition, full screen */
   125     HbInputModeHwrChineseFull          = 0x00000004 | HbHwrModeMask | HbChineseModeMask,   /**< Chinese hand writing recognition, full screen */
   127           
   126 
   128     // Custom made mode that does not belong to any pre-existing category
   127     // Custom made mode that does not belong to any pre-existing category
   129     HbInputModeCustom                  = HbChineseModeMask - 1             /**< Custom input mode */
   128     HbInputModeCustom                  = HbChineseModeMask - 1             /**< Custom input mode */
   130 };
   129 };
   131 Q_DECLARE_FLAGS(HbInputModeType, HbInputModeTypeFlag)
   130 Q_DECLARE_FLAGS(HbInputModeType, HbInputModeTypeFlag)
   132 
   131 
   135 
   134 
   136 Enumerates supported key event modifiers. There are modifiers for
   135 Enumerates supported key event modifiers. There are modifiers for
   137 shift, fn and chr keys. If a modifier bit is set, then the corresponding key
   136 shift, fn and chr keys. If a modifier bit is set, then the corresponding key
   138 is pressed.
   137 is pressed.
   139 */
   138 */
   140 enum HbModifier
   139 enum HbModifier {
   141 {
       
   142     HbModifierNone         = 0x00000000,
   140     HbModifierNone         = 0x00000000,
   143     HbModifierShiftPressed = 0x00000001,     /**< Shift-key is pressed */
   141     HbModifierShiftPressed = 0x00000001,     /**< Shift-key is pressed */
   144     HbModifierChrPressed   = 0x00000002,     /**< Chr-key is pressed */
   142     HbModifierChrPressed   = 0x00000002,     /**< Chr-key is pressed */
   145     HbModifierFnPressed    = 0x00000004      /**< Fn-key is pressed */
   143     HbModifierFnPressed    = 0x00000004      /**< Fn-key is pressed */
   146 };
   144 };
   149 /*!
   147 /*!
   150 \enum HbKeyboardSettingFlags
   148 \enum HbKeyboardSettingFlags
   151 
   149 
   152 Enumerates keyboard setting flags.
   150 Enumerates keyboard setting flags.
   153 */
   151 */
   154 enum HbKeyboardSettingFlag
   152 enum HbKeyboardSettingFlag {
   155 {
       
   156     HbKeyboardSettingNone         = 0x00000000,
   153     HbKeyboardSettingNone         = 0x00000000,
   157     HbKeyboardSetting12key        = 0x00000001,
   154     HbKeyboardSetting12key        = 0x00000001,
   158     HbKeyboardSettingQwerty       = 0x00000010
   155     HbKeyboardSettingQwerty       = 0x00000010
   159 };
   156 };
   160 Q_DECLARE_FLAGS(HbKeyboardSettingFlags, HbKeyboardSettingFlag)
   157 Q_DECLARE_FLAGS(HbKeyboardSettingFlags, HbKeyboardSettingFlag)
   164 
   161 
   165 Enumerates supported text case states. HbTextCaseAutomatic is a state
   162 Enumerates supported text case states. HbTextCaseAutomatic is a state
   166 where the framework automatically tries to conclude when upper case
   163 where the framework automatically tries to conclude when upper case
   167 state is needed.
   164 state is needed.
   168 */
   165 */
   169 enum HbTextCase
   166 enum HbTextCase {
   170 {
       
   171     HbTextCaseNone,
   167     HbTextCaseNone,
   172     HbTextCaseLower,             /**< Lower text case. */
   168     HbTextCaseLower,             /**< Lower text case. */
   173     HbTextCaseUpper,             /**< Upper text case. */
   169     HbTextCaseUpper,             /**< Upper text case. */
   174     HbTextCaseAutomatic          /**< Automatic capital letters. */
   170     HbTextCaseAutomatic          /**< Automatic capital letters. */
   175 };
   171 };
   177 /*!
   173 /*!
   178 \enum HbFnState
   174 \enum HbFnState
   179 
   175 
   180 Enumerates possible states for Fn key.
   176 Enumerates possible states for Fn key.
   181 */
   177 */
   182 enum HbFnState
   178 enum HbFnState {
   183 {
       
   184     HbFnOff,    /**< Fn key inactive. */
   179     HbFnOff,    /**< Fn key inactive. */
   185     HbFnNext,   /**< Fn key active for the next keypress. */
   180     HbFnNext,   /**< Fn key active for the next keypress. */
   186     HbFnOn      /**< Fn key locked as active. */
   181     HbFnOn      /**< Fn key locked as active. */
   187 };
   182 };
   188 
   183 
   193 may declare a set of constraints that control its behaviour. Constraint
   188 may declare a set of constraints that control its behaviour. Constraint
   194 bits are set through editor interface class.
   189 bits are set through editor interface class.
   195 
   190 
   196 \sa HbEditorInterface
   191 \sa HbEditorInterface
   197 */
   192 */
   198 enum HbEditorConstraint
   193 enum HbEditorConstraint {
   199 {
       
   200     HbEditorConstraintNone                 = 0,
   194     HbEditorConstraintNone                 = 0,
   201     HbEditorConstraintAutoCompletingField  = 0x01,   /**< This is auto-completing editor. It remebers what has been typed previously to same editor class. */
   195     HbEditorConstraintAutoCompletingField  = 0x01,   /**< This is auto-completing editor. It remembers what has been typed previously to same editor class. */
   202     HbEditorConstraintIgnoreFocus          = 0x02,   /**< Editor rejects input framework focus. */
   196     HbEditorConstraintIgnoreFocus          = 0x02,   /**< Editor rejects input framework focus. */
   203     HbEditorConstraintFixedInputMode       = 0x04,   /**< Editor doesn't allow initial input mode to be changed. */
   197     HbEditorConstraintFixedInputMode       = 0x04,   /**< Editor doesn't allow initial input mode to be changed. */
   204     HbEditorConstraintLatinAlphabetOnly    = 0x08    /**< Editor allows only languages and input modes that produce latin alphabets. */
   198     HbEditorConstraintLatinAlphabetOnly    = 0x08    /**< Editor allows only languages and input modes that produce latin alphabets. */
   205 };
   199 };
   206 Q_DECLARE_FLAGS(HbEditorConstraints, HbEditorConstraint)
   200 Q_DECLARE_FLAGS(HbEditorConstraints, HbEditorConstraint)
   208 /*!
   202 /*!
   209 \enum HbInputDigitType
   203 \enum HbInputDigitType
   210 
   204 
   211 Enumerates known digit type settings.
   205 Enumerates known digit type settings.
   212 */
   206 */
   213 enum HbInputDigitType
   207 enum HbInputDigitType {
   214 {
       
   215     HbDigitTypeNone = 0,
   208     HbDigitTypeNone = 0,
   216     HbDigitTypeLatin,          /**< Latin digits in use */
   209     HbDigitTypeLatin,          /**< Latin digits in use */
   217     HbDigitTypeArabicIndic,    /**< Arabic indic digits in use */
   210     HbDigitTypeArabicIndic,    /**< Arabic indic digits in use */
   218     HbDigitTypeEasternArabic,  /**< Eastern arabic digits in use */
   211     HbDigitTypeEasternArabic,  /**< Eastern arabic digits in use */
   219     HbDigitTypeDevanagari      /**< Devanagari digits in use */
   212     HbDigitTypeDevanagari      /**< Devanagari digits in use */
   220 };
   213 };
   221 
   214 
   222 /*!
   215 /*!
   223 Enumerates operation modes for touch keypad. 
   216 Enumerates operation modes for touch keypad.
   224 */
   217 */
   225 enum HbKeypadMode{
   218 enum HbKeypadMode {
   226     EModeAbc,        /**< Display aplhanumeric keypad */
   219     EModeAbc,        /**< Display aplhanumeric keypad */
   227     EModeNumeric     /**< Display number mode keypad */ 
   220     EModeNumeric     /**< Display number mode keypad */
   228 };
   221 };
   229 
   222 
   230 /*!
   223 /*!
   231 Enumerates known editor classes. If this value is set through
   224 Enumerates known editor classes. If this value is set through
   232 HbEditorInterface, it will have an effect on some input functionality.
   225 HbEditorInterface, it will have an effect on some input functionality.
   233 */
   226 */
   234 enum HbInputEditorClass {
   227 enum HbInputEditorClass {
   235      HbInputEditorClassUnknown = 0,
   228     HbInputEditorClassUnknown = 0,
   236      HbInputEditorClassEmail,
   229     HbInputEditorClassEmail,
   237      HbInputEditorClassUrl,
   230     HbInputEditorClassUrl,
   238      HbInputEditorClassUsername,
   231     HbInputEditorClassUsername,
   239      HbInputEditorClassPassword,
   232     HbInputEditorClassPassword,
   240      HbInputEditorClassPhoneNumber,
   233     HbInputEditorClassPhoneNumber,
   241      HbInputEditorClassStreetAddress,
   234     HbInputEditorClassStreetAddress,
   242      HbInputEditorClassZipCode,
   235     HbInputEditorClassZipCode,
   243      HbInputEditorClassSIPAddress,
   236     HbInputEditorClassSIPAddress,
   244      HbInputEditorClassFirstName,
   237     HbInputEditorClassFirstName,
   245      HbInputEditorClassLastName,
   238     HbInputEditorClassLastName,
   246      HbInputEditorClassFullName,
   239     HbInputEditorClassFullName,
   247      HbInputEditorClassFaxNumber,
   240     HbInputEditorClassFaxNumber,
   248      HbInputEditorClassTitle,
   241     HbInputEditorClassTitle,
   249      HbInputEditorClassProfession,
   242     HbInputEditorClassProfession,
   250      HbInputEditorClassCity,
   243     HbInputEditorClassCity,
   251      HbInputEditorClassDestination,
   244     HbInputEditorClassDestination,
   252      HbInputEditorClassNetworkDomain,
   245     HbInputEditorClassNetworkDomain,
   253      HbInputEditorClassNetworkName,     
   246     HbInputEditorClassNetworkName,
   254 
   247 
   255      HbInputEditorClassLastItem          // Keep this last, but never use.
   248     HbInputEditorClassLastItem          // Keep this last, but never use.
   256 };
   249 };
   257 
   250 
   258 /*!
   251 /*!
   259 Enumerates primary candidate modes.
   252 Enumerates primary candidate modes.
   260 */
   253 */
   261 enum HbPrimaryCandidateMode{
   254 enum HbPrimaryCandidateMode {
   262     HbPrimaryCandidateModeBestPrediction,        /**< Display best prediction as the primary candidate */
   255     HbPrimaryCandidateModeBestPrediction,        /**< Display best prediction as the primary candidate */
   263     HbPrimaryCandidateModeExactTyping            /**< Display exact typing as the primary candidate */
   256     HbPrimaryCandidateModeExactTyping            /**< Display exact typing as the primary candidate */
   264 };
   257 };
   265 
   258 
   266 /*!
   259 /*!
   267 Enumerates typing correction levels.
   260 Enumerates typing correction levels.
   268 */
   261 */
   269 enum HbTypingCorrectionLevel{
   262 enum HbTypingCorrectionLevel {
   270     HbTypingCorrectionLevelLow,
   263     HbTypingCorrectionLevelLow,
   271     HbTypingCorrectionLevelMedium,
   264     HbTypingCorrectionLevelMedium,
   272     HbTypingCorrectionLevelHigh
   265     HbTypingCorrectionLevelHigh
   273 };
   266 };
   274 
   267