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 COleClientItem

Gráfico da hierarquia

COleClientItem::DoVerb

COleServerItem::OnDoVerb