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

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

MTK

开发平台：

C/C++

Help.c：源码内容
  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.  * Filename:
  38.  * ---------
  39.  *  Help.c
  40.  *
  41.  * Project:
  42.  * --------
  43.  *  MAUI
  44.  *
  45.  * Description:
  46.  * ------------
  47.  *  
  48.  *
  49.  * Author:
  50.  * -------
  51.  *  
  52.  *
  53.  *==============================================================================
  54.  *             HISTORY
  55.  * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
  56.  *------------------------------------------------------------------------------
  57.  * removed!
  58.  *
  59.  * removed!
  60.  * removed!
  61.  * removed!
  62.  *
  63.  * removed!
  64.  * removed!
  65.  * removed!
  66.  *
  67.  *------------------------------------------------------------------------------
  68.  * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
  69.  *==============================================================================
  70.  *******************************************************************************/
  72. /**
  73.  * Copyright Notice
  74.  * ?2002 - 2003, Pixtel Communications, Inc., 1489 43rd Ave. W.,
  75.  * Vancouver, B.C. V6M 4K8 Canada. All Rights Reserved.
  76.  *  (It is illegal to remove this copyright notice from this software or any
  77.  *  portion of it)
  78.  */
  80. /**************************************************************
  82.    FILENAME : Helpc.h
  84.    PURPOSE     : 
  86.    REMARKS     : nil
  88.    AUTHOR      : Manish Vohra
  90.    DATE     : 12/03/03
  92. **************************************************************/
  94. #include "StdC.h"
  95. #include "wgui_categories.h"
  96. #include "Globaldefs.h"
  97. #include "CustDataRes.h"
  98. #include "HistoryGprot.h"
  99. #include "HelpDef.h"
  100. #include "HelpDef.h"
  101. #include "HelpProt.h"
  102. #include "HelpDcl.h"
  103. #include "TimerEvents.h"
  104. #include "DebugInitDef.h"
  105. #include "Unicodexdcl.h"
  106. #include "GlobalDefs.h"
  107. #include "NVRAMProt.h"
  108. #include "NVRAMEnum.h"
  109. #include "NVRAMType.h"
  112. /*****************************************************************************
  113.  * FUNCTION
  114.  *  InitHelp
  115.  * DESCRIPTION
  116.  *  Initialize Help
  117.  *  
  118.  *  Call this function at boot up time find
  119.  *  help is enabled or not,
  120.  * PARAMETERS
  121.  *  void
  122.  * RETURNS
  123.  *  void
  124.  *****************************************************************************/
  125. void InitHelp(void)
  126. {
  127.     /*----------------------------------------------------------------*/
  128.     /* Local Variables                                                */
  129.     /*----------------------------------------------------------------*/
  131.     S16 error;
  132.     S32 status = -1;
  134.     /*----------------------------------------------------------------*/
  135.     /* Code Body                                                      */
  136.     /*----------------------------------------------------------------*/
  137.     gIsHelpEnabled = 1;
  138.     status = ReadValue(NVRAM_HELP_ENABLED_FLAG, &gIsHelpEnabled, DS_BYTE, &error);
  139.     if (error != NVRAM_READ_SUCCESS)
  140.     {
  141.         PRINT_INFORMATION(("[InitHelp] NVRAM READ FAILURE "));
  142.     }
  144. }
  147. /*****************************************************************************
  148.  * FUNCTION
  149.  *  SetHelpEnableFlag
  150.  * DESCRIPTION
  151.  *  Set a global variable
  152.  *  
  153.  *  This function is called by organizer when help is
  154.  *  made set in the Radio Button
  155.  * PARAMETERS
  156.  *  void
  157.  * RETURNS
  158.  *  void
  159.  *****************************************************************************/
  160. void SetHelpEnableFlag(void)
  161. {
  162.     /*----------------------------------------------------------------*/
  163.     /* Local Variables                                                */
  164.     /*----------------------------------------------------------------*/
  166.     /*----------------------------------------------------------------*/
  167.     /* Code Body                                                      */
  168.     /*----------------------------------------------------------------*/
  169.     gIsHelpEnabled = 1;
  171. }
  174. /*****************************************************************************
  175.  * FUNCTION
  176.  *  EntryScreenShowHelp
  177.  * DESCRIPTION
  178.  *  Entry function for Help Dispplay Screen
  179.  * PARAMETERS
  180.  *  void
  181.  * RETURNS
  182.  *  void
  183.  *****************************************************************************/
  184. void EntryScreenShowHelp(void)
  185. {
  186.     /*----------------------------------------------------------------*/
  187.     /* Local Variables                                                */
  188.     /*----------------------------------------------------------------*/
  190.     U16 currScrenID = 0;
  191.     U16 stringID;
  193.     /*----------------------------------------------------------------*/
  194.     /* Code Body                                                      */
  195.     /*----------------------------------------------------------------*/
  196.     currScrenID = GetCurrScreenID();
  197.     stringID = GetHelpStringID(currScrenID);
  198.     /* JL remove ExecuteCurrExitHandler(); */
  199.     EntryNewScreen(SCR_HELP, NULL, EntryScreenShowHelp, NULL);
  200.     ShowCategory21Screen(STR_HELP_CAPTION, 0, 0, 0, STR_GLOBAL_OK, 0, stringID, NULL);
  201.     SetRightSoftkeyFunction(GoBackHistory, KEY_EVENT_UP);
  202.     /* JL remove SetExitHandler(SCR_HELP,ExitScreenShowHelp); */
  204. }
  207. /*****************************************************************************
  208.  * FUNCTION
  209.  *  ExitScreenShowHelp
  210.  * DESCRIPTION
  211.  *  Exit function for Help Dispplay Screen
  212.  * PARAMETERS
  213.  *  void
  214.  * RETURNS
  215.  *  void
  216.  *****************************************************************************/
  217. void ExitScreenShowHelp(void)
  218. {
  219.     /*----------------------------------------------------------------*/
  220.     /* Local Variables                                                */
  221.     /*----------------------------------------------------------------*/
  222.     history h;
  223.     S16 nHistory = 0;
  225.     /*----------------------------------------------------------------*/
  226.     /* Code Body                                                      */
  227.     /*----------------------------------------------------------------*/
  228.     h.scrnID = SCR_HELP;
  229.     h.entryFuncPtr = EntryScreenShowHelp;
  230.     pfnUnicodeStrcpy((S8*) h.inputBuffer, (S8*) & nHistory);
  231.     GetCategoryHistory(h.guiBuffer);
  232.     AddHistory(h);
  233. }
  236. /*****************************************************************************
  237.  * FUNCTION
  238.  *  ShowHelp
  239.  * DESCRIPTION
  240.  *  Call back when phone is left idle for
  241.  *  some time
  242.  * PARAMETERS
  243.  *  void
  244.  * RETURNS
  245.  *  void
  246.  *****************************************************************************/
  247. void ShowHelp(void)
  248. {
  249.     /*----------------------------------------------------------------*/
  250.     /* Local Variables                                                */
  251.     /*----------------------------------------------------------------*/
  252.     U16 stringID;
  254.     /*----------------------------------------------------------------*/
  255.     /* Code Body                                                      */
  256.     /*----------------------------------------------------------------*/
  257.     stringID = GetCurrScreenID();
  258.     if (stringID)
  259.     {
  260.         EntryScreenShowHelp();
  261.     }
  262. }
  265. /*****************************************************************************
  266.  * FUNCTION
  267.  *  EnableHelp
  268.  * DESCRIPTION
  269.  *  Needs to be called in the entry functions
  270.  *  for which help needs to be displayed
  271.  * PARAMETERS
  272.  *  ScrnID          [IN]        
  273.  *  ScreenID(?)     [IN]        
  274.  * RETURNS
  275.  *  void
  276.  *****************************************************************************/
  277. void EnableHelp(U16 ScrnID)
  278. {
  279.     /*----------------------------------------------------------------*/
  280.     /* Local Variables                                                */
  281.     /*----------------------------------------------------------------*/
  283.     /*----------------------------------------------------------------*/
  284.     /* Code Body                                                      */
  285.     /*----------------------------------------------------------------*/
  286.     gCurrScreenID = ScrnID;
  287.     StartTimer(HELP_APPLICATION_TIMER, HELP_APPLICATION_TIMEOUT, ShowHelp);
  288. }
  291. /*****************************************************************************
  292.  * FUNCTION
  293.  *  DisableHelp
  294.  * DESCRIPTION
  295.  *  Needs to be called from the exit functions
  296.  *  of screens for which help needs to be displayed
  297.  * PARAMETERS
  298.  *  void
  299.  * RETURNS
  300.  *  void
  301.  *****************************************************************************/
  302. void DisableHelp(void)
  303. {
  304.     /*----------------------------------------------------------------*/
  305.     /* Local Variables                                                */
  306.     /*----------------------------------------------------------------*/
  308.     /*----------------------------------------------------------------*/
  309.     /* Code Body                                                      */
  310.     /*----------------------------------------------------------------*/
  311.     gCurrScreenID = 0;
  312.     StopTimer(HELP_APPLICATION_TIMER);
  313. }
  316. /*****************************************************************************
  317.  * FUNCTION
  318.  *  GetCurrScreenID
  319.  * DESCRIPTION
  320.  *  return the current Screen ID
  321.  * PARAMETERS
  322.  *  void
  323.  * RETURNS
  324.  *  void
  325.  *****************************************************************************/
  326. U16 GetCurrScreenID(void)
  327. {
  328.     /*----------------------------------------------------------------*/
  329.     /* Local Variables                                                */
  330.     /*----------------------------------------------------------------*/
  332.     /*----------------------------------------------------------------*/
  333.     /* Code Body                                                      */
  334.     /*----------------------------------------------------------------*/
  335.     return gCurrScreenID;
  336. }
  339. /*****************************************************************************
  340.  * FUNCTION
  341.  *  GetHelpStringID
  342.  * DESCRIPTION
  343.  *  return the current STRING ID
  344.  *  corresponding to the screen ID
  345.  * PARAMETERS
  346.  *  currScrenID     [IN]        
  347.  * RETURNS
  348.  *  void
  349.  *****************************************************************************/
  350. U16 GetHelpStringID(U16 currScrenID)
  351. {
  352.     /*----------------------------------------------------------------*/
  353.     /* Local Variables                                                */
  354.     /*----------------------------------------------------------------*/
  356.     U16 count = gMaxHelpStrings;
  357.     U8 flag = 0;
  359.     /*----------------------------------------------------------------*/
  360.     /* Code Body                                                      */
  361.     /*----------------------------------------------------------------*/
  362.     //MTK added by JL to avoid the infinite loop
  363.     //for(count; count >= 0; --count)
  364.     for (count = 0; count < gMaxHelpStrings; count++)
  365.     {
  367.         if (HelpArrMap[count].ScreenID == currScrenID)
  368.         {
  369.             flag = 1;
  370.             break;
  371.         }
  372.     }
  374.     if (flag)
  375.     {
  376.         return HelpArrMap[count].StringID;
  377.     }
  378.     return 0;
  379. }
  382. /*****************************************************************************
  383.  * FUNCTION
  384.  *  AddScreenHelp
  385.  * DESCRIPTION
  386.  *  Fills the HelpArrMap
  387.  * PARAMETERS
  388.  *  ScreenID        [IN]        
  389.  *  StringID        [IN]        
  390.  * RETURNS
  391.  *  void
  392.  *****************************************************************************/
  393. void AddScreenHelp(U16 ScreenID, U16 StringID)
  394. {
  395.     /*----------------------------------------------------------------*/
  396.     /* Local Variables                                                */
  397.     /*----------------------------------------------------------------*/
  399.     U16 count;
  400.     U8 flag = 1;
  402.     /*----------------------------------------------------------------*/
  403.     /* Code Body                                                      */
  404.     /*----------------------------------------------------------------*/
  405.     for (count = 0; count < gMaxHelpStrings; ++count)
  406.     {
  408.         if (HelpArrMap[count].ScreenID == ScreenID)
  409.         {
  410.             flag = 0;
  411.             break;
  412.         }
  414.     }
  415.     if (flag)
  416.     {
  417.         HelpArrMap[gMaxHelpStrings].ScreenID = ScreenID;
  418.         HelpArrMap[gMaxHelpStrings].StringID = StringID;
  419.         ++gMaxHelpStrings;
  420.     }
  422. }