html.h File Reference

Go to the source code of this file.

Detailed Description

HTML control (MC_WC_HTML).

As the control name suggests, the control is intended to display HTML documents. Actually the control is thin wrapper of Internet Explorer COM object, so it can do much more: display a plethora of multimedia files, take use of JavaScript etc.

The easiest way how to show some document is to specify URL of target document as control's window name. For example when created with CreateWindow(), use the 2nd argument as the URL. This allows easy use of the control in dialog templates.

URL can also be set anytime later with message MC_HM_GOTOURL.

The control accepts any protocol understood by the Internet Explorer, for example:

• http://www.example.org
• file://C:/page.html
• res://some_dll/id_of_resource
• its:helpFile.chm::page.htm

Resource Protocol

The res: protocol is especially useful. It allows you to embed some resources like HTML pages, cascading style sheets (CSS), images (PNG, JPG etc.) or JavaScript files into binary of your application or any DLL it uses.

You can link to such resources with URL in format "res://modname/res_type/res_id" where modname is name of the binary module (usually filename of your program or any DLL it loads; or a full path to other .EXE or .DLL file), res_type is type of the resource and res_id is ID of the resource in the resource script (RC).

The type can be omitted in the URL. The control then assumes type 23 (RT_HTML).

Although res_id can be both string or number identifier, we recommend to prefer string identifiers which end with dummy "file extension", hence making a hint to the browser about the image type. Without this the browser tries to guess what type of the data the resource is, and that may be unreliable. Remember the heuristics also differ in various versions of MSIE.

For example if you have a HTML file named some_page.html and an image file image.png which can be linked from the HTML page, add the following lines into your resource script:

some_page.html HTML path/to/some_page.html
image.png HTML path/to/image.png

which is used to build a MYLIBRARY.DLL used by your application then your application can simply send the message MC_HM_GOTOURL with URL "res://mylibrary.dll/some_page.html".

Of course, HTML documents stored in the resources then can also use relative URLs to link to other documents and resources in the same module (.EXE or .DLL).

Application Protocol

MCTRL.DLL implements a simple application protocol app: which is intended for integration of HTML contents into your application logic.

Whenever user clicks on a link with URL starting with the "app:" the control sends notification MC_HN_APPLINK to its parent window which is supposed to react programmatically. The control itself does not interpret application link URLs in any way.

Dynamically Generated Contents

Generating HTML contents programmatically is also possible to some degree. Note however that the application is not supposed to generate whole documents but only smaller snippets of them.

The application can set contents of almost any tag (identified by HTML attribute "id") with any custom string using the message MC_HM_SETTAGCONTENTS. The message takes the ID and the string as its arguments. Then, if the currently loaded page has a tag with the given ID, the content of the tag is replaced and set to the given string. Any previous content of that tag is removed. Remember the string has to follow HTML syntax and keep integrity of the HTML document.

Note the application should use the message MC_HM_SETTAGCONTENTS only after the HTML document intended to be changed is completely loaded, i.e. anytime after the notification MC_HN_DOCUMENTCOMPLETE is fired.

Attention

Please note that for limitations of Internet Explorer, contents of these tags can not be modified:
COL, COLGROUP, FRAMESET, HEAD, HTML, STYLE, TABLE, TBODY, TFOOT, THEAD, TITLE, TR.

We recommend to use tags DIV or SPAN for the dynamic contents injected by application code into the HTML pages.

Calling Script Function

The control supports also invoking a script (e.g. JavaScript) function within the HTML page from the application's code.

There are actually two messages for this very purpose. The message MC_HM_CALLSCRIPTFUNCEX is more powerful, and can call any script function, with any number of arguments of any type, and returning any type, but using this message requires manual setup of OLE variadic type (VARIANT) type and it requires more coding.

The other message, MC_HM_CALLSCRIPTFUNC, is easier to use but its use imposes some limitations: It can only deal with script functions with up to four arguments, and all arguments, as well as any return value, must be of string or integer type.

Gotchas

• Keep in mind that the control is relatively thin wrapper of embedded MS Internet Explorer so exact behavior depends on the version of MS IE installed.
• The value of the URL in notifications might not match the URL that was originally given to the HTML control, because the URL might be converted to a qualified form. For example, the IE sometimes may add a slash ('/') at the end of some URLs. Furthermore IE can encode some special characters into their hexadecimal representation (e.g. space ' ' becomes "%20").

IE Versions

As noted in the introduction, the control is implemented as a thin wrapper of Internet Explorer COM object (COM interface IWebBrowser2).

