Поделиться через


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

Следующие макросы можно использовать для обработки событий 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

См. также

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