Compartilhar via


COleClientItem::ativar

Chamar esta função para executar o verbo especificado em vez de DoVerb para que você possa fazer seu próprio processamento quando uma exceção é lançada.

void Activate(
   LONG nVerb,
   CView* pView,
   LPMSG lpMsg = NULL 
);

Parâmetros

  • nVerb
    Especifica o verbo a ser executado.Pode ser uma das seguintes opções:

    Valor

    Significado

    Símbolo

    – 0

    Verbo primário

    OLEIVERB_PRIMARY

    – 1

    Verbo secundário

    (Nenhum)

    – 1

    exibição de itens para edição

    OLEIVERB_SHOW

    – 2

    edição item na janela separada

    OLEIVERB_OPEN

    – 3

    Ocultar item

    OLEIVERB_HIDE

    O valor – 1 geralmente é um alias para outro verbo.Se não houver suporte para edição aberta, – 2 tem o mesmo efeito que – 1.Para obter valores adicionais, consulte IOleObject::DoVerb in the Windows SDK.

  • pView
    Ponteiro para a janela de visualização de contêiner que contém o item OLE; isso é usado pelo aplicativo servidor para ativação in-loco.Esse parâmetro deve ser NULO se o contêiner não oferecer suporte a ativação in-loco.

  • lpMsg
    Ponteiro para a mensagem que provocou o item a ser ativado.

Comentários

Se o aplicativo do servidor foi escrito usando a biblioteca Microsoft Foundation classe, essa função faz com que o OnDoVerb função de membro do correspondenteCOleServerItem objeto a ser executado.

Se o verbo primário é edição e zero será especificado no nVerb parâmetro, o aplicativo de servidor é iniciado para permitir que o item OLE seja editada. Se o aplicativo de contêiner oferece suporte a ativação in-loco, a edição pode ser concluído no lugar.Se o contêiner não oferecer suporte a ativação no local (ou se for especificado, o verbo em em aberto), o servidor é iniciado em uma janela separada e edição pode ser concluído lá.Normalmente, quando o usuário do aplicativo contêiner clica duas vezes no item OLE, o valor para o verbo primário no nVerb parâmetro determina a ação que o usuário pode executar. No entanto, se o servidor oferece suporte a apenas uma ação, ele terá essa ação, independentemente de qual valor é especificado no nVerb parâmetro.

Para obter mais informações, consulte IOleObject::DoVerb in the Windows SDK.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe COleClientItem

Gráfico de hierarquia

COleClientItem::DoVerb

COleServerItem::OnDoVerb

Outros recursos

COleClientItem membros