Annotation of os232sdk/toolkt20/c/os2h/pmhelp.h, revision 1.1.1.1

1.1       root        1: /*static char *SCCSID = "@(#)pmhelp.h  1.7 90/04/02";*/
                      2: 
                      3: /***************************************************************************\
                      4: *
                      5: * Module Name: PMHELP.H
                      6: *
                      7: * OS/2 Information Presentation Facility (IPF) for providing Help
                      8: *
                      9: * Copyright (c) International Business Machines Corporation 1989
                     10: * Copyright (c) Microsoft Corporation 1989
                     11: *
                     12: *****************************************************************************
                     13: * Define INCL_WINHELP before OS2.H to include this file
                     14: \***************************************************************************/
                     15: 
                     16: #ifndef PMHELP_H
                     17: #define PMHELP_H
                     18: 
                     19: /******************************************************************************/
                     20: /* HelpSubTable entry structure                                                      */
                     21: /******************************************************************************/
                     22: 
                     23: typedef int HELPSUBTABLE;
                     24: typedef int FAR *PHELPSUBTABLE;
                     25: 
                     26: /******************************************************************************/
                     27: /* HelpTable entry structure                                                 */
                     28: /******************************************************************************/
                     29: 
                     30: typedef struct _HELPTABLE   {  /* ht */
                     31:   USHORT         idAppWindow;
                     32:   PHELPSUBTABLE          phstHelpSubTable;
                     33:   USHORT         idExtPanel;
                     34: } HELPTABLE;
                     35: typedef HELPTABLE FAR *PHELPTABLE;
                     36: 
                     37: /******************************************************************************/
                     38: /* IPF Initialization Structure used on the                                  */
                     39: /* WinCreateHelpInstance() call.                                             */
                     40: /******************************************************************************/
                     41: 
                     42: typedef struct _HELPINIT   {  /* hinit */
                     43:   USHORT       cb;
                     44:   ULONG               ulReturnCode;
                     45:   PSZ         pszTutorialName;
                     46:   PHELPTABLE   phtHelpTable;
                     47:   HMODULE      hmodHelpTableModule;
                     48:   HMODULE      hmodAccelActionBarModule;
                     49:   USHORT       idAccelTable;
                     50:   USHORT       idActionBar;
                     51:   PSZ         pszHelpWindowTitle;
                     52:   USHORT       usShowPanelId;
                     53:   PSZ         pszHelpLibraryName;
                     54: } HELPINIT;
                     55: typedef HELPINIT FAR *PHELPINIT;
                     56: 
                     57: 
                     58: /******************************************************************************/
                     59: /* Search parent chain indicator for HM_SET_ACTIVE_WINDOW message.           */
                     60: /******************************************************************************/
                     61: 
                     62: #define HWND_PARENT        (HWND)NULL
                     63: 
                     64: /******************************************************************************/
                     65: /* Constants used to define whether user wants to display panel using        */
                     66: /* panel number or panel name.                                               */
                     67: /******************************************************************************/
                     68: 
                     69: #define HM_RESOURCEID           0
                     70: #define HM_PANELNAME            1
                     71: 
                     72: #define HMPANELTYPE_NUMBER      0
                     73: #define HMPANELTYPE_NAME        1
                     74: 
                     75: /******************************************************************************/
                     76: /* Constants used to define how the panel IDs are displayed on               */
                     77: /* help panels.                                                                      */
                     78: /******************************************************************************/
                     79: 
                     80: #define CMIC_HIDE_PANEL_ID       0x0000
                     81: #define CMIC_SHOW_PANEL_ID       0x0001
                     82: #define CMIC_TOGGLE_PANEL_ID     0x0002
                     83: 
                     84: /******************************************************************************/
                     85: /* Window Help function declarations.                                        */
                     86: /******************************************************************************/
                     87: /* XLATOFF */
                     88: #ifdef INCL_16
                     89: #define WinDestroyHelpInstance   Win16DestroyHelpInstance
                     90: #define WinCreateHelpInstance    Win16CreateHelpInstance
                     91: #define WinAssociateHelpInstance  Win16AssociateHelpInstance
                     92: #define WinQueryHelpInstance     Win16QueryHelpInstance
                     93: #define WinLoadHelpTable         Win16LoadHelpTable
                     94: #define WinCreateHelpTable       Win16CreateHelpTable
                     95: #endif /* INCL_16 */
                     96: /* XLATON */
                     97: 
                     98: BOOL APIENTRY  WinDestroyHelpInstance( HWND hwndHelpInstance);
                     99: HWND APIENTRY  WinCreateHelpInstance( HAB hab, PHELPINIT phinitHMInitStructure);
                    100: BOOL APIENTRY  WinAssociateHelpInstance( HWND hwndHelpInstance, HWND hwndApp);
                    101: HWND APIENTRY  WinQueryHelpInstance( HWND hwndApp);
                    102: BOOL APIENTRY  WinLoadHelpTable (HWND hwndHelpInstance, USHORT idHelpTable,
                    103:                                                               HMODULE Module);
                    104: BOOL APIENTRY  WinCreateHelpTable (HWND hwndHelpInstance,
                    105:                                                       PHELPTABLE phtHelpTable);
                    106: 
                    107: /******************************************************************************/
                    108: /* IPF message base.                                                         */
                    109: /******************************************************************************/
                    110: 
                    111: #define HM_MSG_BASE                   0x0220
                    112: 
                    113: /******************************************************************************/
                    114: /* Messages applications can send to the IPF.                                */
                    115: /******************************************************************************/
                    116: 
                    117: #define HM_DISMISS_WINDOW             HM_MSG_BASE+0x0001
                    118: #define HM_DISPLAY_HELP                       HM_MSG_BASE+0x0002
                    119: #define HM_EXT_HELP                   HM_MSG_BASE+0x0003
                    120: #define HM_SET_ACTIVE_WINDOW          HM_MSG_BASE+0x0004
                    121: #define HM_LOAD_HELP_TABLE            HM_MSG_BASE+0x0005
                    122: #define HM_CREATE_HELP_TABLE          HM_MSG_BASE+0x0006
                    123: #define HM_SET_HELP_WINDOW_TITLE       HM_MSG_BASE+0x0007
                    124: #define HM_SET_SHOW_PANEL_ID          HM_MSG_BASE+0x0008
                    125: #define HM_REPLACE_HELP_FOR_HELP       HM_MSG_BASE+0x0009
                    126: #define HM_HELP_INDEX                 HM_MSG_BASE+0x000a
                    127: #define HM_HELP_CONTENTS              HM_MSG_BASE+0x000b
                    128: #define HM_KEYS_HELP                  HM_MSG_BASE+0x000c
                    129: #define HM_SET_HELP_LIBRARY_NAME       HM_MSG_BASE+0x000d
                    130: 
                    131: /******************************************************************************/
                    132: /* Messages the IPF sends to the applications active window                  */
                    133: /* as defined by the IPF.                                                    */
                    134: /******************************************************************************/
                    135: 
                    136: #define HM_ERROR                      HM_MSG_BASE+0x000e
                    137: #define HM_HELPSUBITEM_NOT_FOUND       HM_MSG_BASE+0x000f
                    138: #define HM_QUERY_KEYS_HELP            HM_MSG_BASE+0x0010
                    139: #define HM_TUTORIAL                   HM_MSG_BASE+0x0011
                    140: #define HM_EXT_HELP_UNDEFINED         HM_MSG_BASE+0x0012
                    141: #define HM_ACTIONBAR_COMMAND          HM_MSG_BASE+0x0013
                    142: #define HM_INFORM                     HM_MSG_BASE+0x0014
                    143: 
                    144: /******************************************************************************/
                    145: /* HMERR_NO_FRAME_WND_IN_CHAIN - There is no frame window in the             */
                    146: /* window chain from which to find or set the associated help                */
                    147: /* instance.                                                                 */
                    148: /******************************************************************************/
                    149: 
                    150: #define         HMERR_NO_FRAME_WND_IN_CHAIN                0x00001001L
                    151: 
                    152: /******************************************************************************/
                    153: /* HMERR_INVALID_ASSOC_APP_WND - The application window handle               */
                    154: /* specified on the WinAssociateHelpInstance() call is not a valid           */
                    155: /* window handle.                                                            */
                    156: /******************************************************************************/
                    157: 
                    158: #define         HMERR_INVALID_ASSOC_APP_WND                0x00001002L
                    159: 
                    160: /******************************************************************************/
                    161: /* HMERR_INVALID_ASSOC_HELP_INST - The help instance handle specified        */
                    162: /* on the WinAssociateHelpInstance() call is not a valid                     */
                    163: /* window handle.                                                            */
                    164: /******************************************************************************/
                    165: 
                    166: #define         HMERR_INVALID_ASSOC_HELP_INST              0x00001003L
                    167: 
                    168: /******************************************************************************/
                    169: /* HMERR_INVALID_DESTROY_HELP_INST - The window handle specified             */
                    170: /* as the help instance to destroy is not of the help instance class.        */
                    171: /******************************************************************************/
                    172: 
                    173: #define         HMERR_INVALID_DESTROY_HELP_INST            0x00001004L
                    174: 
                    175: /******************************************************************************/
                    176: /* HMERR_NO_HELP_INST_IN_CHAIN - The parent or owner chain of the            */
                    177: /* application window specified does not have a help instance                */
                    178: /* associated with it.                                                       */
                    179: /******************************************************************************/
                    180: 
                    181: #define         HMERR_NO_HELP_INST_IN_CHAIN                0x00001005L
                    182: 
                    183: /******************************************************************************/
                    184: /* HMERR_INVALID_HELP_INSTANCE_HDL - The handle specified to be a            */
                    185: /* help instance does not have the class name of a IPF                       */
                    186: /* help instance.                                                            */
                    187: /******************************************************************************/
                    188: 
                    189: #define         HMERR_INVALID_HELP_INSTANCE_HDL            0x00001006L
                    190: 
                    191: /******************************************************************************/
                    192: /* HMERR_INVALID_QUERY_APP_WND - The application window specified on         */
                    193: /* a WinQueryHelpInstance() call is not a valid window handle.               */
                    194: /******************************************************************************/
                    195: 
                    196: #define         HMERR_INVALID_QUERY_APP_WND                0x00001007L
                    197: 
                    198: /******************************************************************************/
                    199: /* HMERR_HELP_INST_CALLED_INVALID -  The handle of the help instance         */
                    200: /* specified on an API call to the IPF does not have the                     */
                    201: /* class name of an IPF help instance.                                       */
                    202: /******************************************************************************/
                    203: 
                    204: #define         HMERR_HELP_INST_CALLED_INVALID             0x00001008L
                    205: #define         HMERR_HELPTABLE_UNDEFINE                   0x00001009L
                    206: #define         HMERR_HELP_INSTANCE_UNDEFINE               0x0000100aL
                    207: #define         HMERR_HELPITEM_NOT_FOUND                   0x0000100bL
                    208: #define         HMERR_INVALID_HELPSUBITEM_SIZE             0x0000100cL
                    209: #define         HMERR_HELPSUBITEM_NOT_FOUND                0x0000100dL
                    210: 
                    211: /******************************************************************************/
                    212: /* HMERR_INDEX_NOT_FOUND - No index in library file.                         */
                    213: /******************************************************************************/
                    214: 
                    215: #define         HMERR_INDEX_NOT_FOUND                      0x00002001L
                    216: 
                    217: /******************************************************************************/
                    218: /* HMERR_CONTENT_NOT_FOUND - Library file does not have any contents.        */
                    219: /******************************************************************************/
                    220: 
                    221: #define         HMERR_CONTENT_NOT_FOUND                    0x00002002L
                    222: 
                    223: /******************************************************************************/
                    224: /* HMERR_OPEN_LIB_FILE    - Cannot open library file.                        */
                    225: /******************************************************************************/
                    226: 
                    227: #define         HMERR_OPEN_LIB_FILE                        0x00002003L
                    228: 
                    229: /******************************************************************************/
                    230: /* HMERR_READ_LIB_FILE    - Cannot read library file.                        */
                    231: /******************************************************************************/
                    232: 
                    233: #define         HMERR_READ_LIB_FILE                        0x00002004L
                    234: 
                    235: /******************************************************************************/
                    236: /* HMERR_CLOSE_LIB_FILE           - Cannot close library file.                       */
                    237: /******************************************************************************/
                    238: 
                    239: #define         HMERR_CLOSE_LIB_FILE                       0x00002005L
                    240: 
                    241: /******************************************************************************/
                    242: /* HMERR_INVALID_LIB_FILE  - Improper library file provided.                 */
                    243: /******************************************************************************/
                    244: 
                    245: #define         HMERR_INVALID_LIB_FILE                     0x00002006L
                    246: 
                    247: /******************************************************************************/
                    248: /* HMERR_NO_MEMORY - Unable to allocate the requested amount of memory.              */
                    249: /******************************************************************************/
                    250: 
                    251: #define         HMERR_NO_MEMORY                            0x00002007L
                    252: 
                    253: /******************************************************************************/
                    254: /* HMERR_ALLOCATE_SEGMENT - Unable                                           */
                    255: /* to allocate a segment of memory for memory allocation requested           */
                    256: /* from the IPF.                                                             */
                    257: /******************************************************************************/
                    258: 
                    259: #define         HMERR_ALLOCATE_SEGMENT                     0x00002008L
                    260: 
                    261: /******************************************************************************/
                    262: /* HMERR_FREE_MEMORY - Unable to free allocated         memory.                      */
                    263: /******************************************************************************/
                    264: 
                    265: #define         HMERR_FREE_MEMORY                          0x00002009L
                    266: 
                    267: /******************************************************************************/
                    268: /* HMERR_PANEL_NOT_FOUND  - Unable                                           */
                    269: /* to find a help panel requested to IPF.                                    */
                    270: /******************************************************************************/
                    271: 
                    272: #define         HMERR_PANEL_NOT_FOUND                      0x00002010L
                    273: 
                    274: /******************************************************************************/
                    275: /* HMERR_DATABASE_NOT_OPEN - Unable to read the unopened database.           */
                    276: /******************************************************************************/
                    277: 
                    278: #define         HMERR_DATABASE_NOT_OPEN                    0x00002011L
                    279: 
                    280: #endif

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.