Схемы событий DHTML

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Следующие макросы можно использовать для обработки событий DHTML.

Макросы карты событий DHTML

Следующие макросы можно использовать для обработки событий DHTML в классах, производных от CDHtmlDialog.

Имя	Описание
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	Используется для обработки события на уровне документа для всех ЭЛЕМЕНТОВ HTML с определенным классом CSS.
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

Следующие макросы можно использовать для обработки событий DHTML в классах, производных от CMultiPageDHtmlDialog.

Имя	Описание
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

Помечает начало карты событий DHTML в определении класса для className.

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

Обрабатывает (на уровне документа) событие, определяемое диспидируемым элементом HTML, определяемым elemName.

DHTML_EVENT(dispid, elemName,  memberFxn)

Параметры

dispid
DISPID для обработки события.

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события или NULL для обработки событий документа.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_AXCONTROL

Обрабатывает событие, определяемое диспидируемым элементом управления ActiveX, определяемым по имени элемента управления.

DHTML_EVENT_AXCONTROL(dispid, controlName,  memberFxn)

Параметры

dispid
Идентификатор отправки события для обработки.

controlName
LPCWSTR, содержащий HTML-идентификатор элемента управления, запускающего событие.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_CLASS

Обрабатывает (на уровне документа) событие, определяемое диспиром, созданным любым HTML-элементом с классом CSS, определяемым elemName.

DHTML_EVENT_CLASS(dispid, elemName,  memberFxn)

Параметры

dispid
Идентификатор отправки события для обработки.

elemName
LPCWSTR, содержащий класс CSS элементов HTML, которые курят событие.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ELEMENT

Обрабатывает (в элементе, определяемом elemName) событие, определяемое диспидом.

DHTML_EVENT_ELEMENT(dispid, elemName,  memberFxn)

Параметры

dispid
Идентификатор отправки события для обработки.

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Если этот макрос используется для обработки небубблинговых событий, источник события будет элементом, определяемым elemName.

Если этот макрос используется для обработки событий пузырьков, элемент, определяемый elemName , не может быть источником события (источник может быть любым элементом, содержащимся в elemName).

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONAFTERUPDATE

Обрабатывает событие (на уровне документа) onafterupdate событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONAFTERUPDATE(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONBEFOREUPDATE

Обрабатывает событие (на уровне документа) onbeforeupdate событие, созданное элементом HTML, определяемым elemName.

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

Обрабатывает событие (на уровне документа) onclick событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONCLICK(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONDATAAVAILABLE

Обрабатывает событие (на уровне документа) ondataavailable событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONDATAAVAILABLE(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONDATASETCHANGED

Обрабатывает событие (на уровне документа) ondatasetchanged событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONDATASETCHANGED(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONDATASETCOMPLETE

Обрабатывает событие (на уровне документа), ondatasetcomplete созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONDATASETCOMPLETE(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONDBLCLICK

Обрабатывает событие (на уровне документа) ondblclick событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONDBLCLICK(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONDRAGSTART

Обрабатывает событие (на уровне документа) ondragstart событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONDRAGSTART(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONERRORUPDATE

Обрабатывает событие (на уровне документа) onerrorupdate событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONERRORUPDATE(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONFILTERCHANGE

Обрабатывает событие (на уровне документа) onfilterchange событие, созданное элементом HTML, определяемым elemName.

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

Обрабатывает событие (на уровне документа) onhelp событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONHELP(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONKEYDOWN

Обрабатывает событие (на уровне документа) onkeydown событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONKEYDOWN(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONKEYPRESS

Обрабатывает событие (на уровне документа) onkeypress событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONKEYPRESS(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONKEYUP

Обрабатывает событие (на уровне документа) onkeyup событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONKEYUP(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONMOUSEDOWN

Обрабатывает событие (на уровне документа) onmousedown событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONMOUSEDOWN(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONMOUSEMOVE

Обрабатывает событие (на уровне документа) onmousemove событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONMOUSEMOVE(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONMOUSEOUT

Обрабатывает событие (на уровне документа) onmouseout событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONMOUSEOUT(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONMOUSEOVER

Обрабатывает событие (на уровне документа) onmouseover событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONMOUSEOVER(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONMOUSEUP

Обрабатывает событие (на уровне документа) onmouseup событие, созданное элементом HTML, определяемым elemName.

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

Обрабатывает событие (на уровне документа) onrowenter событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONROWENTER(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONROWEXIT

Обрабатывает событие (на уровне документа) onrowexit событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONROWEXIT(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_ONSELECTSTART

Обрабатывает событие (на уровне документа) onselectstart событие, созданное элементом HTML, определяемым elemName.

DHTML_EVENT_ONSELECTSTART(elemName, memberFxn)

Параметры

elemName
LPCWSTR, содержащий идентификатор HTML-элемента, источника события.

memberFxn
Функция обработчика для события.

Замечания

Используйте этот макрос, чтобы добавить запись в карту событий DHTML в классе.

Требования

Заголовок afxdhtml.h

DHTML_EVENT_TAG

Обрабатывает (на уровне документа) событие, определяемое dispid любым элементом HTML с тегом HTML, определяемым elemName.

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
Указывает страницу с картой событий. Это соответствует mapName в макросе URL_EVENT_ENTRY фактически определяя URL-адрес или ресурс HTML.

Замечания

Так как диалоговое окно DHTML с несколькими html-страницами состоит из нескольких 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-страницами состоит из нескольких 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. Это должно соответствовать className в соответствующем макросе BEGIN_DHTML_URL_EVENT_MAP .

Пример

См. пример в 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-адресом. Это соответствует mapName в макросе BEGIN_EMBED_DHTML_EVENT_MAP, который сопоставляет события с этой страницы.

Замечания

Если страница является 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

См. также

Макросы и глобальные