Compartilhar via


Controles ActiveX do MFC: adicionando métodos de estoque

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua sendo suportada. No entanto, não estamos mais adicionando recursos ou atualizando a documentação.

Um método de estoque difere de um método personalizado, pois ele já é implementado pela classe COleControl. Por exemplo, COleControl contém uma função de membro predefinida que dá suporte ao método Refresh para seu controle. A entrada do mapa de expedição para esse método de estoque é DISP_STOCKFUNC_REFRESH.

Importante

O ActiveX é uma tecnologia herdada que não deve ser usada para o novo desenvolvimento. Para obter mais informações sobre tecnologias modernas que substituem o ActiveX, consulte Controles ActiveX.

COleControl dá suporte a dois métodos padrão: DoClick e Refresh. A atualização é invocada pelo usuário do controle para atualizar imediatamente a aparência do controle; O DoClick é invocado para disparar o evento Click do controle.

Método Entrada do mapa de expedição Comentário
DoClick DISP_STOCKPROP_DOCLICK( ) Dispara um evento Clique.
Refresh DISP_STOCKPROP_REFRESH( ) Atualiza imediatamente a aparência do controle.

Adicionando um Método de Estoque usando o Assistente de Adição de Método

Adicionar um método de estoque é simples usando o Assistente para Adicionar Método. O procedimento a seguir demonstra a adição do método Refresh a um controle criado usando o Assistente de Controle ActiveX do MFC.

Para adicionar o método de estoque Refresh usando o Assistente de adição de método

  1. Carregue o projeto do controle.

  2. No Modo de Exibição de Classe, expanda o nó de biblioteca do controle.

  3. Clique com o botão direito do mouse no nó de interface do controle (o segundo nó do nó da biblioteca) para abrir o menu de atalho.

  4. No menu de atalho, clique em Adicionar e clique em Adicionar Método.

    Isso abrirá o Assistente para adicionar evento.

  5. Na caixa Nome do Método , clique em Atualizar.

  6. Clique em Concluir.

Adicionar alterações do Assistente de Método para Métodos de Estoque

Como o método de atualização de estoque é compatível com a classe base do controle, o Assistente para Adicionar Método não altera a declaração de classe do controle de forma alguma. Ele adiciona uma entrada para o método ao mapa de despacho do controle e ao seu arquivo .IDL. A linha a seguir é adicionada ao mapa de expedição do controle, localizado em seu arquivo de implementação (.CPP):

DISP_STOCKFUNC_REFRESH()

Isso disponibiliza o método Refresh para os usuários do controle.

A seguinte linha é adicionada ao arquivo .IDL do controle:

[id(DISPID_REFRESH), helpstring("method Refresh")] void Refresh(void);

Essa linha atribui ao método Refresh um número de ID específico.

Consulte também

Controles MFC ActiveX