IUIApplication interface (Windows)

Switch View :
Classic
Lightweight
ScriptFree
IUIApplication interface

Applies to: desktop apps only

The IUIApplication interface is implemented by the application and defines the callback entry-point methods for the Windows Ribbon framework.

Members

The IUIApplication interface inherits from the IUnknown interface. IUIApplication also has these types of members:

Methods

The IUIApplication interface has these methods.

MethodDescription
IUIApplication::OnCreateUICommand

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

IUIApplication::OnDestroyUICommand

Called for each Command specified in the Ribbon framework markup when the application window is destroyed.

IUIApplication::OnViewChanged

Called when the state of a View changes.

 

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008

Header
Uiribbon.h

IDL
Uiribbon.idl

DLL
Uiribbon.dll

See also

Windows Ribbon Framework Samples

 

 

Send comments about this topic to Microsoft

Build date: 2/15/2012

Community Content

Arik Poznanski
C# Syntax 
// Application callback interface
[ComImport]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("D428903C-729A-491d-910D-682A08FF2522")]
public interface IUIApplication
{
    // A view has changed
    [PreserveSig]
    HRESULT OnViewChanged(UInt32 viewId, 
                          UI_ViewType typeID,
                          [MarshalAs(UnmanagedType.Interface)] object view,
                          UI_ViewVerb verb,
                          int uReasonCode);

    // Command creation callback
    [PreserveSig]
    HRESULT OnCreateUICommand(UInt32 commandId,
                              UI_CommandType typeID,
                              [Out, MarshalAs(UnmanagedType.Interface)] out IUICommandHandler commandHandler);


    // Command destroy callback
    [PreserveSig]
    HRESULT OnDestroyUICommand(UInt32 commandId,
                               UI_CommandType typeID,
                               [MarshalAs(UnmanagedType.Interface)] IUICommandHandler commandHandler);
}