Partilhar via


COleClientItem::Activate

Chamar essa 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 para executar.Pode ser um dos seguintes:

    Valor

    Significado

    Símbolo

    – 0

    Verbo primária

    OLEIVERB_PRIMARY

    – 1

    Verbo new

    (Nenhum)

    – 1

    Item de exibição para edição

    OLEIVERB_SHOW

    – 2

    Item de edição na janela separada

    OLEIVERB_OPEN

    – 3

    Item de ocultar

    OLEIVERB_HIDE

    1 – Valor é normalmente um alias para outro verbo.Se a edição aberta não é suportada, – 2 tem o mesmo efeito que – 1.Para valores adicionais, consulte IOleObject::DoVerb em Windows SDK.

  • pView
    Ponteiro para a janela do recipiente que contém o item OLE; isso é usado pelo aplicativo para servidores para o ativação in-loco.Este parâmetro deve ser NULO se o contêiner não suporta a ativação in-loco.

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

Comentários

Se o aplicativo para servidores foi escrito usando a biblioteca de classes da Microsoft foundation, causa de essa função a função de membro de OnDoVerb do objeto correspondente de COleServerItem ser executado.

Se o verbo primária é edição e zero são especificados no parâmetro de nVerb , o aplicativo para servidores é iniciado permitir que o item seja editado OLE.Se o aplicativo de contêiner oferece suporte a ativação edição in-loco, pode ser feito no lugar.Se o recipiente não suporta a ativação in-loco (ou se o comando aberto é especificado), o servidor é iniciado em uma janela separada e edição pode ser feita lá.Normalmente, quando o usuário do aplicativo de contêiner clique duas vezes no item, OLE o valor para o verbo principal no parâmetro de nVerb determina qual ação o usuário pode executar.Em o entanto, se o servidor oferece suporte somente a uma ação, leva essa ação, não importa que o valor é especificado no parâmetro de nVerb .

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

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe de COleClientItem

Gráfico de hierarquia

COleClientItem::DoVerb

COleServerItem::OnDoVerb