RibbonFrame Example
===================
This project demonstrates how to add a ribbon to a Frame window. The ribbon
buttons are defined in an Ribbon.xml. This application adds a ribbon to the
Scribble sample. The ribbon is only supported on Windows 7 OS (and above). If
the ribbon isn't supported by the operating system, the traditional menu and 
toolbar are displayed instead. 

How it works
============
Microsoft's RibbonUI framework uses COM to implement the ribbon. The COM 
interfaces involved are IUIApplication and IUICommandHandler. The Win32++ 
CRibbon class inherits from both IUIApplication and IUICommandHandler. 

To add a ribbon to your frame, inherit CMainFrame from CRibbonFrame, and add
the Ribbon.xml file containing the definitions for your ribbon to the project. 
CRibbonFrame inherits from both CFrame and and CRibbon. To create and
interact with the ribbon, we override the relevant functions from both 
IUIApplication and IUICommandHandler.

The functions you may wish to override are:
IUIApplication::OnCreateUICommand 
  Called for each Command specified in the Ribbon markup to bind the Command 
  to an IUICommandHandler.  
IUIApplication::OnDestroyUICommand 
  Called for each Command specified in the Ribbon markup when the Ribbon host 
  application window is destroyed.  
IUIApplication::OnViewChanged 
  Called when the state of a View changes.
IUICommandHandler::Execute 
  Executes or previews the Commands bound to the Command handler.  
IUICommandHandler::UpdateProperty
  Sets a property value for a bound Command, for example, setting a Command to 
  enabled or disabled depending on the state of a View.  

This example demonstratues how to override IUICommandHandler::Execute to respond
to button clicks on the ribbon, and IUICommandHandler::UpdateProperty to
configure parts of the ribbon.
  
Prerequisites:
==============
1. Windows 7 operating system
2. Microsoft Windows SDK v7.0 
3. Visual Studio 2005, 2008 or 2010 (full or Express Edition)

Compiling Instructions
======================
To compile Ribbon.xml, specify it's custom build properties as follows:

Command Line  uicc.exe ..\src\Ribbon.xml ..\src\Ribbon.bml /header:..\src\RibbonUI.h /res:..\src\RibbonUI.rc
Outputs       Ribbon.bml;RibbonUI.rc;RibbonUI.h 

Note: Ensure that the following VC++ Directories are configured:
Executables directory: 	C:\Program Files\Microsoft SDKs\Windows\v7.0\Bin
Include directory:		C:\Program Files\Microsoft SDKs\Windows\v7.0\Include