영어로 읽기

다음을 통해 공유


IUIApplication::OnDestroyUICommand 메서드(uiribbon.h)

애플리케이션 창이 제거될 때 Windows 리본 프레임워크 태그에 지정된 각 명령에 대해 호출됩니다.

구문

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

매개 변수

[in] commandId

형식: UINT32

태그 리소스 파일에 지정된 명령의 ID입니다.

[in] typeID

형식: UI_COMMANDTYPE

특정 컨트롤과 연결된 명령 형식 입니다.

[in, optional] commandHandler

형식: IUICommandHandler*

IUICommandHandler 개체에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 콜백 알림은 리본 프레임워크에서 태그 리소스 파일의 각 명령 선언에 대한 호스트 애플리케이션으로 전송됩니다.

각 명령과 연결된 호스트 애플리케이션의 모든 리소스가 릴리스됩니다.

예제

다음 예제에서는 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;
}

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 uiribbon.h
DLL Mshtml.dll

추가 정보

IUIApplication

Windows 리본 프레임워크 샘플