Because of the compatibility reasons, Microsoft has decided that by default the control will behave as Internet Explorer version 7 (assuming IE 7 or newer is installed in the computer).

This has some impact on how the HTML pages are rendered and, more importantly, on java-script dialect understood by it. Unfortunately the API does not allow reasonable to change the compatibility mode on a per-control (or rather on a per-COM-object-instance) manner.

Furthermore, the switching is done through a change in the registry, which should likely be done during installation phase of the application (and possibly undone when it is uninstalled). Therefore the mCtrl does not offer any API to change this and instead you are on your own to deal with the registry keys.

To change the behavior, you need to create the following registry key "HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION" if it does not already exist, and in it, create a DWORD value named as a binary name of your application (e.g. "MyApplication.exe"). The DWORD value then determines the compatibility version (taken from MSDN documentation):

• 7000 (0x1b58): IE 7 mode (the default).
• 8000 (0x1f40): IE 8 mode or IE 10 mode depending on !DOCTYPE directives within HTML document.
• 8888 (0x22b8): IE 8 mode, regardless of the declared !DOCTYPE directives.
• 9000 (0x2328): IE 9 mode or IE 10 mode depending on !DOCTYPE directives within HTML document.
• 9999 (0x270f): IE 9 mode, regardless of the declared !DOCTYPE directives.
• 10000 (0x2710): IE 10 mode for HTML documents with !DOCTYPE directives.
• 10001 (0x2711): IE 10 mode, regardless of the declared !DOCTYPE directives.
• 11000 (0x2af8): IE 11 mode.
• 11001 (0x2af9): IE 11 mode, regardless of the declared !DOCTYPE directives. Failing to declare a !DOCTYPE directive causes the page to load in Quirks mode.

Note that only IE version 8 and newer can understand this registry value and, of course, the maximal value understood by it is limited by version of IE installed on the system. E.g. asking IE 8 to behave as IE 10 won't work.

Further recommendations:

• When using this, you should consider to make name of your .exe file as unique as possible to mitigate possible conflicts with other applications.
• When creating the registry key/value within your exe before creating the control, you may consider to create it volatile to not leave waste in the persistent registry storage.
• Application can only switch all IWebBrowser2 instances to the given compatibility mode, or none of them.

Standard Messages

These standard messages are handled by the control:

• CCM_GETUNICODEFORMAT
• CCM_SETNOTIFYWINDOW
• CCM_SETUNICODEFORMAT

These standard notifications are sent by the control:

• NM_OUTOFMEMORY

Data Structures
struct	MC_HMCALLSCRIPTFUNCW
	Structure for message MC_HM_CALLSCRIPTFUNCW request (Unicode variant). More...
struct	MC_HMCALLSCRIPTFUNCA
	Structure for message MC_HM_CALLSCRIPTFUNCA request (ANSI variant). More...
struct	MC_HMCALLSCRIPTFUNCEX
	Structure for message MC_HM_CALLSCRIPTFUNCEX. More...
struct	MC_NMHTMLURLW
	Structure used for notifications with URL parameter (Unicode variant). More...
struct	MC_NMHTMLURLA
	Structure used for notifications with URL parameter (ANSI variant). More...
struct	MC_NMHTMLPROGRESS
	Structure used for notification about download progress. More...
struct	MC_NMHTMLTEXTW
	Structure used for notifications with textual parameter (Unicode variant). More...
struct	MC_NMHTMLTEXTA
	Structure used for notifications with textual parameter (ANSI variant). More...
struct	MC_NMHTMLHISTORY
	Structure used for notification about history navigation. More...
struct	MC_NMHTTPERRORW
	Structure used for notification about HTTP error (Unicode variant). More...
struct	MC_NMHTTPERRORA
	Structure used for notification about HTTP error (ANSI variant). More...

Initialization Functions
BOOL	mcHtml_Initialize (void)
void	mcHtml_Terminate (void)

Window Class
#define	MC_WC_HTMLW   L"mCtrl.html"
#define	MC_WC_HTMLA   "mCtrl.html"

Control Styles
#define	MC_HS_NOCONTEXTMENU   0x0001
	Disables context menu. More...

Control Messages
#define	MC_HM_GOTOURLW   (MC_HM_FIRST + 10)
	Displays a document specified by the given URL (Unicode variant). More...
#define	MC_HM_GOTOURLA   (MC_HM_FIRST + 11)
	Displays a document specified by the given URL (ANSI variant). More...
