|
|
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
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.