DHTML 事件映射
以下宏可用于处理 DHTML 事件。
DHTML 事件映射宏
以下宏可用于处理 CDHtmlDialog 派生类中的 DHTML 事件。
| 名称 | 描述 |
|---|---|
| BEGIN_DHTML_EVENT_MAP | 标记 DHTML 事件映射的开头。 |
| BEGIN_DHTML_EVENT_MAP_INLINE | 标记 DHTML 事件映射的开头。 |
| DECLARE_DHTML_EVENT_MAP | 声明 DHTML 事件映射。 |
| DHTML_EVENT | 用于在文档级别处理单个 HTML 元素的事件。 |
| DHTML_EVENT_AXCONTROL | 用于处理 ActiveX 控件触发的事件。 |
| DHTML_EVENT_CLASS | 用于在文档级别为所有具有特定 CSS 类的 HTML 元素处理事件。 |
| DHTML_EVENT_ELEMENT | 用于在元素级别处理事件。 |
| DHTML_EVENT_ONAFTERUPDATE | 用于处理 HTML 元素中的 onafterupdate 事件。 |
| DHTML_EVENT_ONBEFOREUPDATE | 用于处理 HTML 元素中的 onbeforeupdate 事件。 |
| DHTML_EVENT_ONBLUR | 用于处理 HTML 元素中的 onblur 事件。 |
| DHTML_EVENT_ONCHANGE | 用于处理 HTML 元素中的 onchange 事件。 |
| DHTML_EVENT_ONCLICK | 用于处理 HTML 元素中的 onclick 事件。 |
| DHTML_EVENT_ONDATAAVAILABLE | 用于处理 HTML 元素中的 ondataavailable 事件。 |
| DHTML_EVENT_ONDATASETCHANGED | 用于处理 HTML 元素中的 ondatasetchanged 事件。 |
| DHTML_EVENT_ONDATASETCOMPLETE | 用于处理 HTML 元素中的 ondatasetcomplete 事件。 |
| DHTML_EVENT_ONDBLCLICK | 用于处理 HTML 元素中的 ondblclick 事件。 |
| DHTML_EVENT_ONDRAGSTART | 用于处理 HTML 元素中的 ondragstart 事件。 |
| DHTML_EVENT_ONERRORUPDATE | 用于处理 HTML 元素中的 onerrorupdate 事件。 |
| DHTML_EVENT_ONFILTERCHANGE | 用于处理 HTML 元素中的 onfilterchange 事件。 |
| DHTML_EVENT_ONFOCUS | 用于处理 HTML 元素中的 onfocus 事件。 |
| DHTML_EVENT_ONHELP | 用于处理 HTML 元素中的 onhelp 事件。 |
| DHTML_EVENT_ONKEYDOWN | 用于处理 HTML 元素中的 onkeydown 事件。 |
| DHTML_EVENT_ONKEYPRESS | 用于处理 HTML 元素中的 onkeypress 事件。 |
| DHTML_EVENT_ONKEYUP | 用于处理 HTML 元素中的 onkeyup 事件。 |
| DHTML_EVENT_ONMOUSEDOWN | 用于处理 HTML 元素中的 onmousedown 事件。 |
| DHTML_EVENT_ONMOUSEMOVE | 用于处理 HTML 元素中的 onmousemove 事件。 |
| DHTML_EVENT_ONMOUSEOUT | 用于处理 HTML 元素中的 onmouseout 事件。 |
| DHTML_EVENT_ONMOUSEOVER | 用于处理 HTML 元素中的 onmouseover 事件。 |
| DHTML_EVENT_ONMOUSEUP | 用于处理 HTML 元素中的 onmouseup 事件。 |
| DHTML_EVENT_ONRESIZE | 用于处理 HTML 元素中的 onresize 事件。 |
| DHTML_EVENT_ONROWENTER | 用于处理 HTML 元素中的 onrowenter 事件。 |
| DHTML_EVENT_ONROWEXIT | 用于处理 HTML 元素中的 onrowexit 事件。 |
| DHTML_EVENT_ONSELECTSTART | 用于处理 HTML 元素中的 onselectstart 事件。 |
| DHTML_EVENT_TAG | 用于在文档级别为所有具有特定 HTML 标记的元素处理事件。 |
| END_DHTML_EVENT_MAP | 标记 DHTML 事件映射的末尾。 |
| END_DHTML_EVENT_MAP_INLINE | 标记 DHTML 事件映射的末尾。 |
URL 事件映射宏
以下宏可用于处理 CMultiPageDHtmlDialog 派生类中的 DHTML 事件。
| 名称 | 描述 |
|---|---|
| BEGIN_DHTML_URL_EVENT_MAP | 标记多页 DHTML 和 URL 事件映射的开头。 |
| BEGIN_EMBED_DHTML_EVENT_MAP | 标记嵌入的 DHTML 事件映射的开头。 |
| BEGIN_URL_ENTRIES | 标记 URL 事件项映射的开头。 |
| DECLARE_DHTML_URL_EVENT_MAP | 声明多页 DHTML 和 URL 事件映射。 |
| END_DHTML_URL_EVENT_MAP | 标记多页 DHTML 和 URL 事件映射的末尾。 |
| END_EMBED_DHTML_EVENT_MAP | 标记嵌入的 DHTML 事件映射的末尾。 |
| END_URL_ENTRIES | 标记 URL 事件项映射的末尾。 |
| URL_EVENT_ENTRY | 将 URL 或 HTML 资源映射到多页对话框中的页面。 |
要求
标头：afxdhtml.h
BEGIN_DHTML_EVENT_MAP
当 DHTML 事件映射位于 className 标识的类的源文件中时，标记此事件映射的开头。
BEGIN_DHTML_EVENT_MAP(className)
参数
className
包含 DHTML 事件映射的类的名称。 此类应直接或间接从 CDHtmlDialog 派生，并在其类定义中包含 DECLARE_DHTML_EVENT_MAP 宏。
备注
将 DHTML 事件映射添加到类以向 CDHtmlDialog 提供信息，这些信息可用于将网页中的 HTML 元素或 ActiveX 控件触发的事件路由到类中的处理程序函数。
将 BEGIN_DHTML_EVENT_MAP 宏放入类的实现 (.cpp) 文件中，然后是类要处理的事件的 DHTML_EVENT 宏（例如用于鼠标悬停事件的 DHTML_EVENT_ONMOUSEOVER）。 使用 END_DHTML_EVENT_MAP 宏标记事件映射的末尾。 这些宏实现以下函数：
virtual const DHtmlEventMapEntry* GetDHtmlEventMap();
要求
标头：afxdhtml.h
BEGIN_DHTML_EVENT_MAP_INLINE
在 className 的类定义中标记 DHTML 事件映射的开头。
BEGIN_DHTML_EVENT_MAP_INLINE(className)
参数
className
包含 DHTML 事件映射的类的名称。 此类应直接或间接从 CDHtmlDialog 派生，并在其类定义中包含 DECLARE_DHTML_EVENT_MAP 宏。
注解
将 DHTML 事件映射添加到类以向 CDHtmlDialog 提供信息，这些信息可用于将网页中的 HTML 元素或 ActiveX 控件触发的事件路由到类中的处理程序函数。
将 BEGIN_DHTML_EVENT_MAP 宏放入类的定义 (.h) 文件中，然后是类要处理的事件的 DHTML_EVENT 宏（例如用于鼠标悬停事件的 DHTML_EVENT_ONMOUSEOVER）。 使用 END_DHTML_EVENT_MAP_INLINE 宏标记事件映射的末尾。 这些宏实现以下函数：
virtual const DHtmlEventMapEntry* GetDHtmlEventMap();
要求
标头：afxdhtml.h
DECLARE_DHTML_EVENT_MAP
在类定义中声明 DHTML 事件映射。
DECLARE_DHTML_EVENT_MAP()
备注
此宏将用于 CDHtmlDialog 派生类的定义。
使用 BEGIN_DHTML_EVENT_MAP 或 BEGIN_DHTML_EVENT_MAP_INLINE 实现映射。
DECLARE_DHTML_EVENT_MAP 声明以下函数：
virtual const DHtmlEventMapEntry* GetDHtmlEventMap( );
要求
标头：afxdhtml.h
DHTML_EVENT
（在文档级别）处理由 dispid 标识的事件，该事件源自 elemName 标识的 HTML元素。
DHTML_EVENT(dispid, elemName, memberFxn)
参数
dispid
要处理的事件的 DISPID。
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID 或处理文档事件的 NULL。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_AXCONTROL
处理由 dispid 标识的事件，该事件由 controlName 标识的 ActiveX 控件触发。
DHTML_EVENT_AXCONTROL(dispid, controlName, memberFxn)
参数
dispid
要处理的事件的调度 ID。
controlName
一个 LPCWSTR，它保存触发事件的控件的 HTML ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_CLASS
（在文档级别）处理由 dispid 标识的事件，该事件源自 elemName 标识的具有 CSS 类的任何 HTML 元素。
DHTML_EVENT_CLASS(dispid, elemName, memberFxn)
参数
dispid
要处理的事件的调度 ID。
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 CSS 类。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ELEMENT
（在由 elemName 标识的元素处）处理由 dispid 标识的事件。
DHTML_EVENT_ELEMENT(dispid, elemName, memberFxn)
参数
dispid
要处理的事件的调度 ID。
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
如果此宏用于处理非冒泡事件，则事件源将是由 elemName 标识的元素。
如果此宏用于处理冒泡事件，则由 elemName 标识的元素可能不是事件的源（源可以是 elemName 包含的任何元素）。
要求
标头：afxdhtml.h
DHTML_EVENT_ONAFTERUPDATE
（在文档级别）处理 onafterupdate 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONAFTERUPDATE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONBEFOREUPDATE
（在文档级别）处理 onbeforeupdate 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONBEFOREUPDATE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONBLUR
（在元素级别）处理 onblur 事件。 这是非冒泡事件。
DHTML_EVENT_ONBLUR(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONCHANGE
（在元素级别）处理 onchange 事件。 这是非冒泡事件。
DHTML_EVENT_ONCHANGE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONCLICK
（在文档级别）处理 onclick 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONCLICK(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONDATAAVAILABLE
（在文档级别）处理 ondataavailable 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONDATAAVAILABLE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONDATASETCHANGED
（在文档级别）处理 ondatasetchanged 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONDATASETCHANGED(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONDATASETCOMPLETE
（在文档级别）处理 ondatasetcomplete 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONDATASETCOMPLETE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONDBLCLICK
（在文档级别）处理 ondblclick 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONDBLCLICK(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONDRAGSTART
（在文档级别）处理 ondragstart 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONDRAGSTART(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONERRORUPDATE
（在文档级别）处理 onerrorupdate 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONERRORUPDATE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONFILTERCHANGE
（在文档级别）处理 onfilterchange 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONFILTERCHANGE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONFOCUS
（在元素级别）处理 onfocus 事件。 这是非冒泡事件。
DHTML_EVENT_ONFOCUS(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONHELP
（在文档级别）处理 onhelp 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONHELP(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONKEYDOWN
（在文档级别）处理 onkeydown 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONKEYDOWN(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONKEYPRESS
（在文档级别）处理 onkeypress 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONKEYPRESS(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONKEYUP
（在文档级别）处理 onkeyup 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONKEYUP(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONMOUSEDOWN
（在文档级别）处理 onmousedown 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONMOUSEDOWN(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONMOUSEMOVE
（在文档级别）处理 onmousemove 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONMOUSEMOVE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONMOUSEOUT
（在文档级别）处理 onmouseout 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONMOUSEOUT(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONMOUSEOVER
（在文档级别）处理 onmouseover 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONMOUSEOVER(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONMOUSEUP
（在文档级别）处理 onmouseup 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONMOUSEUP(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONRESIZE
（在元素级别）处理 onresize 事件。 这是非冒泡事件。
DHTML_EVENT_ONRESIZE(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONROWENTER
（在文档级别）处理 onrowenter 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONROWENTER(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONROWEXIT
（在文档级别）处理 onrowexit 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONROWEXIT(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
注解
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_ONSELECTSTART
（在文档级别）处理 onselectstart 事件，该事件源自 elemName 标识的 HTML 元素。
DHTML_EVENT_ONSELECTSTART(elemName, memberFxn)
参数
elemName
一个 LPCWSTR，它保存事件来源的 HTML 元素的 ID。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
DHTML_EVENT_TAG
（在文档级别）处理由 dispid 标识的事件，该事件源自 elemName 标识的具有 HTML 标记的任何 HTML 元素。
DHTML_EVENT_TAG(dispid, elemName, memberFxn)
参数
dispid
要处理的事件的调度 ID。
elemName
事件来源的 HTML 元素的 HTML 标记。
memberFxn
事件的处理程序函数。
备注
使用此宏向类中的 DHTML 事件映射添加项。
要求
标头：afxdhtml.h
END_DHTML_EVENT_MAP
标记 DHTML 事件映射的末尾。
END_DHTML_EVENT_MAP()
备注
必须与 BEGIN_DHTML_EVENT_MAP 一起使用。
要求
标头：afxdhtml.h
BEGIN_DHTML_URL_EVENT_MAP
在多页对话框中启动 DHTML 和 URL 事件映射的定义。
BEGIN_DHTML_URL_EVENT_MAP()
备注
将 BEGIN_DHTML_URL_EVENT_MAP 放入 CMultiPageDHtmlDialog 派生类的实现文件中。 在其后添加嵌入的 DHTML 事件映射和 URL 项，然后以 END_DHTML_URL_EVENT_MAP 结尾。 在类定义中包含 DECLARE_DHTML_URL_EVENT_MAP 宏。
示例
BEGIN_DHTML_URL_EVENT_MAP(CMyMultiPageDlg)
BEGIN_EMBED_DHTML_EVENT_MAP(CMyMultiPageDlg, Page1)
DHTML_EVENT_ONCLICK(_T("Next"), OnPage1Next)
END_EMBED_DHTML_EVENT_MAP()
BEGIN_EMBED_DHTML_EVENT_MAP(CMyMultiPageDlg, Page2)
DHTML_EVENT_ONCLICK(_T("Back"), OnPage2Back)
DHTML_EVENT_ONCLICK(_T("Next"), OnPage2Next)
END_EMBED_DHTML_EVENT_MAP()
BEGIN_EMBED_DHTML_EVENT_MAP(CMyMultiPageDlg, Page3)
DHTML_EVENT_ONCLICK(_T("Back"), OnPage3Back)
END_EMBED_DHTML_EVENT_MAP()
BEGIN_URL_ENTRIES(CMyMultiPageDlg)
URL_EVENT_ENTRY(CMyMultiPageDlg, _T("153"), Page1)
URL_EVENT_ENTRY(CMyMultiPageDlg, _T("154"), Page2)
URL_EVENT_ENTRY(CMyMultiPageDlg, _T("155"), Page3)
// Note: IDR_PAGE1 = 153, IDR_PAGE2 = 154, IDR_PAGE3 = 155
END_URL_ENTRIES()
END_DHTML_URL_EVENT_MAP(CMyMultiPageDlg)
要求
标头：afxdhtml.h
BEGIN_EMBED_DHTML_EVENT_MAP
在多页对话框中启动嵌入的 DHTML 事件映射的定义。
BEGIN_EMBED_DHTML_EVENT_MAP(className, mapName)
参数
className
包含事件映射的类的名称。 此类应直接或间接从 CMultiPageDHtmlDialog 派生。 嵌入的 DHTML 事件映射必须位于 DHTML 和 URL 事件映射中。
mapName
指定其事件映射的页面。 这与实际定义 URL 或 HTML 资源的 URL_EVENT_ENTRY 宏中的 mapName 匹配。
注解
由于多页 DHTML 对话框包含多个 HTML 页，每个页面都可以引发 DHTML 事件，因此嵌入的事件映射用于按页面将事件映射到处理程序。
DHTML 和 URL 事件映射中的嵌入事件映射由后跟 DHTML_EVENT 宏 的 BEGIN_EMBED_DHTML_EVENT_MAP 宏和 END_EMBED_DHTML_EVENT_MAP 宏组成。
每个嵌入的事件映射都需要一个相应的 URL 事件项才能将 mapName（在 BEGIN_EMBED_DHTML_EVENT_MAP 中指定）映射到 URL 或 HTML 资源。
示例
请参阅 BEGIN_DHTML_URL_EVENT_MAP 中的示例。
要求
标头：afxdhtml.h
BEGIN_URL_ENTRIES
在多页对话框中启动 URL 事件输入映射的定义。
BEGIN_URL_ENTRIES(className)
参数
className
包含 URL 事件映射的类的名称。 此类应直接或间接从 CMultiPageDHtmlDialog 派生。 URL 事件项映射必须位于 DHTML 和 URL 事件映射中。
备注
由于多页 DHTML 对话框包含多个 HTML 页，URL 事件项用于将 URL 或 HTML 资源映射到对应的嵌入 DHTML 事件映射。 将 URL_EVENT_ENTRY 宏放入 BEGIN_URL_ENTRIES 和 END_URL_ENTRIES 宏之间。
示例
请参阅 BEGIN_DHTML_URL_EVENT_MAP 中的示例。
要求
标头：afxdhtml.h
DECLARE_DHTML_URL_EVENT_MAP
在类定义中声明 DHTML 和 URL 事件映射。
DECLARE_DHTML_URL_EVENT_MAP()
备注
此宏将用于 CMultiPageDHtmlDialog 派生类的定义。
DHTML 和 URL 事件映射包含嵌入 DHTML 事件映射和 URL 事件项，以按页面将 DHTML 事件映射到处理程序。 使用 BEGIN_DHTML_URL_EVENT_MAP 实现映射。
要求
标头：afxdhtml.h
END_DHTML_URL_EVENT_MAP
标记 DHTML 和 URL 事件映射的末尾。
END_DHTML_URL_EVENT_MAP(className)
参数
className
包含事件映射的类的名称。 此类应直接或间接从 CMultiPageDHtmlDialog 派生。 这应与相应的 BEGIN_DHTML_URL_EVENT_MAP 宏中的 className 匹配。
示例
请参阅 BEGIN_DHTML_URL_EVENT_MAP 中的示例。
要求
标头：afxdhtml.h
END_EMBED_DHTML_EVENT_MAP
标记嵌入的 DHTML 事件映射的末尾。
END_EMBED_DHTML_EVENT_MAP()
示例
请参阅 BEGIN_DHTML_URL_EVENT_MAP 中的示例。
要求
标头：afxdhtml.h
END_URL_ENTRIES
标记 URL 事件项映射的末尾。
END_URL_ENTRIES()
示例
请参阅 BEGIN_DHTML_URL_EVENT_MAP 中的示例。
要求
标头：afxdhtml.h
URL_EVENT_ENTRY
将 URL 或 HTML 资源映射到多页对话框中的页面。
URL_EVENT_ENTRY(className, url, mapName)
参数
className
包含 URL 事件映射的类的名称。 此类应直接或间接从 CMultiPageDHtmlDialog 派生。 URL 事件项映射必须位于 DHTML 和 URL 事件映射中。
url
页面的 URL 或 HTML 资源。
mapName
指定其 URL 为 url 的页面。 这与映射此页面事件的 BEGIN_EMBED_DHTML_EVENT_MAP 宏中的 mapName 匹配。
注解
如果页面为 HTML 资源，则 url 必须是资源 ID 号的字符串表示形式（即“123”，而不是 123 或 ID_HTMLRES1）。
页标识符 mapName 是一个任意符号，用于将嵌入 DHTML 事件映射链接到 URL 事件项映射。 范围仅限于 DHTML 和 URL 事件映射。
示例
请参阅 BEGIN_DHTML_URL_EVENT_MAP 中的示例。
要求
标头：afxdhtml.h
END_DHTML_EVENT_MAP_INLINE
标记 DHTML 事件映射的末尾。
语法
END_DHTML_EVENT_MAP_INLINE( )
备注
必须与 _DHTML_EVENT_MAP_INLINE 一起使用。
要求
标头：afxdhtml.h
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