note description: "Controls access to Microsoft HTML Help, allows to display given urls" legal: "See notice at end of class." status: "See notice at end of class." class EB_HTML_HELP_HANDLER feature -- Access help_window_handle: POINTER -- Handle to help window feature -- Status Report is_valid_chm_url (a_chm_url: READABLE_STRING_32): BOOLEAN -- Is `a_chm_url' a valid Microsoft HTML Help URL? do Result := True end last_show_successful: BOOLEAN -- Was last call to `show' successful? do Result := help_window_handle /= default_pointer end feature -- Basic Operations show (a_chm_url: READABLE_STRING_32) -- Display help page page with url `a_chm_url'. require valid_chm_url: is_valid_chm_url (a_chm_url) do help_window_handle := cwin_html_help (default_pointer, (create {WEL_STRING}.make (a_chm_url)).item, Hh_display_topic, default_pointer) end feature {NONE} -- Externals cwin_html_help (hwnd, pszFile: POINTER; command: INTEGER; data: POINTER): POINTER -- Help Workshop `HtmlHelp' API. external "C [macro %"Htmlhelp.h%"] (HWND, LPCTSTR, UINT, DWORD_PTR): HWND" alias "HtmlHelp" end Hh_display_topic: INTEGER -- Help Workshop HH_DISPLAY_TOPIC constant external "C [macro %"Htmlhelp.h%"]: EIF_INTEGER" alias "HH_DISPLAY_TOPIC" end note copyright: "Copyright (c) 1984-2018, Eiffel Software" license: "GPL version 2 (see http://www.eiffel.com/licensing/gpl.txt)" licensing_options: "http://www.eiffel.com/licensing" copying: "[ This file is part of Eiffel Software's Eiffel Development Environment. Eiffel Software's Eiffel Development Environment is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 of the License (available at the URL listed under "license" above). Eiffel Software's Eiffel Development Environment is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Eiffel Software's Eiffel Development Environment; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA ]" source: "[ Eiffel Software 5949 Hollister Ave., Goleta, CA 93117 USA Telephone 805-685-1006, Fax 805-685-6869 Website http://www.eiffel.com Customer support http://support.eiffel.com ]" end -- class EB_HTML_HELP_HANDLER