2 * hhctrl implementation
4 * Copyright 2004 Krzysztof Foltman
5 * Copyright 2007 Jacek Caban for CodeWeavers
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "wine/debug.h"
39 WINE_DEFAULT_DEBUG_CHANNEL(htmlhelp
);
41 HINSTANCE hhctrl_hinstance
;
42 BOOL hh_process
= FALSE
;
44 extern struct list window_list
;
46 BOOL WINAPI
DllMain(HINSTANCE hInstance
, DWORD fdwReason
, LPVOID lpvReserved
)
48 TRACE("(%p,%d,%p)\n", hInstance
, fdwReason
, lpvReserved
);
52 case DLL_PROCESS_ATTACH
:
53 hhctrl_hinstance
= hInstance
;
54 DisableThreadLibraryCalls(hInstance
);
60 static const char *command_to_string(UINT command
)
62 #define X(x) case x: return #x
65 X( HH_DISPLAY_TOPIC
);
67 X( HH_DISPLAY_INDEX
);
68 X( HH_DISPLAY_SEARCH
);
71 X( HH_GET_WIN_HANDLE
);
72 X( HH_ENUM_INFO_TYPE
);
73 X( HH_SET_INFO_TYPE
);
78 X( HH_KEYWORD_LOOKUP
);
79 X( HH_DISPLAY_TEXT_POPUP
);
81 X( HH_TP_HELP_CONTEXTMENU
);
82 X( HH_TP_HELP_WM_HELP
);
85 X( HH_GET_LAST_ERROR
);
86 X( HH_ENUM_CATEGORY
);
87 X( HH_ENUM_CATEGORY_IT
);
88 X( HH_RESET_IT_FILTER
);
89 X( HH_SET_INCLUSIVE_FILTER
);
90 X( HH_SET_EXCLUSIVE_FILTER
);
93 X( HH_SAFE_DISPLAY_TOPIC
);
94 X( HH_PRETRANSLATEMESSAGE
);
95 X( HH_SET_GLOBAL_PROPERTY
);
96 default: return "???";
101 static BOOL
resolve_filename(const WCHAR
*filename
, WCHAR
*fullname
, DWORD buflen
, WCHAR
**index
, WCHAR
**window
)
104 WCHAR chm_file
[MAX_PATH
];
106 static const WCHAR helpW
[] = {'\\','h','e','l','p','\\',0};
107 static const WCHAR delimW
[] = {':',':',0};
108 static const WCHAR delim2W
[] = {'>',0};
110 filename
= skip_schema(filename
);
112 /* the format is "helpFile[::/index][>window]" */
113 if (index
) *index
= NULL
;
114 if (window
) *window
= NULL
;
116 extra
= strstrW(filename
, delim2W
);
119 memcpy(chm_file
, filename
, (extra
-filename
)*sizeof(WCHAR
));
120 chm_file
[extra
-filename
] = 0;
123 *window
= strdupW(extra
+1);
126 extra
= strstrW(filename
, delimW
);
129 if (filename
!= chm_file
)
130 memcpy(chm_file
, filename
, (extra
-filename
)*sizeof(WCHAR
));
131 chm_file
[extra
-filename
] = 0;
134 *index
= strdupW(extra
+2);
137 GetFullPathNameW(filename
, buflen
, fullname
, NULL
);
138 if (GetFileAttributesW(fullname
) == INVALID_FILE_ATTRIBUTES
)
140 GetWindowsDirectoryW(fullname
, buflen
);
141 strcatW(fullname
, helpW
);
142 strcatW(fullname
, filename
);
144 return (GetFileAttributesW(fullname
) != INVALID_FILE_ATTRIBUTES
);
147 /******************************************************************
148 * HtmlHelpW (HHCTRL.OCX.15)
150 HWND WINAPI
HtmlHelpW(HWND caller
, LPCWSTR filename
, UINT command
, DWORD_PTR data
)
152 WCHAR fullname
[MAX_PATH
];
154 TRACE("(%p, %s, command=%s, data=%lx)\n",
155 caller
, debugstr_w( filename
),
156 command_to_string( command
), data
);
160 case HH_DISPLAY_TOPIC
:
162 case HH_DISPLAY_INDEX
:
163 case HH_DISPLAY_SEARCH
:{
167 WCHAR
*window
= NULL
;
168 const WCHAR
*index
= NULL
;
169 WCHAR
*default_index
= NULL
;
170 int tab_index
= TAB_CONTENTS
;
175 if (!resolve_filename(filename
, fullname
, MAX_PATH
, &default_index
, &window
))
177 WARN("can't find %s\n", debugstr_w(filename
));
180 index
= default_index
;
183 info
= find_window(window
);
185 info
= CreateHelpViewer(info
, fullname
, caller
);
188 heap_free(default_index
);
194 index
= info
->WinType
.pszFile
;
195 if(!info
->WinType
.pszType
)
196 info
->WinType
.pszType
= info
->stringsW
.pszType
= window
;
200 /* called to load a specified topic */
203 case HH_DISPLAY_TOPIC
:
206 index
= (const WCHAR
*)data
;
210 res
= NavigateToChm(info
, info
->pCHMInfo
->szFile
, index
);
211 heap_free(default_index
);
215 ReleaseHelpViewer(info
);
221 case HH_DISPLAY_TOPIC
:
223 tab_index
= TAB_CONTENTS
;
225 case HH_DISPLAY_INDEX
:
226 tab_index
= TAB_INDEX
;
228 FIXME("Should select keyword '%s'.\n", debugstr_w((WCHAR
*)data
));
230 case HH_DISPLAY_SEARCH
:
231 tab_index
= TAB_SEARCH
;
233 FIXME("Should display search specified by HH_FTS_QUERY structure.\n");
236 /* open the requested tab */
237 memset(&nmhdr
, 0, sizeof(nmhdr
));
238 nmhdr
.code
= TCN_SELCHANGE
;
239 SendMessageW(info
->hwndTabCtrl
, TCM_SETCURSEL
, (WPARAM
)info
->tabs
[tab_index
].id
, 0);
240 SendMessageW(info
->WinType
.hwndNavigation
, WM_NOTIFY
, 0, (LPARAM
)&nmhdr
);
242 return info
->WinType
.hwndHelp
;
244 case HH_HELP_CONTEXT
: {
245 WCHAR
*window
= NULL
;
252 if (!resolve_filename(filename
, fullname
, MAX_PATH
, NULL
, &window
))
254 WARN("can't find %s\n", debugstr_w(filename
));
259 info
= find_window(window
);
261 info
= CreateHelpViewer(info
, fullname
, caller
);
268 if(!info
->WinType
.pszType
)
269 info
->WinType
.pszType
= info
->stringsW
.pszType
= window
;
273 url
= FindContextAlias(info
->pCHMInfo
, data
);
276 ReleaseHelpViewer(info
);
280 NavigateToUrl(info
, url
);
282 return info
->WinType
.hwndHelp
;
284 case HH_PRETRANSLATEMESSAGE
: {
285 static BOOL warned
= FALSE
;
289 FIXME("HH_PRETRANSLATEMESSAGE unimplemented\n");
297 LIST_FOR_EACH_ENTRY_SAFE(info
, next
, &window_list
, HHInfo
, entry
)
299 TRACE("Destroying window %s.\n", debugstr_w(info
->WinType
.pszType
));
300 ReleaseHelpViewer(info
);
304 case HH_SET_WIN_TYPE
: {
305 HH_WINTYPEW
*wintype
= (HH_WINTYPEW
*)data
;
306 WCHAR
*window
= NULL
;
309 if (!filename
&& wintype
->pszType
)
310 window
= strdupW(wintype
->pszType
);
311 else if (!filename
|| !resolve_filename(filename
, fullname
, MAX_PATH
, NULL
, &window
) || !window
)
313 WARN("can't find window name: %s\n", debugstr_w(filename
));
316 info
= find_window(window
);
319 info
= heap_alloc_zero(sizeof(HHInfo
));
320 info
->WinType
.pszType
= info
->stringsW
.pszType
= window
;
321 list_add_tail(&window_list
, &info
->entry
);
326 TRACE("Changing WINTYPE, fsValidMembers=0x%x\n", wintype
->fsValidMembers
);
328 MergeChmProperties(wintype
, info
, TRUE
);
329 UpdateHelpWindow(info
);
332 case HH_GET_WIN_TYPE
: {
333 HH_WINTYPEW
*wintype
= (HH_WINTYPEW
*)data
;
334 WCHAR
*window
= NULL
;
337 if (!filename
|| !resolve_filename(filename
, fullname
, MAX_PATH
, NULL
, &window
) || !window
)
339 WARN("can't find window name: %s\n", debugstr_w(filename
));
342 info
= find_window(window
);
345 WARN("Could not find window named %s.\n", debugstr_w(window
));
350 TRACE("Retrieving WINTYPE for %s.\n", debugstr_w(window
));
351 *wintype
= info
->WinType
;
356 FIXME("HH case %s not handled.\n", command_to_string( command
));
362 static void wintypeAtoW(const HH_WINTYPEA
*data
, HH_WINTYPEW
*wdata
, struct wintype_stringsW
*stringsW
)
364 memcpy(wdata
, data
, sizeof(*data
));
365 /* convert all of the ANSI strings to Unicode */
366 wdata
->pszType
= stringsW
->pszType
= strdupAtoW(data
->pszType
);
367 wdata
->pszCaption
= stringsW
->pszCaption
= strdupAtoW(data
->pszCaption
);
368 wdata
->pszToc
= stringsW
->pszToc
= strdupAtoW(data
->pszToc
);
369 wdata
->pszIndex
= stringsW
->pszIndex
= strdupAtoW(data
->pszIndex
);
370 wdata
->pszFile
= stringsW
->pszFile
= strdupAtoW(data
->pszFile
);
371 wdata
->pszHome
= stringsW
->pszHome
= strdupAtoW(data
->pszHome
);
372 wdata
->pszJump1
= stringsW
->pszJump1
= strdupAtoW(data
->pszJump1
);
373 wdata
->pszJump2
= stringsW
->pszJump2
= strdupAtoW(data
->pszJump2
);
374 wdata
->pszUrlJump1
= stringsW
->pszUrlJump1
= strdupAtoW(data
->pszUrlJump1
);
375 wdata
->pszUrlJump2
= stringsW
->pszUrlJump2
= strdupAtoW(data
->pszUrlJump2
);
376 wdata
->pszCustomTabs
= stringsW
->pszCustomTabs
= strdupAtoW(data
->pszCustomTabs
);
379 static void wintypeWtoA(const HH_WINTYPEW
*wdata
, HH_WINTYPEA
*data
, struct wintype_stringsA
*stringsA
)
381 memcpy(data
, wdata
, sizeof(*wdata
));
382 /* convert all of the Unicode strings to ANSI */
383 data
->pszType
= stringsA
->pszType
= strdupWtoA(wdata
->pszType
);
384 data
->pszCaption
= stringsA
->pszCaption
= strdupWtoA(wdata
->pszCaption
);
385 data
->pszToc
= stringsA
->pszToc
= strdupWtoA(wdata
->pszToc
);
386 data
->pszIndex
= stringsA
->pszFile
= strdupWtoA(wdata
->pszIndex
);
387 data
->pszFile
= stringsA
->pszFile
= strdupWtoA(wdata
->pszFile
);
388 data
->pszHome
= stringsA
->pszHome
= strdupWtoA(wdata
->pszHome
);
389 data
->pszJump1
= stringsA
->pszJump1
= strdupWtoA(wdata
->pszJump1
);
390 data
->pszJump2
= stringsA
->pszJump2
= strdupWtoA(wdata
->pszJump2
);
391 data
->pszUrlJump1
= stringsA
->pszUrlJump1
= strdupWtoA(wdata
->pszUrlJump1
);
392 data
->pszUrlJump2
= stringsA
->pszUrlJump2
= strdupWtoA(wdata
->pszUrlJump2
);
393 data
->pszCustomTabs
= stringsA
->pszCustomTabs
= strdupWtoA(wdata
->pszCustomTabs
);
396 /******************************************************************
397 * HtmlHelpA (HHCTRL.OCX.14)
399 HWND WINAPI
HtmlHelpA(HWND caller
, LPCSTR filename
, UINT command
, DWORD_PTR data
)
401 WCHAR
*wfile
= strdupAtoW( filename
);
408 case HH_ALINK_LOOKUP
:
409 case HH_DISPLAY_SEARCH
:
410 case HH_DISPLAY_TEXT_POPUP
:
411 case HH_GET_LAST_ERROR
:
412 case HH_KEYWORD_LOOKUP
:
414 FIXME("structures not handled yet\n");
417 case HH_SET_WIN_TYPE
:
419 struct wintype_stringsW stringsW
;
422 wintypeAtoW((HH_WINTYPEA
*)data
, &wdata
, &stringsW
);
423 result
= HtmlHelpW( caller
, wfile
, command
, (DWORD_PTR
)&wdata
);
424 wintype_stringsW_free(&stringsW
);
427 case HH_GET_WIN_TYPE
:
432 result
= HtmlHelpW( caller
, wfile
, command
, (DWORD_PTR
)&wdata
);
433 if (!wdata
.pszType
) break;
434 info
= find_window(wdata
.pszType
);
436 wintype_stringsA_free(&info
->stringsA
);
437 wintypeWtoA(&wdata
, (HH_WINTYPEA
*)data
, &info
->stringsA
);
441 case HH_DISPLAY_INDEX
:
442 case HH_DISPLAY_TOPIC
:
444 case HH_GET_WIN_HANDLE
:
445 case HH_SAFE_DISPLAY_TOPIC
:
447 WCHAR
*wdata
= strdupAtoW( (const char *)data
);
448 result
= HtmlHelpW( caller
, wfile
, command
, (DWORD_PTR
)wdata
);
454 case HH_HELP_CONTEXT
:
456 case HH_PRETRANSLATEMESSAGE
:
457 case HH_TP_HELP_CONTEXTMENU
:
458 case HH_TP_HELP_WM_HELP
:
459 case HH_UNINITIALIZE
:
460 /* either scalar or pointer to scalar - do nothing */
464 FIXME("Unknown command: %s (%d)\n", command_to_string(command
), command
);
469 result
= HtmlHelpW( caller
, wfile
, command
, data
);
475 /******************************************************************
476 * doWinMain (HHCTRL.OCX.13)
478 int WINAPI
doWinMain(HINSTANCE hInstance
, LPSTR szCmdLine
)
481 int len
, buflen
, mapid
= -1;
488 /* Parse command line option of the HTML Help command.
490 * Note: The only currently handled action is "mapid",
491 * which corresponds to opening a specific page.
493 while(*szCmdLine
== '-')
498 space
= strchr(ptr
, ' ');
499 if(!strncmp(ptr
, "mapid", space
-ptr
))
503 ptr
+= strlen("mapid")+1;
504 space
= strchr(ptr
, ' ');
505 /* command line ends without number */
508 memcpy(idtxt
, ptr
, space
-ptr
);
509 idtxt
[space
-ptr
] = '\0';
515 FIXME("Unhandled HTML Help command line parameter! (%.*s)\n", (int)(space
-szCmdLine
), szCmdLine
);
520 /* FIXME: Check szCmdLine for bad arguments */
521 if (*szCmdLine
== '\"')
522 endq
= strchr(++szCmdLine
, '\"');
525 len
= endq
- szCmdLine
;
527 len
= strlen(szCmdLine
);
529 /* no filename given */
533 buflen
= MultiByteToWideChar(CP_ACP
, 0, szCmdLine
, len
, NULL
, 0) + 1;
534 filename
= heap_alloc(buflen
* sizeof(WCHAR
));
535 MultiByteToWideChar(CP_ACP
, 0, szCmdLine
, len
, filename
, buflen
);
536 filename
[buflen
-1] = 0;
538 /* Open a specific help topic */
540 hwnd
= HtmlHelpW(GetDesktopWindow(), filename
, HH_HELP_CONTEXT
, mapid
);
542 hwnd
= HtmlHelpW(GetDesktopWindow(), filename
, HH_DISPLAY_TOPIC
, 0);
548 ERR("Failed to open HTML Help file '%s'.\n", szCmdLine
);
552 while (GetMessageW(&msg
, 0, 0, 0))
554 TranslateMessage(&msg
);
555 DispatchMessageW(&msg
);
561 /******************************************************************
562 * DllGetClassObject (HHCTRL.OCX.@)
564 HRESULT WINAPI
DllGetClassObject(REFCLSID rclsid
, REFIID riid
, LPVOID
*ppv
)
566 FIXME("(%s %s %p)\n", debugstr_guid(rclsid
), debugstr_guid(riid
), ppv
);
567 return CLASS_E_CLASSNOTAVAILABLE
;
570 /***********************************************************************
571 * DllRegisterServer (HHCTRL.OCX.@)
573 HRESULT WINAPI
DllRegisterServer(void)
575 return __wine_register_resources( hhctrl_hinstance
);
578 /***********************************************************************
579 * DllUnregisterServer (HHCTRL.OCX.@)
581 HRESULT WINAPI
DllUnregisterServer(void)
583 return __wine_unregister_resources( hhctrl_hinstance
);