Compartilhar via


COleClientItem::DoVerb

Chamada DoVerb para executar o verbo especificado.

virtual BOOL DoVerb( 
   LONG nVerb, 
   CView* pView,
   LPMSG lpMsg = NULL  
);

Parâmetros

  • nVerb
    Especifica o verbo para executar. Pode incluir um de estes procedimentos:

    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 de exibição; isso é usado pelo servidor para o ativação in-loco. Este parâmetro deve ser NULO se o aplicativo de recipiente não permite ativação in-loco.

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

Valor de retorno

Diferente de zero se o comando foi executado com êxito; se não 0.

Comentários

Essa função chama a função de membro de Ativar para executar o comando. Também captura exceções e exibe uma caixa de mensagem para o usuário se um é acionada.

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 .

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe COleClientItem

Gráfico da hierarquia

COleClientItem::Activate