home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource1 / program3 / pmhelp.pas < prev    next >
Pascal/Delphi Source File  |  1993-11-23  |  14KB  |  279 lines
  1. {**************************************************************************\
  2. *
  3. * Module Name: PMHELP.H
  4. *
  5. * OS/2 Information Presentation Facility (IPF) for providing Help
  6. *
  7. * Copyright (c) International Business Machines Corporation 1989, 1990
  8. *
  9. *****************************************************************************
  10. }
  11. {| Version:   1.00
  12.  | Original translation: Peter Sawatzki (ps)
  13.  | Contributing:
  14.  |   Peter Sawatzki ps
  15.  |
  16.  | change history:
  17.  | Date:    Ver: Author:
  18.  | 11/11/93 1.00 ps     original translation by ps
  19. }
  20. Unit PmHelp;
  21. Interface
  22. Uses
  23.   Os2Def;
  24. Type
  25. {****************************************************************************}
  26. { HelpSubTable entry structure                                               }
  27. {****************************************************************************}
  28.   HELPSUBTABLE = Integer;
  29.   pHELPSUBTABLE = ^HELPSUBTABLE;
  30.  
  31. {****************************************************************************}
  32. { HelpTable entry structure                                                  }
  33. {****************************************************************************}
  34.  
  35.   HELPTABLE = Record
  36.     idAppWindow: USHORT;
  37.     phstHelpSubTable: pHELPSUBTABLE;
  38.     idExtPanel: USHORT
  39.   End;
  40.   pHELPTABLE = ^HELPTABLE;
  41.  
  42. {****************************************************************************}
  43. { IPF Initialization Structure used on the                                   }
  44. { WinCreateHelpInstance() call.                                              }
  45. {****************************************************************************}
  46.  
  47.   HELPINIT = Record
  48.     cb: USHORT;
  49.     ulReturnCode: ULONG;
  50.     pszTutorialName: pSZ;
  51.     phtHelpTable: pHELPTABLE;
  52.     hmodHelpTableModule,
  53.     hmodAccelActionBarModule: HMODULE;
  54.     idAccelTable,
  55.     idActionBar: USHORT;
  56.     pszHelpWindowTitle:pSZ;
  57.     usShowPanelId: USHORT;
  58.     pszHelpLibraryName: pSZ
  59.   End;
  60.   pHELPINIT = HELPINIT;
  61.  
  62. Const
  63. {****************************************************************************}
  64. { Search parent chain indicator for HM_SET_ACTIVE_WINDOW message.            }
  65. {****************************************************************************}
  66.   HWND_PARENT = HWND(0);
  67.  
  68. {****************************************************************************}
  69. { Constants used to define whether user wants to display panel using         }
  70. { panel number or panel name.                                                }
  71. {****************************************************************************}
  72.   HM_RESOURCEID          = 0;
  73.   HM_PANELNAME           = 1;
  74.   HMPANELTYPE_NUMBER     = 0;
  75.   HMPANELTYPE_NAME       = 1;
  76.  
  77. {****************************************************************************}
  78. { Constants used to define how the panel IDs are displayed on                }
  79. { help panels.                                                               }
  80. {****************************************************************************}
  81.  
  82.   CMIC_HIDE_PANEL_ID      = $0000;
  83.   CMIC_SHOW_PANEL_ID      = $0001;
  84.   CMIC_TOGGLE_PANEL_ID    = $0002;
  85.  
  86. {****************************************************************************}
  87. { Window Help function declarations.                                         }
  88. {****************************************************************************}
  89.  
  90. Function  WinDestroyHelpInstance(hwndHelpInstance: HWND): BOOL;
  91. Function  WinCreateHelpInstance(_hab: HAB; phinitHMInitStructure: PHELPINIT): HWND;
  92. Function  WinAssociateHelpInstance(hwndHelpInstance, hwndApp: HWND): BOOL;
  93. Function  WinQueryHelpInstance(hwndApp: HWND): HWND;
  94. Function  WinLoadHelpTable (hwndHelpInstance: HWND; idHelpTable: USHORT;
  95.                             Module: HMODULE): BOOL;
  96. Function  WinCreateHelpTable (hwndHelpInstance: HWND; phtHelpTable: PHELPTABLE): BOOL;
  97.  
  98. Const
  99. {****************************************************************************}
  100. { IPF message base.                                                          }
  101. {****************************************************************************}
  102.   HM_MSG_BASE             = $0220;
  103.  
  104. {****************************************************************************}
  105. { Messages applications can send to the IPF.                                 }
  106. {****************************************************************************}
  107.  
  108.   HM_DISMISS_WINDOW            = HM_MSG_BASE+$0001;
  109.   HM_DISPLAY_HELP              = HM_MSG_BASE+$0002;
  110.   HM_EXT_HELP                  = HM_MSG_BASE+$0003;
  111.   HM_SET_ACTIVE_WINDOW         = HM_MSG_BASE+$0004;
  112.   HM_LOAD_HELP_TABLE           = HM_MSG_BASE+$0005;
  113.   HM_CREATE_HELP_TABLE         = HM_MSG_BASE+$0006;
  114.   HM_SET_HELP_WINDOW_TITLE     = HM_MSG_BASE+$0007;
  115.   HM_SET_SHOW_PANEL_ID         = HM_MSG_BASE+$0008;
  116.   HM_REPLACE_HELP_FOR_HELP     = HM_MSG_BASE+$0009;
  117.   HM_HELP_INDEX                = HM_MSG_BASE+$000a;
  118.   HM_HELP_CONTENTS             = HM_MSG_BASE+$000b;
  119.   HM_KEYS_HELP                 = HM_MSG_BASE+$000c;
  120.   HM_SET_HELP_LIBRARY_NAME     = HM_MSG_BASE+$000d;
  121.  
  122. {****************************************************************************}
  123. { Messages the IPF sends to the applications active window                   }
  124. { as defined by the IPF.                                                     }
  125. {****************************************************************************}
  126.  
  127.   HM_ERROR                     = HM_MSG_BASE+$000e;
  128.   HM_HELPSUBITEM_NOT_FOUND     = HM_MSG_BASE+$000f;
  129.   HM_QUERY_KEYS_HELP           = HM_MSG_BASE+$0010;
  130.   HM_TUTORIAL                  = HM_MSG_BASE+$0011;
  131.   HM_EXT_HELP_UNDEFINED        = HM_MSG_BASE+$0012;
  132.   HM_ACTIONBAR_COMMAND         = HM_MSG_BASE+$0013;
  133.   HM_INFORM                    = HM_MSG_BASE+$0014;
  134.  
  135. {****************************************************************************}
  136. { HMERR_NO_FRAME_WND_IN_CHAIN - There is no frame window in the              }
  137. { window chain from which to find or set the associated help                 }
  138. { instance.                                                                  }
  139. {****************************************************************************}
  140.  
  141.   HMERR_NO_FRAME_WND_IN_CHAIN              = $00001001;
  142.  
  143. {****************************************************************************}
  144. { HMERR_INVALID_ASSOC_APP_WND - The application window handle                }
  145. { specified on the WinAssociateHelpInstance() call is not a valid            }
  146. { window handle.                                                             }
  147. {****************************************************************************}
  148.  
  149.   HMERR_INVALID_ASSOC_APP_WND              = $00001002;
  150.  
  151. {****************************************************************************}
  152. { HMERR_INVALID_ASSOC_HELP_INST - The help instance handle specified         }
  153. { on the WinAssociateHelpInstance() call is not a valid                      }
  154. { window handle.                                                             }
  155. {****************************************************************************}
  156.  
  157.   HMERR_INVALID_ASSOC_HELP_INST            = $00001003;
  158.  
  159. {****************************************************************************}
  160. { HMERR_INVALID_DESTROY_HELP_INST - The window handle specified              }
  161. { as the help instance to destroy is not of the help instance class.         }
  162. {****************************************************************************}
  163.  
  164.   HMERR_INVALID_DESTROY_HELP_INST          = $00001004;
  165.  
  166. {****************************************************************************}
  167. { HMERR_NO_HELP_INST_IN_CHAIN - The parent or owner chain of the             }
  168. { application window specified does not have a help instance                 }
  169. { associated with it.                                                        }
  170. {****************************************************************************}
  171.  
  172.   HMERR_NO_HELP_INST_IN_CHAIN              = $00001005;
  173.  
  174. {****************************************************************************}
  175. { HMERR_INVALID_HELP_INSTANCE_HDL - The handle specified to be a             }
  176. { help instance does not have the cl