Compartilhar via

Método IUIApplication::OnDestroyUICommand (uiribbon.h)

  • Artigo

Chamado para cada Comando especificado na marcação da estrutura da Faixa de Opções do Windows quando a janela do aplicativo é destruída.

Sintaxe

HRESULT OnDestroyUICommand(
  [in]           UINT32            commandId,
  [in]           UI_COMMANDTYPE    typeID,
  [in, optional] IUICommandHandler *commandHandler
);

Parâmetros

[in] commandId

Tipo: UINT32

A ID do Comando, que é especificada no arquivo de recurso de marcação.

[in] typeID

Tipo: UI_COMMANDTYPE

O tipo de comando associado a um controle específico.

[in, optional] commandHandler

Tipo: IUICommandHandler*

Um ponteiro para um objeto IUICommandHandler . Esse valor pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa notificação de retorno de chamada é enviada pela estrutura da Faixa de Opções para o aplicativo host para cada declaração command no arquivo de recurso de marcação.

Todos os recursos no aplicativo host associados a cada Comando são liberados.

Exemplos

O exemplo a seguir demonstra uma implementação básica do método IUIApplication::OnDestroyUICommand .

//
//  FUNCTION:    OnDestroyUICommand(UINT, UI_COMMANDTYPE, IUICommandHandler*)
//
//  PURPOSE:    Called for each Command specified in the Ribbon markup 
//                when the Ribbon host application window is destroyed.
//
//  PARAMETERS:    
//                nCmdID - The Command identifier. 
//                typeID - The Command type. 
//                commandHandler - The Command handler. 
//
//  COMMENTS:
//
//
STDMETHODIMP CApplication::OnDestroyUICommand(
    UINT32 nCmdID,
    UI_COMMANDTYPE typeID,
    IUICommandHandler* commandHandler)
{
    return E_NOTIMPL;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiribbon.h
DLL Mshtml.dll

Confira também

IUIApplication

Exemplos da Estrutura da Faixa de Opções do Windows