DHTML 事件對應

發行項
10/12/2023

下列宏可用來處理 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	用來處理 `onafterupdate` HTML 元素的事件。
DHTML_EVENT_ONBEFOREUPDATE	用來處理 `onbeforeupdate` HTML 元素的事件。
DHTML_EVENT_ONBLUR	用來處理 `onblur` HTML 元素的事件。
DHTML_EVENT_ONCHANGE	用來處理 `onchange` HTML 元素的事件。
DHTML_EVENT_ONCLICK	用來處理 `onclick` HTML 元素的事件。
DHTML_EVENT_ONDATAAVAILABLE	用來處理 `ondataavailable` HTML 元素的事件。
DHTML_EVENT_ONDATASETCHANGED	用來處理 `ondatasetchanged` HTML 元素的事件。
DHTML_EVENT_ONDATASETCOMPLETE	用來處理 `ondatasetcomplete` HTML 元素的事件。
DHTML_EVENT_ONDBLCLICK	用來處理 `ondblclick` HTML 元素的事件。
DHTML_EVENT_ONDRAGSTART	用來處理 `ondragstart` HTML 元素的事件。
DHTML_EVENT_ONERRORUPDATE	用來處理 `onerrorupdate` HTML 元素的事件。
DHTML_EVENT_ONFILTERCHANGE	用來處理 `onfilterchange` HTML 元素的事件。
DHTML_EVENT_ONFOCUS	用來處理 `onfocus` HTML 元素的事件。
DHTML_EVENT_ONHELP	用來處理 `onhelp` HTML 元素的事件。
DHTML_EVENT_ONKEYDOWN	用來處理 `onkeydown` HTML 元素的事件。
DHTML_EVENT_ONKEYPRESS	用來處理 `onkeypress` HTML 元素的事件。
DHTML_EVENT_ONKEYUP	用來處理 `onkeyup` HTML 元素的事件。
DHTML_EVENT_ONMOUSEDOWN	用來處理 `onmousedown` HTML 元素的事件。
DHTML_EVENT_ONMOUSEMOVE	用來處理 `onmousemove` HTML 元素的事件。
DHTML_EVENT_ONMOUSEOUT	用來處理 `onmouseout` HTML 元素的事件。
DHTML_EVENT_ONMOUSEOVER	用來處理 `onmouseover` HTML 元素的事件。
DHTML_EVENT_ONMOUSEUP	用來處理 `onmouseup` HTML 元素的事件。
DHTML_EVENT_ONRESIZE	用來處理 `onresize` HTML 元素的事件。
DHTML_EVENT_ONROWENTER	用來處理 `onrowenter` HTML 元素的事件。
DHTML_EVENT_ONROWEXIT	用來處理 `onrowexit` HTML 元素的事件。
DHTML_EVENT_ONSELECTSTART	用來處理 `onselectstart` HTML 元素的事件。
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 類別的來源檔案中時，標記 DHTML 事件對應的開頭。

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 元素識別碼，或 Null 來處理檔事件。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_AXCONTROL

處理由 controlName 所識別的 ActiveX 控制項所引發之 dispid 所識別 的事件。

DHTML_EVENT_AXCONTROL(dispid, controlName,  memberFxn)

參數

dispid
要處理之事件的分派識別碼。

controlName
LPCWSTR，包含控制項引發事件的 HTML 識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_CLASS

處理（在檔層級）由 dispid 所識別 的事件，由任何 HTML 元素所識別，且 CSS 類別由 elemName 所識別。

DHTML_EVENT_CLASS(dispid, elemName,  memberFxn)

參數

dispid
要處理之事件的分派識別碼。

elemName
LPCWSTR，包含來源事件的 HTML 元素 CSS 類別。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ELEMENT

處理（在 elemName 所識別的專案上）由 dispid 識別的事件。

DHTML_EVENT_ELEMENT(dispid, elemName,  memberFxn)

參數

dispid
要處理之事件的分派識別碼。

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

如果這個宏是用來處理非布建事件，則事件的來源會是 elemName 所識別的專案。

如果這個宏用來處理反升事件，elemName 所識別的元素可能不是事件的來源（來源可以是 elemName 所包含的 任何元素）。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONAFTERUPDATE

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onafterupdate ）。

DHTML_EVENT_ONAFTERUPDATE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONBEFOREUPDATE

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onbeforeupdate ）。