#define	MC_HM_SETTAGCONTENTSW   (MC_HM_FIRST + 12)
	Set contents of the HTML tag with given attribute "id" (Unicode variant). More...
#define	MC_HM_SETTAGCONTENTSA   (MC_HM_FIRST + 13)
	Set contents of the HTML tag with given attribute "id" (ANSI variant). More...
#define	MC_HM_GOBACK   (MC_HM_FIRST + 14)
	Navigates the HTML control back or forward in history. More...
#define	MC_HM_CANBACK   (MC_HM_FIRST + 15)
	Tests whether going back or forward in history is possible. More...
#define	MC_HM_CALLSCRIPTFUNCW   (MC_HM_FIRST + 16)
	Calls script function in HTML page (Unicode variant). More...
#define	MC_HM_CALLSCRIPTFUNCA   (MC_HM_FIRST + 17)
	Calls script function in HTML page (ANSI variant). More...
#define	MC_HM_CALLSCRIPTFUNCEX   (MC_HM_FIRST + 18)
	Call script function in HTML page. More...

Control Notifications
#define	MC_HN_APPLINK   (MC_HN_FIRST + 0)
	Fired when the browser should navigates to to URL with application protocol. More...
#define	MC_HN_DOCUMENTCOMPLETE   (MC_HN_FIRST + 1)
	Fired when loading of a document is complete. More...
#define	MC_HN_PROGRESS   (MC_HN_FIRST + 2)
	Fired to inform application about download progress. More...
#define	MC_HN_STATUSTEXT   (MC_HN_FIRST + 3)
	Fired when the browser would like to change status text. More...
#define	MC_HN_TITLETEXT   (MC_HN_FIRST + 4)
	Fired when the browser changes title of the HTML page. More...
#define	MC_HN_HISTORY   (MC_HN_FIRST + 5)
	Fired when possibility of going back or forward in history changes. More...
#define	MC_HN_NEWWINDOW   (MC_HN_FIRST + 6)
	Fired when the browser would open a new window. More...
#define	MC_HN_HTTPERROR   (MC_HN_FIRST + 7)
	Fired to indicate that HTTP error has occurred. More...
#define	MC_HN_BEFORENAVIGATE   (MC_HN_FIRST + 8)
	Fired before the browser navigates to a new URL. More...

Unicode Resolution
#define	MC_WC_HTML   MCTRL_NAME_AW(MC_WC_HTML)
#define	MC_HM_GOTOURL   MCTRL_NAME_AW(MC_HM_GOTOURL)
#define	MC_HM_SETTAGCONTENTS   MCTRL_NAME_AW(MC_HM_SETTAGCONTENTS)
#define	MC_HM_CALLSCRIPTFUNC   MCTRL_NAME_AW(MC_HM_CALLSCRIPTFUNC)
#define	MC_NMHTMLURL   MCTRL_NAME_AW(MC_NMHTMLURL)
#define	MC_NMHTMLTEXT   MCTRL_NAME_AW(MC_NMHTMLTEXT)
#define	MC_NMHTTPERROR   MCTRL_NAME_AW(MC_NMHTTPERROR)
#define	MC_HMCALLSCRIPTFUNC   MCTRL_NAME_AW(MC_HMCALLSCRIPTFUNC)

---

Data Structure Documentation

struct MC_HMCALLSCRIPTFUNCW

Structure for message MC_HM_CALLSCRIPTFUNCW request (Unicode variant).

See also

MC_HM_CALLSCRIPTFUNCW

Data Fields
UINT	cbSize	Set to sizeof(MC_HMCALLSCRIPTFUNCW).
LPWSTR	pszRet	Set to address of a buffer to store string result of the function call, or to NULL if the expected return value is of integer type or there is no return value.
int	iRet	If pszRet is not NULL, set to size of the buffer. If pszRet is NULL and the function returns integer, it is stored here.
UINT	cArgs	Set to number of arguments passed to the function. (Four at most.)
LPCWSTR	pszArg1	Specify 1st argument (if it is of string type).
int	iArg1	Specify 1st argument (if it is of integer type). Ignored if pszArg1 is not NULL.
LPCWSTR	pszArg2	Specify 2nd argument (if it is of string type).
int	iArg2	Specify 2nd argument (if it is of integer type). Ignored if pszArg2 is not NULL.
LPCWSTR	pszArg3	Specify 3rd argument (if it is of string type).
int	iArg3	Specify 3rd argument (if it is of integer type). Ignored if pszArg3 is not NULL.
LPCWSTR	pszArg4	Specify 4th argument (if it is of string type).
int	iArg4	Specify 4th argument (if it is of integer type). Ignored if pszArg4 is not NULL.

