Partilhar via


Mapas de Eventos DHTML

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

As macros seguintes podem ser usadas para lidar com eventos DHTML.

Macros do Mapa de Eventos DHTML

As macros seguintes podem ser usadas para lidar com eventos DHTML em classes derivadas do CDHtmlDialog.

Nome Description
BEGIN_DHTML_EVENT_MAP Marca o início do mapa de eventos DHTML.
BEGIN_DHTML_EVENT_MAP_INLINE Marca o início do mapa de eventos DHTML.
DECLARE_DHTML_EVENT_MAP Declara o mapa de eventos DHTML.
DHTML_EVENT Usado para gerir um evento ao nível do documento para um único elemento HTML.
DHTML_EVENT_AXCONTROL Usado para gerir um evento disparado por um controlo ActiveX.
DHTML_EVENT_CLASS Usado para gerir um evento ao nível do documento para todos os elementos HTML com uma classe CSS específica.
DHTML_EVENT_ELEMENT Usado para gerir um evento ao nível do elemento.
DHTML_EVENT_ONAFTERUPDATE Usado para gerir o onafterupdate evento a partir de um elemento HTML.
DHTML_EVENT_ONBEFOREUPDATE Usado para gerir o onbeforeupdate evento a partir de um elemento HTML.
DHTML_EVENT_ONBLUR Usado para gerir o onblur evento a partir de um elemento HTML.
DHTML_EVENT_ONCHANGE Usado para gerir o onchange evento a partir de um elemento HTML.
DHTML_EVENT_ONCLICK Usado para gerir o onclick evento a partir de um elemento HTML.
DHTML_EVENT_ONDATAAVAILABLE Usado para gerir o ondataavailable evento a partir de um elemento HTML.
DHTML_EVENT_ONDATASETCHANGED Usado para gerir o ondatasetchanged evento a partir de um elemento HTML.
DHTML_EVENT_ONDATASETCOMPLETE Usado para gerir o ondatasetcomplete evento a partir de um elemento HTML.
DHTML_EVENT_ONDBLCLICK Usado para gerir o ondblclick evento a partir de um elemento HTML.
DHTML_EVENT_ONDRAGSTART Usado para gerir o ondragstart evento a partir de um elemento HTML.
DHTML_EVENT_ONERRORUPDATE Usado para gerir o onerrorupdate evento a partir de um elemento HTML.
DHTML_EVENT_ONFILTERCHANGE Usado para gerir o onfilterchange evento a partir de um elemento HTML.
DHTML_EVENT_ONFOCUS Usado para gerir o onfocus evento a partir de um elemento HTML.
DHTML_EVENT_ONHELP Usado para gerir o onhelp evento a partir de um elemento HTML.
DHTML_EVENT_ONKEYDOWN Usado para gerir o onkeydown evento a partir de um elemento HTML.
DHTML_EVENT_ONKEYPRESS Usado para gerir o onkeypress evento a partir de um elemento HTML.
DHTML_EVENT_ONKEYUP Usado para gerir o onkeyup evento a partir de um elemento HTML.
DHTML_EVENT_ONMOUSEDOWN Usado para gerir o onmousedown evento a partir de um elemento HTML.
DHTML_EVENT_ONMOUSEMOVE Usado para gerir o onmousemove evento a partir de um elemento HTML.
DHTML_EVENT_ONMOUSEOUT Usado para gerir o onmouseout evento a partir de um elemento HTML.
DHTML_EVENT_ONMOUSEOVER Usado para gerir o onmouseover evento a partir de um elemento HTML.
DHTML_EVENT_ONMOUSEUP Usado para gerir o onmouseup evento a partir de um elemento HTML.
DHTML_EVENT_ONRESIZE Usado para gerir o onresize evento a partir de um elemento HTML.
DHTML_EVENT_ONROWENTER Usado para gerir o onrowenter evento a partir de um elemento HTML.
DHTML_EVENT_ONROWEXIT Usado para gerir o onrowexit evento a partir de um elemento HTML.
DHTML_EVENT_ONSELECTSTART Usado para gerir o onselectstart evento a partir de um elemento HTML.
DHTML_EVENT_TAG Usado para gerir um evento ao nível do documento para todos os elementos com uma tag HTML específica.
END_DHTML_EVENT_MAP Marca o fim do mapa de eventos DHTML.
END_DHTML_EVENT_MAP_INLINE Marca o fim do mapa de eventos DHTML.

