IUIFramework::LoadUI メソッド (uiribbon.h)

[アーティクル]
03/13/2024

Windows リボンフレームワーク UI リソースまたはコンパイル済みマークアップファイルを読み込みます。

構文

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

パラメーター

[in] instance

種類: HINSTANCE

リボンアプリケーションインスタンスへのハンドル。

[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