Método IUIFramework::LoadUI (uiribbon.h)

Artículo
03/13/2024

Carga el recurso de interfaz de usuario del marco de la cinta de opciones de Windows, o el marcado compilado, el archivo .

Sintaxis

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

Parámetros

[in] instance

Tipo: HINSTANCE

Identificador de la instancia de aplicación de cinta de opciones.

[in] resourceName

Tipo: LPCWSTR

Nombre del recurso que contiene el marcado binario compilado.

Nota Para inicializar correctamente la cinta de opciones, un archivo de marcado de cinta compilado debe estar disponible como un recurso. Este archivo de marcado es un componente integral del marco de la cinta de opciones; especifica los controles que se van a usar y su diseño.

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

Se debe llamar a IUIFramework::LoadUI tras la inicialización. Se puede llamar a este método varias veces durante el ciclo de vida de una aplicación, por ejemplo, para mostrar u ocultar una cinta de opciones, siempre que se llame a IUIFramework::D estroy entre.

Se llama a OnCreateUICommand y OnViewChanged durante la ejecución de IUIFramework::LoadUI.

Ejemplos

En el ejemplo siguiente se muestra una función básica de inicialización del marco.

//
//  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;
}

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