Macros do Mapa de Eventos de URL

As macros seguintes podem ser usadas para lidar com eventos DHTML em classes derivadas do CMultiPageDHtmlDialog.

Nome Description
BEGIN_DHTML_URL_EVENT_MAP Marca o início do mapa de eventos multipágina DHTML e URL.
BEGIN_EMBED_DHTML_EVENT_MAP Marca o início de um mapa de eventos DHTML incorporado.
BEGIN_URL_ENTRIES Marca o início de um mapa de entrada de eventos URL.
DECLARE_DHTML_URL_EVENT_MAP Declara o DHTML multipágina e o mapa de eventos URL.
END_DHTML_URL_EVENT_MAP Marca o fim do mapa de eventos multipágina em DHTML e URL.
END_EMBED_DHTML_EVENT_MAP Marca o fim de um mapa de eventos DHTML incorporado.
END_URL_ENTRIES Marca o fim de um mapa de entrada de evento URL.
URL_EVENT_ENTRY Mapeia um URL ou recurso HTML para uma página num diálogo multipágina.

Requerimentos

Cabeçalho afxdhtml.h

BEGIN_DHTML_EVENT_MAP

Marca o início do mapa de eventos DHTML quando colocado no ficheiro fonte da classe identificada por className.

BEGIN_DHTML_EVENT_MAP(className)

Parâmetros

Nome da Classe
O nome da classe que contém o mapa de eventos DHTML. Esta classe deve derivar direta ou indiretamente do CDHtmlDialog e incluir a macro DECLARE_DHTML_EVENT_MAP dentro da sua definição de classe.

Observações

Adicione um mapa de eventos DHTML à sua classe para fornecer informação CDHtmlDialog que possa ser usada para encaminhar eventos disparados por elementos HTML ou controlos ActiveX numa página web para gerir funções na sua turma.

Coloque a macro BEGIN_DHTML_EVENT_MAP no ficheiro de implementação (.cpp) da classe, seguida de macros DHTML_EVENT para os eventos que a classe deve gerir (por exemplo, DHTML_EVENT_ONMOUSEOVER para eventos de mouseover). Use a macro END_DHTML_EVENT_MAP para marcar o fim do mapa de eventos. Estes macros implementam a seguinte função:

virtual const DHtmlEventMapEntry* GetDHtmlEventMap();

Requerimentos

Cabeçalho afxdhtml.h

BEGIN_DHTML_EVENT_MAP_INLINE

Marca o início do mapa de eventos DHTML dentro da definição de classe para className.

BEGIN_DHTML_EVENT_MAP_INLINE(className)

Parâmetros

Nome da Classe
O nome da classe que contém o mapa de eventos DHTML. Esta classe deve derivar direta ou indiretamente do CDHtmlDialog e incluir a macro DECLARE_DHTML_EVENT_MAP dentro da sua definição de classe.

Observações

Adicione um mapa de eventos DHTML à sua classe para fornecer informação CDHtmlDialog que possa ser usada para encaminhar eventos disparados por elementos HTML ou controlos ActiveX numa página web para gerir funções na sua turma.

Coloque a macro BEGIN_DHTML_EVENT_MAP no ficheiro de definição (.h) da classe seguida de DHTML_EVENT macros para os eventos que a classe deve tratar (por exemplo, DHTML_EVENT_ONMOUSEOVER para eventos de rato). Usa a macro END_DHTML_EVENT_MAP_INLINE para assinalar o fim do mapa de eventos. Estes macros implementam a seguinte função:

virtual const DHtmlEventMapEntry* GetDHtmlEventMap();

Requerimentos

Cabeçalho afxdhtml.h

DECLARE_DHTML_EVENT_MAP

Declara um mapa de eventos DHTML numa definição de classe.