struct MC_HMCALLSCRIPTFUNCA

Structure for message MC_HM_CALLSCRIPTFUNCA request (ANSI variant).

See also

MC_HM_CALLSCRIPTFUNCA

Data Fields
UINT	cbSize	Set to sizeof(MC_HMCALLSCRIPTFUNCA).
LPCSTR	pszRet	Set to address of a buffer to store string result of the function call, or to NULL if the expected return value is of integer type or there is no return value.
int	iRet	If pszRet is not NULL, set to size of the buffer. If pszRet is NULL and the function returns integer, it is stored here.
UINT	cArgs	Set to number of arguments passed to the function. (Four at most.)
LPCSTR	pszArg1	Specify 1st argument (if it is of string type).
int	iArg1	Specify 1st argument (if it is of integer type). Ignored if pszArg1 is not NULL.
LPCSTR	pszArg2	Specify 2nd argument (if it is of string type).
int	iArg2	Specify 2nd argument (if it is of integer type). Ignored if pszArg1 is not NULL.
LPCSTR	pszArg3	Specify 3rd argument (if it is of string type).
int	iArg3	Specify 3rd argument (if it is of integer type). Ignored if pszArg1 is not NULL.
LPCSTR	pszArg4	Specify 4th argument (if it is of string type).
int	iArg4	Specify 4th argument (if it is of integer type). Ignored if pszArg1 is not NULL.

struct MC_HMCALLSCRIPTFUNCEX

Structure for message MC_HM_CALLSCRIPTFUNCEX.

See also

MC_HM_CALLSCRIPTFUNCEX

Data Fields
UINT	cbSize	Set to sizeof(MC_HMCALLSCRIPTFUNCEX).
const LPCOLESTR	pszFuncName	Name of function to call.
VARIANT *	lpvArgs	Pointer to array of arguments to be passed to the function.
UINT	cArgs	Count of the arguments.
VARIANT *	lpRet	Pointer to VARIANT which receives the return value. May be NULL if caller does not expect to get a return value (or if the caller ignores it). If not NULL, the caller should initialize it to VT_EMPTY before making the call and, after it returns, the caller is responsible to eventuall free its contents with VariantClear().

struct MC_NMHTMLURLW

Structure used for notifications with URL parameter (Unicode variant).

See also

MC_HN_APPLINK MC_HN_DOCUMENTCOMPLETE

Data Fields
NMHDR	hdr	Standard notification structure header.
LPCWSTR	pszUrl	String representation of the URL.

struct MC_NMHTMLURLA

Structure used for notifications with URL parameter (ANSI variant).

See also

MC_HN_APPLINK MC_HN_DOCUMENTCOMPLETE

Data Fields
NMHDR	hdr	Standard notification structure header.
LPCSTR	pszUrl	String representation of the URL.

struct MC_NMHTMLPROGRESS

Structure used for notification about download progress.

See also

MC_HN_PROGRESS

Data Fields
NMHDR	hdr	Standard notification structure header.
LONG	lProgress	Current progress.
LONG	lProgressMax	Progress maximum.

struct MC_NMHTMLTEXTW

Structure used for notifications with textual parameter (Unicode variant).

See also

MC_HN_STATUSTEXT MC_HN_TITLETEXT

Data Fields
NMHDR	hdr	Standard notification structure header.
LPCWSTR	pszText	The string.

struct MC_NMHTMLTEXTA

Structure used for notifications with textual parameter (ANSI variant).

See also

MC_HN_STATUSTEXT MC_HN_TITLETEXT

Data Fields
NMHDR	hdr	Standard notification structure header.
LPCSTR	pszText	The string.

struct MC_NMHTMLHISTORY

Structure used for notification about history navigation.

See also

MC_HN_HISTORY

Data Fields
NMHDR	hdr	Standard notification structure header.
BOOL	bCanBack	TRUE if going back in history is possible.
BOOL	bCanForward	TRUE if going forward in history is possible.

struct MC_NMHTTPERRORW

Structure used for notification about HTTP error (Unicode variant).

See also

MC_HN_HTTPERROR

Data Fields
NMHDR	hdr	Standard notification structure header.
LPCWSTR	pszUrl	String representation of the URL.
int	iStatus	HTTP status code.

struct MC_NMHTTPERRORA

Structure used for notification about HTTP error (ANSI variant).

See also

