Classe COleCmdUI

Implementa um método para o MFC atualizar o estado dos objetos da interface de utilizador relacionados com as IOleCommandTargetfuncionalidades orientadas pela sua aplicação.

Sintaxe

class COleCmdUI : public CCmdUI

Membros

Construtores Públicos

Métodos Públicos

Observações

Numa aplicação que não está ativada para DocObjects, quando o utilizador visualiza um menu na aplicação, o MFC processa UPDATE_COMMAND_UI notificações. Cada notificação recebe um objeto CCmdUI que pode ser manipulado para refletir o estado de um determinado comando. No entanto, quando a sua aplicação está ativada para DocObjects, o MFC processa notificações UPDATE_OLE_COMMAND_UI e atribui COleCmdUI objetos.

COleCmdUI permite que um DocObject receba comandos que têm origem na interface do seu contentor (como FileNew, Open, Print, etc.), e permite que um contentor receba comandos que têm origem na interface do DocObject. Embora IDispatch possa ser usado para despachar os mesmos comandos, IOleCommandTarget oferece uma forma mais simples de consultar e executar porque depende de um conjunto padrão de comandos, geralmente sem argumentos, e sem informação de tipo envolvida. COleCmdUI podem ser usados para ativar, atualizar e definir outras propriedades dos comandos da interface de utilizador do DocObject. Quando quiseres invocar o comando, liga para o COleServerDoc::OnExecOleCmd.

Para mais informações sobre DocObjects, veja CDocObjectServer e CDocObjectServerItem.

Hierarquia de herança

CCmdUI

COleCmdUI

Requerimentos

Cabeçalho: afxdocob.h

COleCmdUI::COleCmdUI

Constrói um COleCmdUI objeto associado a um comando de interface de utilizador específico.

COleCmdUI(
    OLECMD* rgCmds,
    ULONG cCmds,
    const GUID* m_pGroup);

Parâmetros

rgCmds
Uma lista de comandos suportados associados ao GUID dado. A OLECMD estrutura associa comandos a flags de comando.

cCmds
A contagem de comandos no rgCmds.

pGroup
Um apontador para um GUID que identifica um conjunto de comandos.

Observações

O COleCmdUI objeto fornece uma interface programática para atualizar objetos da interface de utilizador do DocObject, como itens de menu ou botões da barra de controlo. Os objetos da interface de utilizador podem ser ativados, desativados, verificados e/ou limpos através do COleCmdUI objeto.

COleCmdUI::Enable

Chame esta função para definir a flag de comando do COleCmdUI objeto para OLECOMDF_ENABLED, o que indica à interface que o comando está disponível e ativado, ou para limpar a flag de comando.

virtual void Enable(BOOL bOn);

Parâmetros

bOn
Indica se o comando associado ao COleCmdUI objeto deve ser ativado ou desativado. O não-zero ativa o comando; 0 desativa o comando.

COleCmdUI::SetCheck

Chame esta função para definir o estado de um comando de ativa/desligamento.

virtual void SetCheck(int nCheck);

Parâmetros

nCheck
Um valor que determina o estado a definir um comando de ativa/desligança. Os valores são:

COleCmdUI::SetText

Chame esta função para devolver um nome de texto ou uma cadeia de estado para um comando.

virtual void SetText(LPCTSTR lpszText);

Parâmetros

lpszText
Um ponteiro para o texto a ser usado com o comando.

Consulte também

Classe CCmdUI
Gráfico de Hierarquia