DECLARE_DHTML_EVENT_MAP()

Observações

Esta macro deve ser usada na definição de classes derivadas do CDHtmlDialog.

Usa BEGIN_DHTML_EVENT_MAP ou BEGIN_DHTML_EVENT_MAP_INLINE para implementar o mapa.

DECLARE_DHTML_EVENT_MAP declara a seguinte função:

virtual const DHtmlEventMapEntry* GetDHtmlEventMap( );

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT

Trata (ao nível do documento) um evento identificado por dispid originado pelo elemento HTML identificado por elemName.

DHTML_EVENT(dispid, elemName,  memberFxn)

Parâmetros

dispid
O DISPID do evento a ser tratado.

elemName
Um LPCWSTR que detém o ID do elemento HTML que origina o evento, ou NULL para gerir eventos do documento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_AXCONTROL

Trata do evento identificado por dispor disparado pelo controlo ActiveX identificado por controlName.

DHTML_EVENT_AXCONTROL(dispid, controlName,  memberFxn)

Parâmetros

dispid
O ID de despacho do evento a ser tratado.

controlName
Um LPCWSTR que detém o ID HTML do controlo que está a executar o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_CLASS

Trata (ao nível do documento) um evento identificado por dispid originado por qualquer elemento HTML com a classe CSS identificada por elemName.

DHTML_EVENT_CLASS(dispid, elemName,  memberFxn)

Parâmetros

dispid
O ID de despacho do evento a ser tratado.

elemName
Um LPCWSTR que detém a classe CSS dos elementos HTML que fornecem o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ELEMENT

Trata (no elemento identificado por elemName) um evento identificado por dispid.

DHTML_EVENT_ELEMENT(dispid, elemName,  memberFxn)

Parâmetros

dispid
O ID de despacho do evento a ser tratado.

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Se este macro for usado para lidar com eventos não bubbling, a origem do evento será o elemento identificado por elemName.

Se esta macro for usada para lidar com eventos de bubbling, o elemento identificado por elemName pode não ser a fonte do evento (a fonte pode ser qualquer elemento contido por elemName).

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONAFTERUPDATE

Trata (ao nível do documento) o onafterupdate evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONAFTERUPDATE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONBEFOREUPDATE

Trata (ao nível do documento) o onbeforeupdate evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONBEFOREUPDATE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONBLUR

Trata (ao nível dos elementos) do onblur evento. Este é um evento que não borbulha.

