开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > MTK > 查看源码
gui_virtual_keyboard.h
资源名称：mmi.rar　[点击查看]
上传用户：lqx1163
上传日期：2014-08-13
资源大小：9183k
文件大小：13k
源码类别：

MTK

开发平台：

C/C++

gui_virtual_keyboard.h：源码内容
  1. /*****************************************************************************
  2. *  Copyright Statement:
  3. *  --------------------
  4. *  This software is protected by Copyright and the information contained
  5. *  herein is confidential. The software may not be copied and the information
  6. *  contained herein may not be used or disclosed except with the written
  7. *  permission of MediaTek Inc. (C) 2005
  8. *
  9. *  BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
  10. *  THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
  11. *  RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
  12. *  AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
  13. *  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
  14. *  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
  15. *  NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
  16. *  SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
  17. *  SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
  18. *  THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
  19. *  NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
  20. *  SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
  21. *
  22. *  BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
  23. *  LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
  24. *  AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
  25. *  OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
  26. *  MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. 
  27. *
  28. *  THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
  29. *  WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
  30. *  LAWS PRINCIPLES.  ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
  31. *  RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
  32. *  THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
  33. *
  34. *****************************************************************************/
  36. /*****************************************************************************
  37.  *
  38.  * Filename:
  39.  * ---------
  40.  *   gui_virtual_keyboard.h
  41.  *
  42.  * Project:
  43.  * --------
  44.  *   MAUI
  45.  *
  46.  * Description:
  47.  * ------------
  48.  *   Virtual keyboard - UI component
  49.  *
  50.  * Author:
  51.  * -------
  52.  * -------
  53.  * -------
  54.  *
  55.  *============================================================================
  56.  *             HISTORY
  57.  * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
  58.  *------------------------------------------------------------------------------
  59.  * removed!
  60.  *
  61.  * removed!
  62.  * removed!
  63.  * removed!
  64.  *
  65.  * removed!
  66.  * removed!
  67.  * removed!
  68.  *
  69.  * removed!
  70.  * removed!
  71.  * removed!
  72.  *
  73.  * removed!
  74.  * removed!
  75.  * removed!
  76.  *
  77.  *------------------------------------------------------------------------------
  78.  * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
  79.  *============================================================================
  80.  ****************************************************************************/
  82. #ifndef __GUI_VIRTUAL_KEYBOARD_H__
  83. #define __GUI_VIRTUAL_KEYBOARD_H__
  85. #include "PixtelDataTypes.h"
  86. #include "gui_data_types.h"
  87. #include "MMI_features.h"
  88. #include "gdi_include.h"
  89. #include "gui_theme_struct.h"
  90. #include "wgui.h"
  92. #ifdef __MMI_TOUCH_SCREEN__
  93. #include "kal_non_specific_general_types.h"
  94. #include "TouchScreenGprot.h"
  95. #endif /* __MMI_TOUCH_SCREEN__ */ 
  97. /***************************************************************************** 
  98. * Define
  99. *****************************************************************************/
  101. #define  MMI_VKBD_MAX_ROW                          5
  102. #define  MMI_VKBD_MAX_COLUMN                       15
  103. #define  MMI_VKBD_MAX_CUSTOM_KEYS                  20
  104. #define  MMI_VKBD_MAX_DISPLAY_AREA_TEXT_LEN        11
  105. #define  MMI_VKBD_MAX_DEADKEY_INPUT                2
  106. #define  MMI_VKBD_MAX_DISABLED_KEYS                7
  108. #define  MMI_VKBD_GRAYSCALE_VALUE                  5
  110. // TODO: Russian should be handled differently
  111. #if defined(__MMI_LANG_RUSSIAN__) || defined(__MMI_LANG_SPANISH__) || defined(__MMI_LANG_FRENCH__) || defined(__MMI_LANG_PORTUGUESE__) || defined(__MMI_LANG_GERMAN__) || defined(__MMI_LANG_ITALIAN__) || defined(__MMI_LANG_TURKISH__)
  112. #define  __MMI_VKBD_EUROPEAN_SUPPORT__
  113. #endif /* European languages */
  115. /***************************************************************************** 
  116. * Typedef 
  117. *****************************************************************************/
  119. /* 
  120.  * Supported languages 
  121.  * MMI_virtual_keyboard_language_map[] and gui_dead_key_symbol_table[] should be changed
  122.  * accrording to gui_virtual_keyboard_language_enum.
  123.  */
  124. typedef enum
  125. {
  126.     GUI_VIRTUAL_KEYBOARD_ENGLISH = 0,
  127.     GUI_VIRTUAL_KEYBOARD_ENGLISH_UPPERCASE,
  128.     GUI_VIRTUAL_KEYBOARD_SYMBOL,
  129.     GUI_VIRTUAL_KEYBOARD_TRAY,
  130.     GUI_VIRTUAL_KEYBOARD_NUMBER,
  131.     GUI_VIRTUAL_KEYBOARD_PHONE_NUMBER,
  132.     GUI_VIRTUAL_KEYBOARD_EMPTY_TRAY,
  133.     GUI_VIRTUAL_KEYBOARD_NUMBER_TRAY,
  134.     GUI_VIRTUAL_KEYBOARD_NUMBER_DOT_TRAY,
  135.     /* Chinese */
  136.     /* MTK Terry Temp Solution for Custom Release */
  137.     // #ifdef __MMI_LANG_SM_CHINESE__
  138.     GUI_VIRTUAL_KEYBOARD_PINYIN,
  139.     //#endif
  140.     //#ifdef __MMI_LANG_TR_CHINESE__
  141.     GUI_VIRTUAL_KEYBOARD_BOPOMO,
  142.     //#endif
  143.     //#if defined(__MMI_LANG_TR_CHINESE__) || defined(__MMI_LANG_SM_CHINESE__)
  144.     GUI_VIRTUAL_KEYBOARD_CHINESE_SYMBOL,
  145.     // #endif
  146.     /* Asia-pacific */
  147. #ifdef __MMI_LANG_THAI__
  148. #endif 
  149. #ifdef __MMI_LANG_INDONESIAN__
  150. #endif 
  151. #ifdef __MMI_LANG_MALAY__
  152. #endif 
  153. #ifdef __MMI_LANG_VIETNAMESE__
  154. #endif 
  155.     /* Hindi */
  156. #ifdef __MMI_LANG_HINDI__
  157. #endif 
  158.     /* Arabic */
  159. #ifdef __MMI_LANG_ARABIC__
  160. #endif 
  161.     /* Europe */
  162. #ifdef __MMI_LANG_SPANISH__
  163.     GUI_VIRTUAL_KEYBOARD_SPANISH,
  164.     GUI_VIRTUAL_KEYBOARD_SPANISH_UPPERCASE,
  165. #endif /* __MMI_LANG_SPANISH__ */ 
  166. #ifdef __MMI_LANG_FRENCH__
  167.     GUI_VIRTUAL_KEYBOARD_FRENCH,
  168.     GUI_VIRTUAL_KEYBOARD_FRENCH_UPPERCASE,
  169. #endif /* __MMI_LANG_FRENCH__ */ 
  170. #ifdef __MMI_LANG_GERMAN__
  171.     GUI_VIRTUAL_KEYBOARD_GERMAN,
  172.     GUI_VIRTUAL_KEYBOARD_GERMAN_UPPERCASE,
  173. #endif /* __MMI_LANG_GERMAN__ */ 
  174. #ifdef __MMI_LANG_ITALIAN__
  175.     GUI_VIRTUAL_KEYBOARD_ITALIAN,
  176.     GUI_VIRTUAL_KEYBOARD_ITALIAN_UPPERCASE,
  177. #endif /* __MMI_LANG_ITALIAN__ */ 
  178. #ifdef __MMI_LANG_RUSSIAN__
  179.     GUI_VIRTUAL_KEYBOARD_RUSSIAN,
  180.     GUI_VIRTUAL_KEYBOARD_RUSSIAN_UPPERCASE,
  181. #endif /* __MMI_LANG_RUSSIAN__ */ 
  182. #ifdef __MMI_LANG_TURKISH__
  183.     GUI_VIRTUAL_KEYBOARD_TURKISH,
  184.     GUI_VIRTUAL_KEYBOARD_TURKISH_UPPERCASE,
  185. #endif /* __MMI_LANG_TURKISH__ */ 
  186. #ifdef __MMI_LANG_PORTUGUESE__
  187.     GUI_VIRTUAL_KEYBOARD_PORTUGUESE,
  188.     GUI_VIRTUAL_KEYBOARD_PORTUGUESE_UPPERCASE,
  189. #endif /* __MMI_LANG_PORTUGUESE__ */ 
  190. #ifdef __MMI_VKBD_EUROPEAN_SUPPORT__
  191.     GUI_VIRTUAL_KEYBOARD_EUROPEAN_SYMBOLS,
  192. #endif 
  193.     GUI_VIRTUAL_KEYBOARD_MAX_LANG
  194. } gui_virtual_keyboard_language_enum;
  196. /* Pen events */
  197. typedef enum
  198. {
  199.     GUI_VKBD_PEN_NONE,
  200.     GUI_VKBD_PEN_DISPLAY_AREA,
  201.     GUI_VKBD_PEN_CHAR_I,
  202.     GUI_VKBD_PEN_HIDE,
  203.     GUI_VKBD_PEN_SHOW,
  204.     GUI_VKBD_PEN_CAPSLOCK,
  205.     GUI_VKBD_PEN_SPACE,
  206.     GUI_VKBD_PEN_BAKSPACE,
  207.     GUI_VKBD_PEN_SYMBPICKER,
  208.     GUI_VKBD_PEN_BRACKET,
  209.     GUI_VKBD_PEN_NEWLINE,
  210.     GUI_VKBD_PEN_EUROSYMB,
  211.     GUI_VKBD_PEN_DEAD_KEY,
  212.     GUI_VKBD_PEN_MAX
  213. } gui_virtual_keyboard_pen_enum;
  216. /* Flags */
  218. /* Flag - multi-block handwriting mode enabled */
  219. #define GUI_VKBD_FLAG_MULTI_BLOCK_MODE          0x00000001
  221. typedef struct
  222. {
  223.     S16 nInputLen;
  224.     UI_character_type input_char[MMI_VKBD_MAX_DEADKEY_INPUT];
  225.     UI_character_type output_char;
  226. } gui_dead_key_symbol_struct;
  228. typedef struct
  229. {
  230.     const gui_dead_key_symbol_struct *dead_key_symbol;
  231.     S16 nentry;
  232. } gui_dead_key_map_struct;
  234. typedef struct
  235. {
  236.     /* Index of matrix layout tapped by pen (<0 if none) */
  237.     S16 matrix_index;
  238.     S16 matrix_column;
  239.     S16 matrix_row;
  241.     /* Index of custom key tapped by pen (<0 if none) */
  242.     S16 custom_key_index;
  244.     /* size of selected key */
  245.     S16 key_width;
  246.     S16 key_height;
  247.     S16 key_x;
  248.     S16 key_y;
  249. } virtual_keyboard_selection_struct;
  251. typedef struct _virtual_keyboard_struct
  252. {
  253.     S16 x, y;
  254.     S16 width, height;
  255.     U32 flags;
  256.     gui_virtual_keyboard_language_enum lang_type;
  257.     UI_virtual_keyboard_theme *keyboard_theme;
  258.     UI_character_type disp_area_text[MMI_VKBD_MAX_DISPLAY_AREA_TEXT_LEN + 1];
  260.     /* 
  261.      * If `allowed_characters' is not NULL, the parameters `disabled_chars' and `disabled_symbols'
  262.      * will be ignored. 
  263.      * 
  264.      * It only enables characters listed in `allowed_characters'
  265.      * and special custom keys: GUI_VKBD_PEN_HIDE, GUI_VKBD_PEN_SHOW, 
  266.      * GUI_VKBD_PEN_CAPSLOCK, GUI_VKBD_PEN_BAKSPACE.
  267.      *
  268.      * Custom key GUI_VKBD_PEN_NEWLINE and GUI_VKBD_PEN_SPACE are enabled 
  269.      * if 'n' and ' ' are listed. 
  270.      *
  271.      * Custom key GUI_VKBD_PEN_SYMBPICKER is enabled if any non-alphanumeric characters is listed.
  272.      *
  273.      * `allowed_characters' may contain "-" for consecutive characters
  274.      * (Ex. "a-z" for characters from a to z.)
  275.      * If we want to accept "-", please write it as "-" 
  276.      * For example, "-0-9." represents "-0123456789."
  277.      */
  278.     const UI_character_type *allowed_characters;
  280.     /* Null-terminated list for disabled characters */
  281.     UI_character_type disabled_chars[MMI_VKBD_MAX_DISABLED_KEYS + 1];
  282.     /* Terminated with GUI_VKBD_PEN_NONE */
  283.     gui_virtual_keyboard_pen_enum disabled_symbols[MMI_VKBD_MAX_DISABLED_KEYS + 1];
  285. #ifdef __MMI_TOUCH_SCREEN__
  286.     MMI_BOOL key_down_accepted;
  287. #endif 
  289.     /* Dead key character */
  290.     UI_character_type dead_key_input[MMI_VKBD_MAX_DEADKEY_INPUT];
  292.     BOOL selected_key_cached;
  293.     virtual_keyboard_selection_struct selected_key;
  294.     gdi_image_cache_bmp_struct selected_key_bitmap;
  295. } virtual_keyboard;
  297. /* Layout definition */
  298. typedef struct
  299. {
  300.     S16 x, y;
  301.     S16 n_columns, n_rows;
  302.     S16 width, height;
  303.     S16 key_width, key_height;
  304.     S16 horizontal_key_gap, vertical_key_gap;
  305. } gui_matrix_key_layout_struct;
  307. typedef struct
  308. {
  309.     S16 x, y;
  310.     S16 key_width, key_height;
  311. } gui_custom_key_layout_struct;
  313. typedef struct
  314. {
  315.     S16 width;
  316.     S16 height;
  317.     S16 n_matrix_key_layout;
  318.     S16 n_custom_keys;
  319.     const gui_matrix_key_layout_struct *matrix_layout;
  320.     const gui_custom_key_layout_struct *custom_keys;
  321.     U16 ImageId;
  322. } gui_keyboard_layout_struct;
  324. typedef struct
  325. {
  326.     BOOL enable_dead_key;   /* Dead key for european languages */
  327.     S16 n_matrix_layout;
  328.     S16 n_custom_keys;
  329.     UI_character_type matrix_string[MMI_VKBD_MAX_ROW][MMI_VKBD_MAX_COLUMN + 1];
  330.     UI_character_type custom_string[MMI_VKBD_MAX_CUSTOM_KEYS];
  331.     MMI_ID_TYPE custom_key_image[MMI_VKBD_MAX_CUSTOM_KEYS];
  332.     gui_virtual_keyboard_pen_enum custom_key_type[MMI_VKBD_MAX_CUSTOM_KEYS];
  333. } gui_keyboard_language_struct;
  335. typedef struct
  336. {
  337.     const gui_keyboard_layout_struct *virtual_keyboard_layout;
  338.     const gui_keyboard_language_struct *virtual_keyboard_language;
  339. } gui_keyboard_lang_map_struct;
  341. /***************************************************************************** 
  342. * Extern Global Variable
  343. *****************************************************************************/
  345. extern UI_virtual_keyboard_theme *current_virtual_keyboard_theme;
  347. /***************************************************************************** 
  348. * Extern Global Function
  349. *****************************************************************************/
  351. extern void gui_set_virtual_keyboard_current_theme(virtual_keyboard *v);
  352. extern void gui_set_virtual_keyboard_theme(virtual_keyboard *v, UI_virtual_keyboard_theme *t);
  354. extern void gui_create_virtual_keyboard(
  355.                 virtual_keyboard *v,
  356.                 S16 x,
  357.                 S16 y,
  358.                 gui_virtual_keyboard_language_enum lang_type);
  359. extern void gui_move_virtual_keyboard(virtual_keyboard *v, S16 x, S16 y);
  360. extern void gui_show_virtual_keyboard(virtual_keyboard *v);
  362. extern void gui_set_virtual_keyboard_allowed_characters(virtual_keyboard *v, const UI_character_type *allowed_chars);
  363. extern void gui_set_virtual_board_disable_list(
  364.                 virtual_keyboard *v,
  365.                 const UI_character_type *disabled_chars,
  366.                 const gui_virtual_keyboard_pen_enum *disabled_symbols);
  368. extern void gui_set_virtual_keyboard_display_area(virtual_keyboard *v, const U8 *string, BOOL redraw);
  370. extern void gui_set_virtual_keyboard_multi_block_mode(virtual_keyboard *v, MMI_BOOL enabled);
  372. #ifdef __MMI_TOUCH_SCREEN__
  373. extern BOOL gui_virtual_keyboard_translate_pen_event(
  374.                 virtual_keyboard *v,
  375.                 S16 x,
  376.                 S16 y,
  377.                 mmi_pen_event_type_enum pen_event,
  378.                 gui_virtual_keyboard_pen_enum *vkbd_event,
  379.                 gui_pen_event_param_struct *vkbd_param);
  380. #endif /* __MMI_TOUCH_SCREEN__ */ 
  382. #endif /* __GUI_VIRTUAL_KEYBOARD_H__ */