MC_HN_HTTPERROR

Data Fields
NMHDR	hdr	Standard notification structure header.
LPCSTR	pszUrl	String representation of the URL.
int	iStatus	HTTP status code.

Macro Definition Documentation

#define MC_WC_HTMLW   L"mCtrl.html"

Window class name (Unicode variant).

#define MC_WC_HTMLA   "mCtrl.html"

Window class name (ANSI variant).

#define MC_HS_NOCONTEXTMENU   0x0001

Disables context menu.

#define MC_HM_GOTOURLW   (MC_HM_FIRST + 10)

Displays a document specified by the given URL (Unicode variant).

Parameters

	wParam	Reserved, set to zero.
[in]	lParam	(const WCHAR*) The URL.

Returns

(BOOL) TRUE on success, FALSE otherwise.

#define MC_HM_GOTOURLA   (MC_HM_FIRST + 11)

Displays a document specified by the given URL (ANSI variant).

Parameters

	wParam	Reserved, set to zero.
[in]	lParam	(const char*) The URL.

Returns

(BOOL) TRUE on success, FALSE otherwise.

#define MC_HM_SETTAGCONTENTSW   (MC_HM_FIRST + 12)

Set contents of the HTML tag with given attribute "id" (Unicode variant).

Parameters

[in]	wParam	(const WCHAR*) ID of the tag.
[in]	lParam	(const WCHAR*) New contents of the tag.

Returns

(BOOL) TRUE on success, FALSE otherwise.

See also

Dynamically Generated Contents

#define MC_HM_SETTAGCONTENTSA   (MC_HM_FIRST + 13)

Set contents of the HTML tag with given attribute "id" (ANSI variant).

Parameters

[in]	wParam	(const char*) ID of the tag.
[in]	lParam	(const char*) New contents of the tag.

Returns

(BOOL) TRUE on success, FALSE otherwise.

See also

Dynamically Generated Contents

#define MC_HM_GOBACK   (MC_HM_FIRST + 14)

Navigates the HTML control back or forward in history.

Parameters

[in]	wParam	(BOOL) Set to TRUE to go back in history or FALSE to go forward.
	lParam	Reserved, set to zero.

Returns

(BOOL) TRUE on success, FALSE otherwise.

See also

MC_HM_CANBACK

#define MC_HM_CANBACK   (MC_HM_FIRST + 15)

Tests whether going back or forward in history is possible.

Parameters

[in]	wParam	(BOOL) Set to TRUE to test going back in history or FALSE to going forward.
	lParam	Reserved, set to zero.

Returns

(BOOL) TRUE if can go back or forward respectively, FALSE otherwise.

See also

MC_HM_GOBACK

#define MC_HM_CALLSCRIPTFUNCW   (MC_HM_FIRST + 16)

Calls script function in HTML page (Unicode variant).

Parameters

[in]	wParam	(LPCWSTR*) Name of the function to call.
[in,out]	lParam	(MC_HMCALLSCRIPTFUNCW*) Pointer to a function specifying function arguments and receiving the return value. May be NULL if the function takes no arguments and returns no value (or the return value is ignored).

Returns

(BOOL) TRUE on success, FALSE otherwise.

#define MC_HM_CALLSCRIPTFUNCA   (MC_HM_FIRST + 17)

Calls script function in HTML page (ANSI variant).

Parameters

[in]	wParam	(LPCSTR*) Name of the function to call.
[in,out]	lParam	(MC_HMCALLSCRIPTFUNCA*) Pointer to a function specifying function arguments and receiving the return value. May be NULL if the function takes no arguments and returns no value (or the return value is ignored).

Returns

(BOOL) TRUE on success, FALSE otherwise.

#define MC_HM_CALLSCRIPTFUNCEX   (MC_HM_FIRST + 18)

Call script function in HTML page.

Parameters

	wParam	Reserved, set to zero.
[in,out]	lParam	(MC_HMCALLSCRIPTFUNCEX*) Pointer to structure specifying function to call, arguments to pass, and receiving the return value.

Returns

(HRESULT) S_OK if the call was invokes successfully, otherwise the HRESULT code of the error.

#define MC_HN_APPLINK   (MC_HN_FIRST + 0)

Fired when the browser should navigates to to URL with application protocol.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLURL*) Pointer to a structure specifying details about the URL.

Returns

Application should return zero if it processes the notification.

#define MC_HN_DOCUMENTCOMPLETE   (MC_HN_FIRST + 1)

Fired when loading of a document is complete.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLURL*) Pointer to a structure specifying details about the URL.

