home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / devtools / os2tk21j / c / samples / style / sty_help.c__ / sty_help.c
Encoding:
C/C++ Source or Header  |  1993-03-12  |  11.8 KB  |  362 lines
  1. /*************************************************************************
  2. *
  3. *  File Name   : STY_HELP.C
  4. *
  5. *  Description : This module contains all the routines for
  6. *                interfacing with the IPF help manager.
  7. *
  8. *  Concepts    : Help initialization and termination, handling of
  9. *                help menu items.
  10. *
  11. *  API's       : WinCreateHelpInstance
  12. *                WinAssociateHelpInstance
  13. *                WinLoadString
  14. *                WinSendMsg
  15. *                WinDlgBox
  16. *                WinDestroyHelpInstance
  17. *
  18. *  Copyright (C) 1992 IBM Corporation
  19. *
  20. *      DISCLAIMER OF WARRANTIES.  The following [enclosed] code is
  21. *      sample code created by IBM Corporation. This sample code is not
  22. *      part of any standard or IBM product and is provided to you solely
  23. *      for  the purpose of assisting you in the development of your
  24. *      applications.  The code is provided "AS IS", without
  25. *      warranty of any kind.  IBM shall not be liable for any damages
  26. *      arising out of your use of the sample code, even if they have been
  27. *      advised of the possibility of such damages.                                                    *
  28. *
  29. ************************************************************************/
  30.  
  31. /*  Include files, macros, defined constants, and externs       */
  32.  
  33. #define  INCL_WINHELP
  34.  
  35. #include <os2.h>
  36. #include <string.h>
  37. #include "sty_main.h"
  38. #include "sty_xtrn.h"
  39. #include "sty_dlg.h"
  40. #include "sty_help.h"
  41.  
  42. #define HELPLIBRARYNAMELEN  20
  43.  
  44. /*  Global variables                                            */
  45. static HWND hwndHelpInstance;
  46. static CHAR szLibName[HELPLIBRARYNAMELEN];
  47. static CHAR szWindowTitle[HELPLIBRARYNAMELEN];
  48.  
  49.  
  50. /*  Entry point declarations                                    */
  51. MRESULT EXPENTRY ProdInfoDlgProc(HWND hwnd, USHORT msg,
  52.                                  MPARAM mp1, MPARAM mp2);
  53.  
  54. /***************************************************************
  55.  *  Name: InitHelp
  56.  *
  57.  *  Description : Initializes the IPF help facility
  58.  *
  59.  *  Concepts : Initializes the HELPINIT structure and creates the
  60.  *             help instance.  If successful, the help instance
  61.  *             is associated with the main window
  62.  *
  63.  *  API's : WinCreateHelpInstance
  64.  *          WinAssociateHelpInstance
  65.  *          WinLoadString
  66.  *
  67.  *  Parameters : None
  68.  *
  69.  *  Returns:  None
  70.  *
  71.  ****************************************************************/
  72. VOID InitHelp(VOID)
  73. {
  74.   HELPINIT helpInit;
  75.  
  76.   /* if we return because of an error, Help will be disabled                */
  77.   fHelpEnabled = FALSE;
  78.  
  79.   /* inititalize help init structure                                        */
  80.   helpInit.cb = sizeof(HELPINIT);
  81.   helpInit.ulReturnCode = 0L;
  82.  
  83.   helpInit.pszTutorialName = (PSZ)NULL;   /* if tutorial added,             */
  84.                                           /* add name here                  */
  85.   helpInit.phtHelpTable = (PHELPTABLE)MAKELONG(STYLE_HELP_TABLE,
  86.                            0xFFFF);
  87.   helpInit.hmodHelpTableModule = (HMODULE)0;
  88.   helpInit.hmodAccelActionBarModule = (HMODULE)0;
  89.   helpInit.idAccelTable = 0;
  90.   helpInit.idActionBar = 0;
  91.  
  92.   if (!WinLoadString(hab, (HMODULE)0, IDS_HELPWINDOWTITLE,
  93.                     HELPLIBRARYNAMELEN, (PSZ)szWindowTitle))
  94.   {
  95.      MessageBox(hwndMain, IDMSG_CANNOTLOADSTRING, MB_OK | MB_ERROR, FALSE);
  96.      return;
  97.   }
  98.   helpInit.pszHelpWindowTitle = (PSZ)szWindowTitle;
  99.   helpInit.fShowPanelId = CMIC_HIDE_PANEL_ID;
  100.  
  101.   if (!WinLoadString(hab, (HMODULE)0, IDS_HELPLIBRARYNAME,
  102.        HELPLIBRARYNAMELEN, (PSZ)szLibName))
  103.   {
  104.      MessageBox(hwndMain, IDMSG_CANNOTLOADSTRING, MB_OK | MB_ERROR, FALSE);
  105.      return;
  106.   }
  107.  
  108.   helpInit.pszHelpLibraryName = (PSZ)szLibName;
  109.  
  110.   /* creating help instance                                                 */
  111.   hwndHelpInstance = WinCreateHelpInstance(hab, &helpInit);
  112.  
  113.   if (!hwndHelpInstance || helpInit.ulReturnCode)
  114.   {
  115.      MessageBox(hwndMainFrame, IDMSG_HELPLOADERROR, MB_OK | MB_ERROR, TRUE);
  116.      return;
  117.   }
  118.  
  119.   /* associate help instance with main frame                                */
  120.   if (!WinAssociateHelpInstance(hwndHelpInstance, hwndMainFrame))
  121.   {
  122.      MessageBox(hwndMainFrame, IDMSG_HELPLOADERROR, MB_OK | MB_ERROR, TRUE);
  123.      return;
  124.   }
  125.  
  126.   /* help manager is successfully initialized so set flag to TRUE           */
  127.   fHelpEnabled = TRUE;
  128.  
  129. }   /*                                          End of InitHelp()           */
  130.  
  131. /*********************************************************************
  132.  *  Name: HelpUsingHelp
  133.  *
  134.  *  Description : Processes the WM_COMMAND message posted
  135.  *                by the Using Help item of the Help menu
  136.  *
  137.  *  Concepts : Called from MainCommand when the Using Help menu item
  138.  *             is selected.  Sends an HM_DISPLAY_HELP message to the
  139.  *             help instance so that the default Using Help is
  140.  *             displayed.
  141.  *
  142.  *  API's : WinSendMsg
  143.  *
  144.  *  Parameters :  mp2 - Message parameter 2
  145.  *
  146.  *  Returns: None
  147.  *
  148.  ****************************************************************/
  149. VOID  HelpUsingHelp(MPARAM mp2)
  150. {
  151. /*    this just displays the system help for help panel                       */
  152.   if (fHelpEnabled)
  153.   {
  154.     if ((BOOL)WinSendMsg(hwndHelpInstance, HM_DISPLAY_HELP, NULL, NULL))
  155.     {
  156.        MessageBox(hwndMain, IDMSG_HELPDISPLAYERROR, MB_OK | MB_ERROR, FALSE);
  157.     }
  158.   }
  159.  /*
  160.   * This routine currently doesn't use the mp2 parameter but
  161.   * it is referenced here to prevent an 'Unreferenced Parameter'
  162.   * warning at compile time.
  163.   */
  164.   mp2;
  165. }   /* End of HelpUsingHelp()                                                */
  166.  
  167. /*********************************************************************
  168.  
  169.  *  Name: HelpUsingHelp
  170.  *
  171.  *  Description : Processes the WM_COMMAND message posted
  172.  *                by the General Help item of the Help menu
  173.  *
  174.  *  Concepts : Called from MainCommand when the General Help menu item
  175.  *             is selected.  Sends an HM_EXT_HELP message to the
  176.  *             help instance so that the default Extended Help is
  177.  *             displayed.
  178.  *
  179.  *  API's : WinSendMsg
  180.  *
  181.  *  Parameters :  mp2 - Message parameter 2
  182.  *
  183.  
  184.  *  Returns: None
  185.  *
  186.  ****************************************************************/
  187. VOID  HelpGeneral(MPARAM mp2)
  188. {
  189. /*   this just displays the system General help panel                       */
  190.    if (fHelpEnabled)
  191.    {
  192.      if ((BOOL)WinSendMsg(hwndHelpInstance, HM_EXT_HELP, NULL, NULL))
  193.      {
  194.         MessageBox(hwndMain, IDMSG_HELPDISPLAYERROR, MB_OK | MB_ERROR, FALSE);
  195.      }
  196.    }
  197.    /*
  198.     * This routine currently doesn't use the mp2 parameter but
  199.     * it is referenced here to prevent an 'Unreferenced Parameter'
  200.     * warning at compile time.
  201.     */
  202.     mp2;
  203.  
  204. }       /* End of HelpGeneral()                                      */
  205.  
  206. /*********************************************************************
  207.  *  Name: HelpKeys
  208.  *
  209.  *  Description : Processes the WM_COMMAND message posted
  210.  *                by the Keys Help item of the Help menu
  211.  *
  212.  *  Concepts : Called from MainCommand when the Keys Help menu item
  213.  *             is selected.  Sends an HM_KEYS_HELP message to the
  214.  *             help instance so that the default Extended Help is
  215.  *             displayed.
  216.  *
  217.  *  API's : WinSendMsg
  218.  *
  219.  *  Parameters :  mp2 - Message parameter 2
  220.  *
  221.  *  Returns: None
  222.  *
  223.  ****************************************************************/
  224. VOID  HelpKeys(MPARAM mp2)
  225.  
  226. {
  227. /* this just displays the system keys help panel                              */
  228.   if (fHelpEnabled)
  229.   {
  230.     if ((BOOL)WinSendMsg(hwndHelpInstance, HM_KEYS_HELP, NULL, NULL))
  231.     {
  232.       MessageBox(hwndMain, IDMSG_HELPDISPLAYERROR, MB_OK | MB_ERROR, FALSE);
  233.     }
  234.   }
  235. /*
  236.  * This routine currently doesn't use the mp2 parameter but
  237.  * it is referenced here to prevent an 'Unreferenced Parameter'
  238.  * warning at compile time.
  239.  */
  240.   mp2;
  241. }   /*   End of HelpKeys()                                                    */
  242.  
  243. /*********************************************************************
  244.  *  Name: HelpIndex
  245.  *
  246.  *  Description : Processes the WM_COMMAND message posted
  247.  *                by the Index Help item of the Help menu
  248.  *
  249.  *  Concepts : Called from MainCommand when the Index Help menu item
  250.  *             is selected.  Sends an HM_INDEX_HELP message to the
  251.  *             help instance so that the default Extended Help is
  252.  *             displayed.
  253.  *
  254.  *  API's : WinSendMsg
  255.  *
  256.  *  Parameters :  mp2 - Message parameter 2
  257.  *
  258.  *  Returns: None
  259.  *
  260.  ****************************************************************/
  261. VOID  HelpIndex(MPARAM mp2)
  262. {
  263. /* this just displays the system help index panel                             */
  264.   if (fHelpEnabled)
  265.   {
  266.     if ((BOOL)WinSendMsg(hwndHelpInstance, HM_HELP_INDEX, NULL, NULL))
  267.     {
  268.        MessageBox(hwndMain, IDMSG_HELPDISPLAYERROR, MB_OK | MB_ERROR, FALSE);
  269.     }
  270.   }
  271.  /*
  272.   * This routine currently doesn't use the mp2 parameter but
  273.   * it is referenced here to prevent an 'Unreferenced Parameter'
  274.   * warning at compile time.
  275.  
  276.   */
  277.   mp2;
  278. }   /* End of HelpIndex()                                                     */
  279.  
  280. /*********************************************************************
  281.  *  Name: HelpProdInfo
  282.  *
  283.  *  Description : Processes the WM_COMMAND message posted
  284.  *                by the Index Help item of the Help menu
  285.  *
  286.  *  Concepts : Called from MainCommand when the Product
  287.  *             information Help menu item is selected.
  288.  *             Calls WinDlgBox to display the Product
  289.  *             Information dialog.
  290.  *
  291.  *  API's : WinDlgBox
  292.  *
  293.  *  Parameters :  mp2 - Message parameter 2
  294.  *
  295.  *  Returns: None
  296.  *
  297.  ****************************************************************/
  298. VOID  HelpProdInfo( MPARAM mp2)
  299. {
  300. /* display the Product Information dialog                                     */
  301.   WinDlgBox(HWND_DESKTOP, hwndMain, (PFNWP)ProdInfoDlgProc, (HMODULE)0,
  302.             IDD_PRODINFO, (PVOID)NULL);
  303.  /*
  304.  
  305.   * This routine currently doesn't use the mp2 parameter but
  306.   * it is referenced here to prevent an 'Unreferenced Parameter'
  307.   * warning at compile time.
  308.   */
  309.     mp2;
  310.  
  311. }   /* End of HelpProdInfo()                                                  */
  312.  
  313. /*********************************************************************
  314.  *  Name: DisplayHelp
  315.  *
  316.  *  Description : Displays the help panel indicated
  317.  *
  318.  *  Concepts : Displays the help panel whose id is passed to
  319.  *             the routine.  Called whenever a help panel is
  320.  *             desired to be displayed, usually from the
  321.  *             WM_HELP processing of the dialog boxes.
  322.  *
  323.  *  API's : WinSendMsg
  324.  *
  325.  *  Parameters : idPanel - Id of the halp panel to be displayed
  326.  *
  327.  *  Returns: None
  328.  *
  329.  ****************************************************************/
  330. VOID DisplayHelpPanel(SHORT idPanel)
  331. {
  332.   if (fHelpEnabled)
  333.   {
  334.     if ((BOOL)WinSendMsg(hwndHelpInstance, HM_DISPLAY_HELP,
  335.             MPFROM2SHORT(idPanel, NULL), MPFROMSHORT(HM_RESOURCEID)))
  336.     {
  337.       MessageBox(hwndMainFrame, IDMSG_HELPDISPLAYERROR,
  338.                  MB_OK | MB_ERROR, TRUE);
  339.     }
  340.   }
  341.  
  342. }   /*    End of DisplayHelpPanel()                                   */
  343.  
  344. /*********************************************************************
  345.  *  Name: DestroyHelpInstance
  346.  *
  347.  *  Description : Destroys the help instance for the application
  348.  *
  349.  *  Concepts : Called after exit from message loop. Calls
  350.  
  351.  *             WinDestroyHelpInstance() to destroy the
  352.  *             help instance.
  353.  *
  354.  *  API's : WinDestroyHelpInstance
  355.  *
  356.  *  Parameters : None
  357.  
  358.  * None
  359.  *  Returns:
  360.  *
  361.  ****************************************************************/
  362. VOID DestroyHelpInstance(VOID)
  363. {
  364.   if ((BOOL)hwndHelpInstance)
  365.   {
  366.      WinDestroyHelpInstance(hwndHelpInstance);
  367.   }
  368.  
  369. }   /*        End of DestroyHelpInstance()                                    */
  370.