WinCreateHelpTable - Example Code

This example creates a help table in memory and passes the table to the Help Manager via WinCreateHelpTable. The help instance must have been created by WinCreateHelpInstance.

#define INCL_WINHELP
#include <os2.h>

/* DEFINEs for window id's, menu items, controls, panels, etc. should */
/* be inserted here or in additional include files.                   */

/* Subtable for the main window's help */
HELPSUBTABLE phtMainTable[] = { 2,              /* Length of each entry */
                                 /* Fill in one line for each menu item   */
                                 IDM_FILE,       PANELID_FILEMENU,
                                 IDM_FILENEW,    PANELID_FILENEW,
                                 IDM_FILEOPEN,   PANELID_FILEOPEN,
                                 IDM_FILESAVE,   PANELID_FILESAVE,
                                 IDM_FILESAVEAS, PANELID_FILESAVEAS,
                                 IDM_FILEEXIT,   PANELID_FILEEXIT };

/* Subtable for the dialog window's help */
HELPSUBTABLE phtDlgTable[] = { 2,             /* Length of each entry */
                                /* Fill in one line for each control */
                                IDC_EDITFLD,    PANELID_DLGEDITFLD,
                                IDC_OK,         PANELID_DLGOK,
                                IDC_CANCEL,     PANELID_DLGCANCEL,
                                IDC_HELP,       PANELID_HELP };

/* Help table for the applications context sensitive help */
HELPTABLE phtHelpTable[]= { WINDOWID_MAIN, phtMainTable,
PANELID_MAINEXT,
                              WINDOWID_DLG,  phtDlgTable,  PANELID_DLGEXT,
                              0,             NULL,           0 };

BOOL CreateHelpTable( HWND hWnd )
{
    BOOL bSuccess = FALSE;
    HWND hwndHelp;

    /* Get the associated help instance */
    hwndHelp = WinQueryHelpInstance( hWnd );

    if( hwndHelp )
    {
        /* Pass address of help table to the Help Manager */
        bSuccess = WinCreateHelpTable( hwndHelp, phtHelpTable );
    }

    /* return success indicator */
    return bSuccess;
}