DHTML_EVENT_ONBEFOREUPDATE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONBLUR

處理事件（在專案層級）。 onblur 這是非布建事件。

DHTML_EVENT_ONBLUR(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONCHANGE

處理事件（在專案層級）。 onchange 這是非布建事件。

DHTML_EVENT_ONCHANGE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONCLICK

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onclick ）。

DHTML_EVENT_ONCLICK(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONDATAAVAILABLE

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 ondataavailable ）。

DHTML_EVENT_ONDATAAVAILABLE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONDATASETCHANGED

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 ondatasetchanged ）。

DHTML_EVENT_ONDATASETCHANGED(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONDATASETCOMPLETE

處理（在檔層級） ondatasetcomplete 事件，由所 elemName 識別的 HTML 專案所產生。

DHTML_EVENT_ONDATASETCOMPLETE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONDBLCLICK

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 ondblclick ）。

DHTML_EVENT_ONDBLCLICK(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONDRAGSTART

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 ondragstart ）。

DHTML_EVENT_ONDRAGSTART(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONERRORUPDATE

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onerrorupdate ）。

DHTML_EVENT_ONERRORUPDATE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONFILTERCHANGE

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onfilterchange ）。

DHTML_EVENT_ONFILTERCHANGE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONFOCUS

處理事件（在專案層級）。 onfocus 這是非布建事件。

DHTML_EVENT_ONFOCUS(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONHELP

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onhelp ）。

DHTML_EVENT_ONHELP(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONKEYDOWN

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onkeydown ）。

DHTML_EVENT_ONKEYDOWN(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONKEYPRESS

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onkeypress ）。

DHTML_EVENT_ONKEYPRESS(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONKEYUP

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onkeyup ）。

DHTML_EVENT_ONKEYUP(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONMOUSEDOWN

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onmousedown ）。

DHTML_EVENT_ONMOUSEDOWN(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONMOUSEMOVE

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onmousemove ）。

DHTML_EVENT_ONMOUSEMOVE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONMOUSEOUT

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onmouseout ）。

DHTML_EVENT_ONMOUSEOUT(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONMOUSEOVER

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onmouseover ）。

DHTML_EVENT_ONMOUSEOVER(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONMOUSEUP

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onmouseup ）。

DHTML_EVENT_ONMOUSEUP(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONRESIZE

處理事件（在專案層級）。 onresize 這是非布建事件。

DHTML_EVENT_ONRESIZE(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONROWENTER

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onrowenter ）。

DHTML_EVENT_ONROWENTER(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONROWEXIT

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onrowexit ）。

DHTML_EVENT_ONROWEXIT(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_ONSELECTSTART

處理由 elemName 所識別的 HTML 專案所產生之事件（在檔層級 onselectstart ）。

DHTML_EVENT_ONSELECTSTART(elemName, memberFxn)

參數

elemName
LPCWSTR，包含來源事件的 HTML 專案識別碼。

memberFxn
事件的處理常式函式。

備註

使用此宏，將專案新增至類別中的 DHTML 事件對應。

需求

標頭 afxdhtml.h

DHTML_EVENT_TAG

處理（在檔層級）由任何 HTML 元素所識別 dispid 的事件，以及 elemName 所識別的 HTML 標籤。

DHTML_EVENT_TAG(dispid, elemName,  memberFxn)

參數

dispid
要處理之事件的分派識別碼。

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_EVENT_ENTRY 宏中實際定義 URL 或 HTML 資源的 mapName 。

備註

由於多頁 DHTML 對話方塊是由多個 HTML 頁面所組成，因此每個頁面都可以引發 DHTML 事件，因此內嵌事件對應會用來將事件對應至每個頁面的處理常式。

DHTML 和 URL 事件對應內的內嵌事件對應是由BEGIN_EMBED_DHTML_EVENT_MAP宏所組成，後面接著 DHTML_EVENT 宏和 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 事件對應。在BEGIN_URL_ENTRIES和 END_URL_ENTRIES 宏之間放置URL_EVENT_ENTRY宏。

範例

請參閱 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 必須是資源識別碼的字串標記法（也就是「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( )

備註

必須與BEGIN_DHTML_EVENT_MAP_INLINE 搭配使用。

需求

標頭： afxdhtml.h

另請參閱

宏和全域

共用方式為

DHTML 事件對應