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_MAPBEGIN_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

另请参阅

宏和全局函数