HtmlHelp.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:18k
源码类别:

模拟服务器

开发平台:

C/C++

  1. /****************************************************************************
  2. *                                                                           *
  3. * HtmlHelp.h                                                                *
  4. *                                                                           *
  5. * Copyright (c) 1996-1997, Microsoft Corp. All rights reserved.             *
  6. *                                                                           *
  7. ****************************************************************************/
  8. #if _MSC_VER > 1000
  9. #pragma once
  10. #endif
  11. #ifndef __HTMLHELP_H__
  12. #define __HTMLHELP_H__
  13. #ifdef __cplusplus
  14. extern "C" {
  15. #endif  // __cplusplus
  16. #if _MSC_VER < 1200
  17. // Defines for Win64
  18. #ifndef _WIN64
  19. #define DWORD_PTR DWORD
  20. #endif
  21. #endif
  22. // Commands to pass to HtmlHelp()
  23. #define HH_DISPLAY_TOPIC        0x0000
  24. #define HH_HELP_FINDER          0x0000  // WinHelp equivalent
  25. #define HH_DISPLAY_TOC          0x0001  
  26. #define HH_DISPLAY_INDEX        0x0002  
  27. #define HH_DISPLAY_SEARCH       0x0003  
  28. #define HH_SET_WIN_TYPE         0x0004
  29. #define HH_GET_WIN_TYPE         0x0005
  30. #define HH_GET_WIN_HANDLE       0x0006
  31. #define HH_ENUM_INFO_TYPE       0x0007  // Get Info type name, call repeatedly to enumerate, -1 at end
  32. #define HH_SET_INFO_TYPE        0x0008  // Add Info type to filter.
  33. #define HH_SYNC                 0x0009
  34. #define HH_RESERVED1            0x000A
  35. #define HH_RESERVED2            0x000B
  36. #define HH_RESERVED3            0x000C
  37. #define HH_KEYWORD_LOOKUP       0x000D
  38. #define HH_DISPLAY_TEXT_POPUP   0x000E  // display string resource id or text in a popup window
  39. #define HH_HELP_CONTEXT         0x000F  // display mapped numeric value in dwData
  40. #define HH_TP_HELP_CONTEXTMENU  0x0010  // text popup help, same as WinHelp HELP_CONTEXTMENU
  41. #define HH_TP_HELP_WM_HELP      0x0011  // text popup help, same as WinHelp HELP_WM_HELP
  42. #define HH_CLOSE_ALL            0x0012  // close all windows opened directly or indirectly by the caller
  43. #define HH_ALINK_LOOKUP         0x0013  // ALink version of HH_KEYWORD_LOOKUP
  44. #define HH_GET_LAST_ERROR       0x0014  // not currently implemented // See HHERROR.h
  45. #define HH_ENUM_CATEGORY        0x0015 // Get category name, call repeatedly to enumerate, -1 at end
  46. #define HH_ENUM_CATEGORY_IT     0x0016  // Get category info type members, call repeatedly to enumerate, -1 at end
  47. #define HH_RESET_IT_FILTER      0x0017  // Clear the info type filter of all info types.
  48. #define HH_SET_INCLUSIVE_FILTER 0x0018  // set inclusive filtering method for untyped topics to be included in display
  49. #define HH_SET_EXCLUSIVE_FILTER 0x0019  // set exclusive filtering method for untyped topics to be excluded from display
  50. #define HH_INITIALIZE           0x001C  // Initializes the help system.
  51. #define HH_UNINITIALIZE         0x001D  // Uninitializes the help system.
  52. #define HH_SET_QUERYSERVICE     0x001E  // Set the Host IQueryService interface
  53. #define HH_PRETRANSLATEMESSAGE  0x00fd  // Pumps messages. (NULL, NULL, MSG*). 
  54. #define HH_SET_GLOBAL_PROPERTY  0x00fc  // Set a global property. (NULL, NULL, HH_GPROP)
  55. #define HHWIN_PROP_TAB_AUTOHIDESHOW (1 << 0)    // Automatically hide/show tri-pane window
  56. #define HHWIN_PROP_ONTOP            (1 << 1)    // Top-most window
  57. #define HHWIN_PROP_NOTITLEBAR       (1 << 2)    // no title bar
  58. #define HHWIN_PROP_NODEF_STYLES     (1 << 3)    // no default window styles (only HH_WINTYPE.dwStyles)
  59. #define HHWIN_PROP_NODEF_EXSTYLES   (1 << 4)    // no default extended window styles (only HH_WINTYPE.dwExStyles)
  60. #define HHWIN_PROP_TRI_PANE         (1 << 5)    // use a tri-pane window
  61. #define HHWIN_PROP_NOTB_TEXT        (1 << 6)    // no text on toolbar buttons
  62. #define HHWIN_PROP_POST_QUIT        (1 << 7)    // post WM_QUIT message when window closes
  63. #define HHWIN_PROP_AUTO_SYNC        (1 << 8)    // automatically ssync contents and index
  64. #define HHWIN_PROP_TRACKING         (1 << 9)    // send tracking notification messages
  65. #define HHWIN_PROP_TAB_SEARCH       (1 << 10)   // include search tab in navigation pane
  66. #define HHWIN_PROP_TAB_HISTORY      (1 << 11)   // include history tab in navigation pane
  67. #define HHWIN_PROP_TAB_FAVORITES    (1 << 12)   // include favorites tab in navigation pane
  68. #define HHWIN_PROP_CHANGE_TITLE     (1 << 13)   // Put current HTML title in title bar
  69. #define HHWIN_PROP_NAV_ONLY_WIN     (1 << 14)   // Only display the navigation window
  70. #define HHWIN_PROP_NO_TOOLBAR       (1 << 15)   // Don't display a toolbar
  71. #define HHWIN_PROP_MENU             (1 << 16)   // Menu
  72. #define HHWIN_PROP_TAB_ADVSEARCH    (1 << 17)   // Advanced FTS UI.
  73. #define HHWIN_PROP_USER_POS         (1 << 18)   // After initial creation, user controls window size/position
  74. #define HHWIN_PROP_TAB_CUSTOM1      (1 << 19)   // Use custom tab #1
  75. #define HHWIN_PROP_TAB_CUSTOM2      (1 << 20)   // Use custom tab #2
  76. #define HHWIN_PROP_TAB_CUSTOM3      (1 << 21)   // Use custom tab #3
  77. #define HHWIN_PROP_TAB_CUSTOM4      (1 << 22)   // Use custom tab #4
  78. #define HHWIN_PROP_TAB_CUSTOM5      (1 << 23)   // Use custom tab #5
  79. #define HHWIN_PROP_TAB_CUSTOM6      (1 << 24)   // Use custom tab #6
  80. #define HHWIN_PROP_TAB_CUSTOM7      (1 << 25)   // Use custom tab #7
  81. #define HHWIN_PROP_TAB_CUSTOM8      (1 << 26)   // Use custom tab #8
  82. #define HHWIN_PROP_TAB_CUSTOM9      (1 << 27)   // Use custom tab #9
  83. #define HHWIN_TB_MARGIN             (1 << 28)   // the window type has a margin
  84. #define HHWIN_PARAM_PROPERTIES      (1 << 1)    // valid fsWinProperties
  85. #define HHWIN_PARAM_STYLES          (1 << 2)    // valid dwStyles
  86. #define HHWIN_PARAM_EXSTYLES        (1 << 3)    // valid dwExStyles
  87. #define HHWIN_PARAM_RECT            (1 << 4)    // valid rcWindowPos
  88. #define HHWIN_PARAM_NAV_WIDTH       (1 << 5)    // valid iNavWidth
  89. #define HHWIN_PARAM_SHOWSTATE       (1 << 6)    // valid nShowState
  90. #define HHWIN_PARAM_INFOTYPES       (1 << 7)    // valid apInfoTypes
  91. #define HHWIN_PARAM_TB_FLAGS        (1 << 8)    // valid fsToolBarFlags
  92. #define HHWIN_PARAM_EXPANSION       (1 << 9)    // valid fNotExpanded
  93. #define HHWIN_PARAM_TABPOS          (1 << 10)   // valid tabpos
  94. #define HHWIN_PARAM_TABORDER        (1 << 11)   // valid taborder
  95. #define HHWIN_PARAM_HISTORY_COUNT   (1 << 12)   // valid cHistory
  96. #define HHWIN_PARAM_CUR_TAB         (1 << 13)   // valid curNavType
  97. #define HHWIN_BUTTON_EXPAND         (1 << 1)    // Expand/contract button
  98. #define HHWIN_BUTTON_BACK           (1 << 2)    // Back button
  99. #define HHWIN_BUTTON_FORWARD        (1 << 3)    // Forward button
  100. #define HHWIN_BUTTON_STOP           (1 << 4)    // Stop button
  101. #define HHWIN_BUTTON_REFRESH        (1 << 5)    // Refresh button
  102. #define HHWIN_BUTTON_HOME           (1 << 6)    // Home button
  103. #define HHWIN_BUTTON_BROWSE_FWD     (1 << 7)    // not implemented
  104. #define HHWIN_BUTTON_BROWSE_BCK     (1 << 8)    // not implemented
  105. #define HHWIN_BUTTON_NOTES          (1 << 9)    // not implemented
  106. #define HHWIN_BUTTON_CONTENTS       (1 << 10)   // not implemented
  107. #define HHWIN_BUTTON_SYNC           (1 << 11)   // Sync button
  108. #define HHWIN_BUTTON_OPTIONS        (1 << 12)   // Options button
  109. #define HHWIN_BUTTON_PRINT          (1 << 13)   // Print button
  110. #define HHWIN_BUTTON_INDEX          (1 << 14)   // not implemented
  111. #define HHWIN_BUTTON_SEARCH         (1 << 15)   // not implemented
  112. #define HHWIN_BUTTON_HISTORY        (1 << 16)   // not implemented
  113. #define HHWIN_BUTTON_FAVORITES      (1 << 17)   // not implemented
  114. #define HHWIN_BUTTON_JUMP1          (1 << 18)
  115. #define HHWIN_BUTTON_JUMP2          (1 << 19)
  116. #define HHWIN_BUTTON_ZOOM           (1 << 20)
  117. #define HHWIN_BUTTON_TOC_NEXT       (1 << 21)
  118. #define HHWIN_BUTTON_TOC_PREV       (1 << 22)
  119. #define HHWIN_DEF_BUTTONS           
  120.             (HHWIN_BUTTON_EXPAND |  
  121.              HHWIN_BUTTON_BACK |    
  122.              HHWIN_BUTTON_OPTIONS | 
  123.              HHWIN_BUTTON_PRINT)
  124. // Button IDs
  125. #define IDTB_EXPAND             200
  126. #define IDTB_CONTRACT           201
  127. #define IDTB_STOP               202
  128. #define IDTB_REFRESH            203
  129. #define IDTB_BACK               204
  130. #define IDTB_HOME               205
  131. #define IDTB_SYNC               206
  132. #define IDTB_PRINT              207
  133. #define IDTB_OPTIONS            208
  134. #define IDTB_FORWARD            209
  135. #define IDTB_NOTES              210 // not implemented
  136. #define IDTB_BROWSE_FWD         211
  137. #define IDTB_BROWSE_BACK        212
  138. #define IDTB_CONTENTS           213 // not implemented
  139. #define IDTB_INDEX              214 // not implemented
  140. #define IDTB_SEARCH             215 // not implemented
  141. #define IDTB_HISTORY            216 // not implemented
  142. #define IDTB_FAVORITES          217 // not implemented
  143. #define IDTB_JUMP1              218
  144. #define IDTB_JUMP2              219
  145. #define IDTB_CUSTOMIZE          221
  146. #define IDTB_ZOOM               222
  147. #define IDTB_TOC_NEXT           223
  148. #define IDTB_TOC_PREV           224
  149. // Notification codes
  150. #define HHN_FIRST       (0U-860U)
  151. #define HHN_LAST        (0U-879U)
  152. #define HHN_NAVCOMPLETE   (HHN_FIRST-0)
  153. #define HHN_TRACK         (HHN_FIRST-1)
  154. #define HHN_WINDOW_CREATE (HHN_FIRST-2)
  155. typedef struct tagHHN_NOTIFY
  156. {
  157.     NMHDR   hdr;
  158.     PCSTR   pszUrl; // Multi-byte, null-terminated string
  159. } HHN_NOTIFY;
  160. typedef struct tagHH_POPUP
  161. {
  162.     int       cbStruct;      // sizeof this structure
  163.     HINSTANCE hinst;         // instance handle for string resource
  164.     UINT      idString;      // string resource id, or text id if pszFile is specified in HtmlHelp call
  165.     LPCTSTR   pszText;       // used if idString is zero
  166.     POINT     pt;            // top center of popup window
  167.     COLORREF  clrForeground; // use -1 for default
  168.     COLORREF  clrBackground; // use -1 for default
  169.     RECT      rcMargins;     // amount of space between edges of window and text, -1 for each member to ignore
  170.     LPCTSTR   pszFont;       // facename, point size, char set, BOLD ITALIC UNDERLINE
  171. } HH_POPUP;
  172. typedef struct tagHH_AKLINK
  173. {
  174.     int       cbStruct;     // sizeof this structure
  175.     BOOL      fReserved;    // must be FALSE (really!)
  176.     LPCTSTR   pszKeywords;  // semi-colon separated keywords
  177.     LPCTSTR   pszUrl;       // URL to jump to if no keywords found (may be NULL)
  178.     LPCTSTR   pszMsgText;   // Message text to display in MessageBox if pszUrl is NULL and no keyword match
  179.     LPCTSTR   pszMsgTitle;  // Message text to display in MessageBox if pszUrl is NULL and no keyword match
  180.     LPCTSTR   pszWindow;    // Window to display URL in
  181.     BOOL      fIndexOnFail; // Displays index if keyword lookup fails.
  182. } HH_AKLINK;
  183. enum {
  184.     HHWIN_NAVTYPE_TOC,
  185.     HHWIN_NAVTYPE_INDEX,
  186.     HHWIN_NAVTYPE_SEARCH,
  187.     HHWIN_NAVTYPE_FAVORITES,
  188.     HHWIN_NAVTYPE_HISTORY,   // not implemented
  189.     HHWIN_NAVTYPE_AUTHOR,
  190.     HHWIN_NAVTYPE_CUSTOM_FIRST = 11
  191. };
  192. enum {
  193.     IT_INCLUSIVE,
  194.     IT_EXCLUSIVE,
  195.     IT_HIDDEN,
  196. };
  197. typedef struct tagHH_ENUM_IT
  198. {
  199.     int       cbStruct;          // size of this structure
  200.     int       iType;             // the type of the information type ie. Inclusive, Exclusive, or Hidden
  201.     LPCSTR    pszCatName;        // Set to the name of the Category to enumerate the info types in a category; else NULL
  202.     LPCSTR    pszITName;         // volitile pointer to the name of the infotype. Allocated by call. Caller responsible for freeing
  203.     LPCSTR    pszITDescription;  // volitile pointer to the description of the infotype.
  204. } HH_ENUM_IT, *PHH_ENUM_IT;
  205. typedef struct tagHH_ENUM_CAT
  206. {
  207.     int       cbStruct;          // size of this structure
  208.     LPCSTR    pszCatName;        // volitile pointer to the category name
  209.     LPCSTR    pszCatDescription; // volitile pointer to the category description
  210. } HH_ENUM_CAT, *PHH_ENUM_CAT;
  211. typedef struct tagHH_SET_INFOTYPE
  212. {
  213.     int       cbStruct;          // the size of this structure
  214.     LPCSTR    pszCatName;        // the name of the category, if any, the InfoType is a member of.
  215.     LPCSTR    pszInfoTypeName;   // the name of the info type to add to the filter
  216. } HH_SET_INFOTYPE, *PHH_SET_INFOTYPE;
  217. typedef DWORD HH_INFOTYPE;
  218. typedef HH_INFOTYPE* PHH_INFOTYPE;
  219. enum {
  220.     HHWIN_NAVTAB_TOP,
  221.     HHWIN_NAVTAB_LEFT,
  222.     HHWIN_NAVTAB_BOTTOM,
  223. };
  224. #define HH_MAX_TABS 19  // maximum number of tabs
  225. enum {
  226.     HH_TAB_CONTENTS,
  227.     HH_TAB_INDEX,
  228.     HH_TAB_SEARCH,
  229.     HH_TAB_FAVORITES,
  230.     HH_TAB_HISTORY,
  231.     HH_TAB_AUTHOR,
  232.     HH_TAB_CUSTOM_FIRST = 11,
  233.     HH_TAB_CUSTOM_LAST = HH_MAX_TABS
  234. };
  235. #define HH_MAX_TABS_CUSTOM (HH_TAB_CUSTOM_LAST - HH_TAB_CUSTOM_FIRST + 1)
  236. // HH_DISPLAY_SEARCH Command Related Structures and Constants
  237. #define HH_FTS_DEFAULT_PROXIMITY (-1)
  238. typedef struct tagHH_FTS_QUERY
  239. {
  240.     int cbStruct;            // Sizeof structure in bytes.
  241.     BOOL fUniCodeStrings;    // TRUE if all strings are unicode.
  242.     LPCTSTR pszSearchQuery;  // String containing the search query.
  243.     LONG iProximity;         // Word proximity.
  244.     BOOL fStemmedSearch;     // TRUE for StemmedSearch only.
  245.     BOOL fTitleOnly;         // TRUE for Title search only.
  246.     BOOL fExecute;           // TRUE to initiate the search.
  247.     LPCTSTR pszWindow;       // Window to display in
  248. } HH_FTS_QUERY;
  249. // HH_WINTYPE Structure
  250. typedef struct tagHH_WINTYPE {
  251.     int     cbStruct;        // IN: size of this structure including all Information Types
  252.     BOOL    fUniCodeStrings; // IN/OUT: TRUE if all strings are in UNICODE
  253.     LPCTSTR pszType;         // IN/OUT: Name of a type of window
  254.     DWORD   fsValidMembers;  // IN: Bit flag of valid members (HHWIN_PARAM_)
  255.     DWORD   fsWinProperties; // IN/OUT: Properties/attributes of the window (HHWIN_)
  256.     LPCTSTR pszCaption;      // IN/OUT: Window title
  257.     DWORD   dwStyles;        // IN/OUT: Window styles
  258.     DWORD   dwExStyles;      // IN/OUT: Extended Window styles
  259.     RECT    rcWindowPos;     // IN: Starting position, OUT: current position
  260.     int     nShowState;      // IN: show state (e.g., SW_SHOW)
  261.     HWND  hwndHelp;          // OUT: window handle
  262.     HWND  hwndCaller;        // OUT: who called this window
  263.     HH_INFOTYPE* paInfoTypes;  // IN: Pointer to an array of Information Types
  264.     // The following members are only valid if HHWIN_PROP_TRI_PANE is set
  265.     HWND  hwndToolBar;      // OUT: toolbar window in tri-pane window
  266.     HWND  hwndNavigation;   // OUT: navigation window in tri-pane window
  267.     HWND  hwndHTML;         // OUT: window displaying HTML in tri-pane window
  268.     int   iNavWidth;        // IN/OUT: width of navigation window
  269.     RECT  rcHTML;           // OUT: HTML window coordinates
  270.     LPCTSTR pszToc;         // IN: Location of the table of contents file
  271.     LPCTSTR pszIndex;       // IN: Location of the index file
  272.     LPCTSTR pszFile;        // IN: Default location of the html file
  273.     LPCTSTR pszHome;        // IN/OUT: html file to display when Home button is clicked
  274.     DWORD   fsToolBarFlags; // IN: flags controling the appearance of the toolbar
  275.     BOOL    fNotExpanded;   // IN: TRUE/FALSE to contract or expand, OUT: current state
  276.     int     curNavType;     // IN/OUT: UI to display in the navigational pane
  277.     int     tabpos;         // IN/OUT: HHWIN_NAVTAB_TOP, HHWIN_NAVTAB_LEFT, or HHWIN_NAVTAB_BOTTOM
  278.     int     idNotify;       // IN: ID to use for WM_NOTIFY messages
  279.     BYTE    tabOrder[HH_MAX_TABS + 1];    // IN/OUT: tab order: Contents, Index, Search, History, Favorites, Reserved 1-5, Custom tabs
  280.     int     cHistory;       // IN/OUT: number of history items to keep (default is 30)
  281.     LPCTSTR pszJump1;       // Text for HHWIN_BUTTON_JUMP1
  282.     LPCTSTR pszJump2;       // Text for HHWIN_BUTTON_JUMP2
  283.     LPCTSTR pszUrlJump1;    // URL for HHWIN_BUTTON_JUMP1
  284.     LPCTSTR pszUrlJump2;    // URL for HHWIN_BUTTON_JUMP2
  285.     RECT    rcMinSize;      // Minimum size for window (ignored in version 1)
  286.     int     cbInfoTypes;    // size of paInfoTypes;
  287.     LPCTSTR pszCustomTabs;  // multiple zero-terminated strings
  288. } HH_WINTYPE, *PHH_WINTYPE;
  289. enum {
  290.     HHACT_TAB_CONTENTS,
  291.     HHACT_TAB_INDEX,
  292.     HHACT_TAB_SEARCH,
  293.     HHACT_TAB_HISTORY,
  294.     HHACT_TAB_FAVORITES,
  295.     HHACT_EXPAND,
  296.     HHACT_CONTRACT,
  297.     HHACT_BACK,
  298.     HHACT_FORWARD,
  299.     HHACT_STOP,
  300.     HHACT_REFRESH,
  301.     HHACT_HOME,
  302.     HHACT_SYNC,
  303.     HHACT_OPTIONS,
  304.     HHACT_PRINT,
  305.     HHACT_HIGHLIGHT,
  306.     HHACT_CUSTOMIZE,
  307.     HHACT_JUMP1,
  308.     HHACT_JUMP2,
  309.     HHACT_ZOOM,
  310.     HHACT_TOC_NEXT,
  311.     HHACT_TOC_PREV,
  312.     HHACT_NOTES,
  313.     HHACT_LAST_ENUM,
  314. };
  315. typedef struct tagHHNTRACK
  316. {
  317.     NMHDR   hdr;
  318.     PCSTR   pszCurUrl;      // Multi-byte, null-terminated string
  319.     int     idAction;       // HHACT_ value
  320.     HH_WINTYPE* phhWinType; // Current window type structure
  321. } HHNTRACK;
  322. HWND
  323. WINAPI
  324. HtmlHelpA(
  325.     HWND hwndCaller,
  326.     LPCSTR pszFile,
  327.     UINT uCommand,
  328.     DWORD_PTR dwData
  329.     );
  330. HWND
  331. WINAPI
  332. HtmlHelpW(
  333.     HWND hwndCaller,
  334.     LPCWSTR pszFile,
  335.     UINT uCommand,
  336.     DWORD_PTR dwData
  337.     );
  338. #ifdef UNICODE
  339. #define HtmlHelp  HtmlHelpW
  340. #else
  341. #define HtmlHelp  HtmlHelpA
  342. #endif // !UNICODE
  343. // Use the following for GetProcAddress to load from hhctrl.ocx
  344. #define ATOM_HTMLHELP_API_ANSI    (LPTSTR)((DWORD)((WORD)(14)))
  345. #define ATOM_HTMLHELP_API_UNICODE (LPTSTR)((DWORD)((WORD)(15)))
  346. ///////////////////////////////////////////////////////////////////////////////
  347. //
  348. // Global Control Properties. 
  349. //
  350. typedef enum tagHH_GPROPID
  351. {
  352.     HH_GPROPID_SINGLETHREAD=1,      // VARIANT_BOOL: True for single thread
  353.     HH_GPROPID_TOOLBAR_MARGIN=2,    // long: Provides a left/right margin around the toolbar.
  354.     HH_GPROPID_UI_LANGUAGE=3,       // long: LangId of the UI.
  355.     HH_GPROPID_CURRENT_SUBSET=4,    // BSTR: Current subset.
  356.     HH_GPROPID_CONTENT_LANGUAGE=5   // long: LandId for desired content.
  357. } HH_GPROPID;
  358. ///////////////////////////////////////////////////////////////////////////////
  359. //
  360. // Global Property structure
  361. //
  362. #ifdef __oaidl_h__
  363. #pragma pack(push, 8)
  364. typedef struct tagHH_GLOBAL_PROPERTY
  365. {
  366.     HH_GPROPID  id;
  367.     VARIANT     var;
  368. } HH_GLOBAL_PROPERTY ;
  369. #pragma pack(pop)
  370. #endif
  371. #ifdef __cplusplus
  372. }
  373. #endif // __cplusplus
  374. #endif // __HTMLHELP_H__