IUIFramework::LoadUI 메서드(uiribbon.h)

아티클
03/03/2024

Windows 리본 프레임워크 UI 리소스 또는 컴파일된 태그 파일을 로드합니다.

구문

HRESULT LoadUI(
  [in] HINSTANCE instance,
  [in] LPCWSTR   resourceName
);

매개 변수

[in] instance

형식: HINSTANCE

리본 애플리케이션 instance 대한 핸들입니다.

[in] resourceName

형식: LPCWSTR

컴파일된 이진 태그를 포함하는 리소스의 이름입니다.

참고 리본을 성공적으로 초기화하려면 컴파일된 리본 태그 파일을 리소스로 사용할 수 있어야 합니다. 이 태그 파일은 리본 프레임워크의 정수 구성 요소입니다. 사용할 컨트롤과 레이아웃을 지정합니다.

반환 값

형식: HRESULT

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

설명

초기화 시 IUIFramework::LoadUI를 호출해야 합니다. 이 메서드는 애플리케이션의 수명 주기 동안 여러 번 호출할 수 있습니다(예: IUIFramework::D estroy 가 사이에 호출된 경우 리본을 표시하거나 숨기려면).

OnCreateUICommand 및 OnViewChanged 는 IUIFramework::LoadUI를 실행하는 동안 호출됩니다.

예제

다음 예제에서는 기본 프레임워크 초기화 함수를 보여 줍니다.

//
//  FUNCTION:    InitializeFramework(HWND)
//
//  PURPOSE:    Initialize the Ribbon framework and bind a Ribbon to the application.
//
//  PARAMETERS:    
//                hWnd - Handle to the Ribbon host application window. 
//
//  COMMENTS:
//
//    In order to get a Ribbon to display, the Ribbon framework must be initialized. 
//    This involves three important steps:
//      1) Instantiate the Ribbon framework object (CLSID_UIRibbonFramework).
//      2) Pass the host HWND and IUIApplication object to the framework.
//      3) Load the binary markup compiled by the UI Command Compiler (UICC.exe).
//
//
bool InitializeFramework(HWND hWnd)
{
    // Instantiate the Ribbon framework object.
    HRESULT hr = CoCreateInstance(
        CLSID_UIRibbonFramework, 
        NULL, 
        CLSCTX_INPROC_SERVER, 
        IID_PPV_ARGS(&g_pFramework));
    if (!SUCCEEDED(hr))
    {
        return false;
    }    

    // Create the application object (IUIApplication) and call the 
    // framework Initialize method, passing the application object and the 
    // host HWND that the Ribbon will attach itself to.
    CComObject<CApplication> *pApplication = NULL;
    CComObject<CApplication>::CreateInstance(&pApplication);
    hr = pApplication->QueryInterface(&g_pApplication);
    if (!SUCCEEDED(hr))
    {
        return false;
    } 

    hr = g_pFramework->Initialize(hWnd, g_pApplication);
    if (!SUCCEEDED(hr))
    {
        return false;
    }

    // Load the binary markup.  
    // Initiate callbacks to the IUIApplication object that was 
    // provided to the framework earlier and bind command handler(s) 
    // to individual commands.
    hr = g_pFramework->LoadUI(GetModuleHandle(NULL), L"APPLICATION_RIBBON");
    if (!SUCCEEDED(hr))
    {
        return false;
    }
    return true;
}

요구 사항

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