DHTML_EVENT_ONBLUR(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONCHANGE

Trata (ao nível dos elementos) do onchange evento. Este é um evento que não borbulha.

DHTML_EVENT_ONCHANGE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONCLICK

Trata (ao nível do documento) o onclick evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONCLICK(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONDATAAVAILABLE

Trata (ao nível do documento) o ondataavailable evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONDATAAVAILABLE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONDATASETCHANGED

Trata (ao nível do documento) o ondatasetchanged evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONDATASETCHANGED(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONDATASETCOMPLETE

Trata (ao nível do documento) o ondatasetcomplete evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONDATASETCOMPLETE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONDBLCLICK

Trata (ao nível do documento) o ondblclick evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONDBLCLICK(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONDRAGSTART

Trata (ao nível do documento) o ondragstart evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONDRAGSTART(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONERRORUPDATE

Trata (ao nível do documento) o onerrorupdate evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONERRORUPDATE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONFILTERCHANGE

Trata (ao nível do documento) o onfilterchange evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONFILTERCHANGE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONFOCUS

Trata (ao nível dos elementos) do onfocus evento. Este é um evento que não borbulha.

DHTML_EVENT_ONFOCUS(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONHELP

Trata (ao nível do documento) o onhelp evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONHELP(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONKEYDOWN

Trata (ao nível do documento) o onkeydown evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONKEYDOWN(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONKEYPRESS

Trata (ao nível do documento) o onkeypress evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONKEYPRESS(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONKEYUP

Trata (ao nível do documento) o onkeyup evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONKEYUP(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONMOUSEDOWN

Trata (ao nível do documento) o onmousedown evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONMOUSEDOWN(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONMOUSEMOVE

Trata (ao nível do documento) o onmousemove evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONMOUSEMOVE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONMOUSEOUT

Trata (ao nível do documento) o onmouseout evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONMOUSEOUT(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONMOUSEOVER

Trata (ao nível do documento) o onmouseover evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONMOUSEOVER(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONMOUSEUP

Trata (ao nível do documento) o onmouseup evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONMOUSEUP(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONRESIZE

Trata (ao nível dos elementos) do onresize evento. Este é um evento que não borbulha.

DHTML_EVENT_ONRESIZE(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONROWENTER

Trata (ao nível do documento) o onrowenter evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONROWENTER(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONROWEXIT

Trata (ao nível do documento) o onrowexit evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONROWEXIT(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_ONSELECTSTART

Trata (ao nível do documento) o onselectstart evento originado pelo elemento HTML identificado por elemName.

DHTML_EVENT_ONSELECTSTART(elemName, memberFxn)

Parâmetros

elemName
Um LPCWSTR que detém o ID do elemento HTML que fornece o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

DHTML_EVENT_TAG

Trata (ao nível do documento) um evento identificado por dispid originado por qualquer elemento HTML com a etiqueta HTML identificada por elemName.

DHTML_EVENT_TAG(dispid, elemName,  memberFxn)

Parâmetros

dispid
O ID de despacho do evento a ser tratado.

elemName
A etiqueta HTML dos elementos HTML que originam o evento.

membroFxn
A função handler para o evento.

Observações

Use esta macro para adicionar uma entrada ao mapa de eventos DHTML da sua turma.

Requerimentos

Cabeçalho afxdhtml.h

END_DHTML_EVENT_MAP

Marca o fim do mapa de eventos DHTML.

END_DHTML_EVENT_MAP()

Observações

Deve ser usado em conjunto com BEGIN_DHTML_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

BEGIN_DHTML_URL_EVENT_MAP

Inicia a definição de um mapa de eventos DHTML e URL num diálogo de várias páginas.

BEGIN_DHTML_URL_EVENT_MAP()

Observações

Coloque BEGIN_DHTML_URL_EVENT_MAP no ficheiro de implementação da sua classe derivada do CMultiPageDHtmlDialog. Segue com mapas de eventos DHTML incorporados e entradas URL, e depois fecha com END_DHTML_URL_EVENT_MAP. Inclua a macro DECLARE_DHTML_URL_EVENT_MAP dentro da definição da classe.

Example

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)

Requerimentos

Cabeçalho afxdhtml.h

BEGIN_EMBED_DHTML_EVENT_MAP

Inicia a definição de um mapa de eventos DHTML embutido num diálogo multipágina.

BEGIN_EMBED_DHTML_EVENT_MAP(className, mapName)

Parâmetros

Nome da Classe
O nome da classe que contém o mapa de eventos. Esta classe deve derivar direta ou indiretamente de CMultiPageDHtmlDialog. O mapa de eventos DHTML incorporado deve estar dentro de um mapa de eventos DHTML e URL).

Nome do mapa
Especifica a página cujo mapa de eventos pertence. Isto corresponde ao mapName na macro URL_EVENT_ENTRY que define realmente o URL ou recurso HTML.

Observações

Como um diálogo DHTML multipágina consiste em múltiplas páginas HTML, cada uma das quais pode gerar eventos DHTML, mapas de eventos incorporados são usados para mapear eventos para handlers por página.

Os mapas de eventos incorporados dentro de um mapa de eventos DHTML e URL consistem numa macro BEGIN_EMBED_DHTML_EVENT_MAP seguida de macros DHTML_EVENT e uma macro END_EMBED_DHTML_EVENT_MAP .

Cada mapa de evento incorporado requer uma entrada de evento URL correspondente para mapear o Nome do mapa (especificado em BEGIN_EMBED_DHTML_EVENT_MAP) para um URL ou recurso HTML.

Example

Veja o exemplo em BEGIN_DHTML_URL_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

BEGIN_URL_ENTRIES

Inicia a definição de um mapa de entrada de eventos de URL num diálogo multipágina.

BEGIN_URL_ENTRIES(className)

Parâmetros

Nome da Classe
O nome da classe que contém o mapa de entrada do evento URL. Esta classe deve derivar direta ou indiretamente de CMultiPageDHtmlDialog. O mapa de entrada de eventos URL deve estar dentro de um mapa de eventos DHTML e URL).

Observações

Como um diálogo DHTML multipágina consiste em várias páginas HTML, as entradas de eventos URL são usadas para mapear URLs ou recursos HTML para mapas de eventos DHTML incorporados correspondentes. Coloca URL_EVENT_ENTRY macros entre BEGIN_URL_ENTRIES e END_URL_ENTRIES macros.

Example

Veja o exemplo em BEGIN_DHTML_URL_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

DECLARE_DHTML_URL_EVENT_MAP

Declara um mapa de eventos DHTML e URL numa definição de classe.

DECLARE_DHTML_URL_EVENT_MAP()

Observações

Esta macro deve ser usada na definição de classes derivadas do CMultiPageDHtmlDialog.

Um mapa de eventos DHTML e URL contém mapas de eventos DHTML incorporados e entradas de eventos URL para mapear eventos DHTML para handlers por página. Usa BEGIN_DHTML_URL_EVENT_MAP para implementar o mapa.

Requerimentos

Cabeçalho afxdhtml.h

END_DHTML_URL_EVENT_MAP

Marca o fim de um mapa de eventos DHTML e URL.

END_DHTML_URL_EVENT_MAP(className)

Parâmetros

Nome da Classe
O nome da classe que contém o mapa de eventos. Esta classe deve derivar direta ou indiretamente de CMultiPageDHtmlDialog. Isto deve corresponder ao className na macro BEGIN_DHTML_URL_EVENT_MAP correspondente.

Example

Veja o exemplo em BEGIN_DHTML_URL_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

END_EMBED_DHTML_EVENT_MAP

Marca o fim de um mapa de eventos DHTML incorporado.

END_EMBED_DHTML_EVENT_MAP()

Example

Veja o exemplo em BEGIN_DHTML_URL_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

END_URL_ENTRIES

Marca o fim de um mapa de entrada de evento URL.

END_URL_ENTRIES()

Example

Veja o exemplo em BEGIN_DHTML_URL_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

URL_EVENT_ENTRY

Mapeia um URL ou recurso HTML para uma página num diálogo multipágina.

URL_EVENT_ENTRY(className, url,  mapName)

Parâmetros

Nome da Classe
O nome da classe que contém o mapa de entrada do evento URL. Esta classe deve derivar direta ou indiretamente de CMultiPageDHtmlDialog. O mapa de entrada de eventos URL deve estar dentro de um mapa de eventos DHTML e URL).

url
O URL ou recurso HTML da página.

Nome do mapa
Especifica a página cuja URL é a URL. Isto corresponde ao mapName na macro BEGIN_EMBED_DHTML_EVENT_MAP que mapeia eventos desta página.

Observações

Se a página for um recurso HTML, o url deve ser a representação em cadeia do número ID do recurso (ou seja, "123", e não 123 ou ID_HTMLRES1).

O identificador de página, mapName, é um símbolo arbitrário usado para ligar mapas de eventos DHTML incorporados a mapas de entrada de eventos de URL. Está limitado em âmbito ao DHTML e ao mapa de eventos URL.

Example

Veja o exemplo em BEGIN_DHTML_URL_EVENT_MAP.

Requerimentos

Cabeçalho afxdhtml.h

END_DHTML_EVENT_MAP_INLINE

Marca o fim do mapa de eventos DHTML.

Sintaxe

END_DHTML_EVENT_MAP_INLINE( )

Observações

Deve ser usado em conjunto com BEGIN_DHTML_EVENT_MAP_INLINE.

Requerimentos

Cabeçalho: afxdhtml.h

Consulte também

Macros e Globais