Compartir a través de

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

  • Artículo

Se llama a para cada comando especificado en el marcado del marco de la cinta de Opciones de Windows cuando se destruye la ventana de la aplicación.

Sintaxis

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

Parámetros

[in] commandId

Tipo: UINT32

Identificador del comando, que se especifica en el archivo de recursos de marcado.

[in] typeID

Tipo: UI_COMMANDTYPE

Tipo de comando asociado a un control específico.

[in, optional] commandHandler

Tipo: IUICommandHandler*

Puntero a un objeto IUICommandHandler . Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El marco de la cinta envía esta notificación de devolución de llamada a la aplicación host para cada declaración command del archivo de recursos de marcado.

Se liberan todos los recursos de la aplicación host asociada a cada comando.

Ejemplos

En el ejemplo siguiente se muestra una implementación básica del 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 Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiribbon.h
Archivo DLL Mshtml.dll

Consulte también

IUIApplication

Ejemplos de Windows Ribbon Framework