Returns

Application should return zero if it processes the notification.

#define MC_HN_PROGRESS   (MC_HN_FIRST + 2)

Fired to inform application about download progress.

This allows example for example to show a progress indicator.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLPROGRESS*) Pointer to a structure specifying details about the progress.

Returns

Application should return zero if it processes the notification.

#define MC_HN_STATUSTEXT   (MC_HN_FIRST + 3)

Fired when the browser would like to change status text.

IE usually shows this text in its status bar.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLTEXT*) Pointer to a structure specifying the text.

Returns

Application should return zero if it processes the notification.

#define MC_HN_TITLETEXT   (MC_HN_FIRST + 4)

Fired when the browser changes title of the HTML page.

IE usually shows this in window caption or tab label.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLTEXT*) Pointer to a structure specifying the text.

Returns

Application should return zero if it processes the notification.

#define MC_HN_HISTORY   (MC_HN_FIRST + 5)

Fired when possibility of going back or forward in history changes.

This allow application to enable or disable the corresponding command buttons.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLURL*) Pointer to a structure specifying the text.

Returns

Application should return zero if it processes the notification.

See also

MC_HM_GOBACK MC_HM_CANBACK

#define MC_HN_NEWWINDOW   (MC_HN_FIRST + 6)

Fired when the browser would open a new window.

This happens for example if user clicks on a link while holding SHIFT.

MC_NMHTMLURL::pszUrl is URL to be opened in the new window. Note however that prior to Windows XP SP2, the URL is not filled.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLURL*) Pointer to a structure specifying details about the URL.

Returns

Application should return non-zero to allow opening the new window, or zero to deny it.

#define MC_HN_HTTPERROR   (MC_HN_FIRST + 7)

Fired to indicate that HTTP error has occurred.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTTPERROR*) Pointer to a structure specifying details about the error.

Returns

Application should return zero to allow browser to show standard error page corresponding to the error, or zero to disable that.

#define MC_HN_BEFORENAVIGATE   (MC_HN_FIRST + 8)

Fired before the browser navigates to a new URL.

Note that this is sent before (MC_HN_APPLINK), and returning non-zero will prevent (MC_HN_APPLINK) from being sent.

Parameters

[in]	wParam	(int) Id of the control sending the notification.
[in]	lParam	(MC_NMHTMLURL*) Pointer to a structure specifying details about the URL.

Returns

Application should return zero if navigation should continue.

#define MC_WC_HTML   MCTRL_NAME_AW(MC_WC_HTML)

Unicode-resolution alias.

See also

MC_WC_HTMLW MC_WC_HTMLA

#define MC_HM_GOTOURL   MCTRL_NAME_AW(MC_HM_GOTOURL)

Unicode-resolution alias.

See also

MC_HM_GOTOURLW MC_HM_GOTOURLA

#define MC_HM_SETTAGCONTENTS   MCTRL_NAME_AW(MC_HM_SETTAGCONTENTS)

Unicode-resolution alias.

See also

MC_HM_SETTAGCONTENTSW MC_HM_SETTAGCONTENTSA

#define MC_HM_CALLSCRIPTFUNC   MCTRL_NAME_AW(MC_HM_CALLSCRIPTFUNC)

Unicode-resolution alias.

See also

MC_HM_CALLSCRIPTFNW MC_HM_CALLSCRIPTFNA

#define MC_NMHTMLURL   MCTRL_NAME_AW(MC_NMHTMLURL)

Unicode-resolution alias.

See also

MC_NMHTMLURLW MC_NMHTMLURLA

#define MC_NMHTMLTEXT   MCTRL_NAME_AW(MC_NMHTMLTEXT)

Unicode-resolution alias.

See also

MC_NMHTMLTEXTW MC_NMHTMLTEXTA

#define MC_NMHTTPERROR   MCTRL_NAME_AW(MC_NMHTTPERROR)

Unicode-resolution alias.

See also

MC_NMHTTPERRORW MC_NMHTTPERRORA

#define MC_HMCALLSCRIPTFUNC   MCTRL_NAME_AW(MC_HMCALLSCRIPTFUNC)

Unicode-resolution alias.

See also

MC_HMCALLSCRIPTFUNCW MC_HMCALLSCRIPTFUNCA

Function Documentation

BOOL mcHtml_Initialize

(

void

)

Registers window class of the control.

Returns

TRUE on success, FALSE on failure.

void mcHtml_Terminate

(

void

)

Unregisters window class of the control.