How to: Add a Dialog Box Launcher to a Ribbon Group

Applies to

The information in this topic applies only to the specified Visual Studio Tools for Office projects and versions of Microsoft Office.

Project type

  • Document-level projects

  • Application-level projects

Microsoft Office version

  • Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

For more information, see Features Available by Application and Project Type.

You can add a dialog box launcher to any group on a Ribbon. A dialog box launcher is a small icon that appears in a group. Users click this icon to open related dialog boxes or task panes that provide more options that relate to the group.

To add a dialog box launcher to a Ribbon group

  1. Select the Ribbon code file (.vb or .cs file) in Solution Explorer.

  2. On the View menu, click Designer.

  3. In the Ribbon Designer, right-click any group, and then click Add DialogBoxLauncher.

    Add code to the DialogLauncherClick event of the group to open a custom or built-in dialog box.

See Also

Tasks

Ribbon Controls Sample

How to: Export a Ribbon from the Ribbon Designer to Ribbon XML

How to: Change the Order of Tabs on the Ribbon

How to: Customize a Built-in Tab

How to: Customize the Microsoft Office Menu

How to: Get Started Customizing the Ribbon

How to: Show Add-in User Interface Errors

Walkthrough: Creating a Custom Tab by Using the Ribbon Designer

Walkthrough: Updating the Controls on a Ribbon at Run Time

Walkthrough: Creating a Custom Tab by Using Ribbon XML

Concepts

Ribbon Overview

Accessing the Ribbon at Run Time

Ribbon Designer

Ribbon Object Model Overview

Ribbon XML

Customizing a Ribbon for Outlook