Ribbon Development Introductory Tutorial

This tutorial and accompanying code samples are intended for C++ developers who develop desktop applications and want to take advantage of the Windows Ribbon framework. The tutorial steps you through adding an empty Ribbon to a small application, adding controls with icons, labels, and other resources to the Ribbon, and then connecting the controls to the existing command infrastructure of the application. You learn how the API maintains separation between control organization and event handling. Finally, the tutorial demonstrates how to specify layouts and resizing behavior to show how the Ribbon adapts and performs at different sizes. When you finish, you will have performed all the steps to add and customize a basic Ribbon application.


The Ribbon Development Introductory Tutorial sample can be downloaded as a standalone Microsoft Visual Studio project from the Microsoft Download Center.

Building the Sample

Download the sample to your hard disk.

Install the Windows Software Development Kit (SDK) for Windows 7 and open its build environment command window. On the Start menu, point to All Programs, Microsoft Windows SDK, and then click CMD Shell.

To build the sample from the build environment command window, go to the source directory of the sample. At the command prompt, type MSBUILD.

To build the sample in Microsoft Visual Studio, load the sample solution or project file and then press CTRL+SHIFT+B.

Running the Sample

To run the sample from the build environment command window, execute the .exe files in the Bin\Debug or Bin\Release folder contained in the sample source folder.

To run the compiled sample with debugging in Visual Studio, press F5.


The Windows Ribbon Development Forum is available to discuss topics and ask questions related to developing Windows Ribbon applications.

Minimum Requirements

Minimum supported client

Windows 7

Windows Vista with Service Pack 2 (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

Windows SDK 7.0
Visual Studio 2005
Header and IDL files uiribbon.h, uiribbon.idl


Note  The Platform Update for Windows Vista and Platform Update for Windows Server 2008 are sets of run-time libraries that enable developers to target Windows Ribbon applications to both Windows Vista and Windows Server 2008. The platform updates will be available to all Windows Vista and Windows Server 2008 customers through Windows Update. Third-party applications that require Platform Update for Windows Vista or Platform Update for Windows Server 2008 can have Windows Update detect whether the required updated is installed; if it is not, Windows Update will download and install it in the background.



Community Additions