Called for each Command specified in the Windows Ribbon (Ribbon) framework markup to bind the Command to an IUICommandHandler.

Syntax

HRESULT OnCreateUICommand(      
    UINT32 commandId,
    UI_COMMANDTYPE typeID,
    IUICommandHandler **commandHandler
);

Parameters

commandId

[in]  The ID for the Command, which is specified in the markup resource file.

typeID

[in]  The Command type that is associated with a specific control.

commandHandler

[out]  When this method returns, contains the address of a pointer to an IUICommandHandler object. This object is a host application Command handler that is bound to one or more Commands.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This callback notification is sent by the Ribbon framework to the host application for each Command declaration encountered while processing the markup resource file.

For each Command specified in the Ribbon markup, the Ribbon framework requires a Command handler in the host application. A new or existing handler must be assigned to each Command.

Example

The following example demonstrates a basic implementation of the IUIApplication::OnCreateUICommand method.

//
//  FUNCTION: OnCreateUICommand(UINT, UI_COMMANDTYPE, IUICommandHandler)
//
//  PURPOSE: Called by the Ribbon framework for each command specified in markup to allow
//           the host application to bind a command handler to that command.
//
//  PARAMETERS:    
//                nCmdID - The Command identifier. 
//                typeID - The Command type. 
//                ppCommandHandler - Pointer to the address of the Command handler. 
//
//  COMMENTS:
//
//    For this sample, return the same command handler for all commands
//    specified in the .xml file.
//    
//
STDMETHODIMP CApplication::OnCreateUICommand(
    UINT nCmdID,
    UI_COMMANDTYPE typeID,
    IUICommandHandler** ppCommandHandler)
{
    HRESULT hr = E_NOTIMPL;

    switch(typeID)
    {
        case UI_COMMANDTYPE_DECIMAL:
            {
                _cwprintf(L"IUIApplication::OnCreateUICommand called for Spinner.\r\n");
                hr = _spSpinnerSite->QueryInterface(IID_PPV_ARGS(ppCommandHandler));
                break;
            }
        default:
            {
                _cwprintf(L"IUIApplication::OnCreateUICommand called with CmdID=%u, typeID=%u.\r\n", nCmdID, typeID);
                hr = _spCommandHandler->QueryInterface(IID_PPV_ARGS(ppCommandHandler));
            }
    }    
    return hr;
}

See Also

Windows Ribbon Framework Samples