Метод IUIApplication::OnDeкистрацияUICommand (uiribbon.h)
Вызывается для каждой команды, указанной в разметке платформы ленты Windows при уничтожении окна приложения.
Синтаксис
HRESULT OnDestroyUICommand(
[in] UINT32 commandId,
[in] UI_COMMANDTYPE typeID,
[in, optional] IUICommandHandler *commandHandler
);
Параметры
[in] commandId
Тип: UINT32
Идентификатор команды, указанный в файле ресурсов разметки.
[in] typeID
Тип: UI_COMMANDTYPE
Тип команды, связанный с определенным элементом управления.
[in, optional] commandHandler
Тип: IUICommandHandler*
Указатель на объект IUICommandHandler . Это значение может иметь значение NULL.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Это уведомление обратного вызова отправляется платформой ленты в ведущему приложению для каждого объявления Command в файле ресурсов разметки.
Все ресурсы в ведущем приложении, связанные с каждой командой, освобождаются.
Примеры
В следующем примере демонстрируется базовая реализация метода IUIApplication::OnDetiesUICommand .
//
// 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;
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | uiribbon.h |
| DLL | Mshtml.dll |