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 BOOL WINAPI DllMain(HINSTANCE hInstance, DWORD fdwReason, LPVOID lpvReserved)
46 TRACE("(%p,%d,%p)\n", hInstance, fdwReason, lpvReserved);
50 case DLL_PROCESS_ATTACH:
51 hhctrl_hinstance = hInstance;
52 DisableThreadLibraryCalls(hInstance);
54 case DLL_PROCESS_DETACH:
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)
103 static const WCHAR helpW[] = {'\\','h','e','l','p','\\',0};
105 GetFullPathNameW(filename, buflen, fullname, NULL);
106 if (GetFileAttributesW(fullname) == INVALID_FILE_ATTRIBUTES)
108 GetWindowsDirectoryW(fullname, buflen);
109 strcatW(fullname, helpW);
110 strcatW(fullname, filename);
112 return (GetFileAttributesW(fullname) != INVALID_FILE_ATTRIBUTES);
115 /******************************************************************
116 * HtmlHelpW (HHCTRL.OCX.15)
118 HWND WINAPI HtmlHelpW(HWND caller, LPCWSTR filename, UINT command, DWORD_PTR data)
120 WCHAR fullname[MAX_PATH];
122 TRACE("(%p, %s, command=%s, data=%lx)\n",
123 caller, debugstr_w( filename ),
124 command_to_string( command ), data);
128 case HH_DISPLAY_TOPIC:
130 case HH_DISPLAY_SEARCH:{
131 static const WCHAR delimW[] = {':',':',0};
134 WCHAR chm_file[MAX_PATH];
137 FIXME("Not all HH cases handled correctly\n");
142 index = strstrW(filename, delimW);
145 memcpy(chm_file, filename, (index-filename)*sizeof(WCHAR));
146 chm_file[index-filename] = 0;
148 index += 2; /* advance beyond "::" for calling NavigateToChm() later */
151 if (!resolve_filename(filename, fullname, MAX_PATH))
153 WARN("can't find %s\n", debugstr_w(filename));
157 info = CreateHelpViewer(fullname);
162 index = info->WinType.pszFile;
164 res = NavigateToChm(info, info->pCHMInfo->szFile, index);
167 ReleaseHelpViewer(info);
170 return info->WinType.hwndHelp;
172 case HH_HELP_CONTEXT: {
179 if (!resolve_filename(filename, fullname, MAX_PATH))
181 WARN("can't find %s\n", debugstr_w(filename));
185 info = CreateHelpViewer(fullname);
189 url = FindContextAlias(info->pCHMInfo, data);
192 ReleaseHelpViewer(info);
196 NavigateToUrl(info, url);
198 return info->WinType.hwndHelp;
200 case HH_PRETRANSLATEMESSAGE: {
201 static BOOL warned = FALSE;
205 FIXME("HH_PRETRANSLATEMESSAGE unimplemented\n");
211 FIXME("HH case %s not handled.\n", command_to_string( command ));
217 /******************************************************************
218 * HtmlHelpA (HHCTRL.OCX.14)
220 HWND WINAPI HtmlHelpA(HWND caller, LPCSTR filename, UINT command, DWORD_PTR data)
222 WCHAR *wfile = NULL, *wdata = NULL;
228 len = MultiByteToWideChar( CP_ACP, 0, filename, -1, NULL, 0 );
229 wfile = heap_alloc(len*sizeof(WCHAR));
230 MultiByteToWideChar( CP_ACP, 0, filename, -1, wfile, len );
237 case HH_ALINK_LOOKUP:
238 case HH_DISPLAY_SEARCH:
239 case HH_DISPLAY_TEXT_POPUP:
240 case HH_GET_LAST_ERROR:
241 case HH_GET_WIN_TYPE:
242 case HH_KEYWORD_LOOKUP:
243 case HH_SET_WIN_TYPE:
245 FIXME("structures not handled yet\n");
248 case HH_DISPLAY_INDEX:
249 case HH_DISPLAY_TOPIC:
251 case HH_GET_WIN_HANDLE:
252 case HH_SAFE_DISPLAY_TOPIC:
253 len = MultiByteToWideChar( CP_ACP, 0, (const char*)data, -1, NULL, 0 );
254 wdata = heap_alloc(len*sizeof(WCHAR));
255 MultiByteToWideChar( CP_ACP, 0, (const char*)data, -1, wdata, len );
259 case HH_HELP_CONTEXT:
261 case HH_PRETRANSLATEMESSAGE:
262 case HH_TP_HELP_CONTEXTMENU:
263 case HH_TP_HELP_WM_HELP:
264 case HH_UNINITIALIZE:
265 /* either scalar or pointer to scalar - do nothing */
269 FIXME("Unknown command: %s (%d)\n", command_to_string(command), command);
274 result = HtmlHelpW( caller, wfile, command, wdata ? (DWORD_PTR)wdata : data );
281 /******************************************************************
282 * doWinMain (HHCTRL.OCX.13)
284 int WINAPI doWinMain(HINSTANCE hInstance, LPSTR szCmdLine)
287 int len, buflen, mapid = -1;
293 /* Parse command line option of the HTML Help command.
295 * Note: The only currently handled action is "mapid",
296 * which corresponds to opening a specific page.
298 while(*szCmdLine == '-')
303 space = strchr(ptr, ' ');
304 if(!strncmp(ptr, "mapid", space-ptr))
308 ptr += strlen("mapid")+1;
309 space = strchr(ptr, ' ');
310 /* command line ends without number */
313 memcpy(idtxt, ptr, space-ptr);
314 idtxt[space-ptr] = '\0';
320 FIXME("Unhandled HTML Help command line parameter! (%.*s)\n", (int)(space-szCmdLine), szCmdLine);
325 /* FIXME: Check szCmdLine for bad arguments */
326 if (*szCmdLine == '\"')
327 endq = strchr(++szCmdLine, '\"');
330 len = endq - szCmdLine;
332 len = strlen(szCmdLine);
334 /* no filename given */
338 buflen = MultiByteToWideChar(CP_ACP, 0, szCmdLine, len, NULL, 0) + 1;
339 filename = heap_alloc(buflen * sizeof(WCHAR));
340 MultiByteToWideChar(CP_ACP, 0, szCmdLine, len, filename, buflen);
341 filename[buflen-1] = 0;
343 /* Open a specific help topic */
345 HtmlHelpW(GetDesktopWindow(), filename, HH_HELP_CONTEXT, mapid);
347 HtmlHelpW(GetDesktopWindow(), filename, HH_DISPLAY_TOPIC, 0);
351 while (GetMessageW(&msg, 0, 0, 0))
353 TranslateMessage(&msg);
354 DispatchMessageW(&msg);
360 /******************************************************************
361 * DllGetClassObject (HHCTRL.OCX.@)
363 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
365 FIXME("(%s %s %p)\n", debugstr_guid(rclsid), debugstr_guid(riid), ppv);
366 return CLASS_E_CLASSNOTAVAILABLE;
369 /***********************************************************************
370 * DllRegisterServer (HHCTRL.OCX.@)
372 HRESULT WINAPI DllRegisterServer(void)
374 return __wine_register_resources( hhctrl_hinstance, NULL );
377 /***********************************************************************
378 * DllUnregisterServer (HHCTRL.OCX.@)
380 HRESULT WINAPI DllUnregisterServer(void)
382 return __wine_unregister_resources( hhctrl_hinstance, NULL );