How to: Add a Dialog box launcher to a Ribbon group

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

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.

Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for the following applications: Excel; InfoPath 2013 and InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. For more information, see Features available by Office application and project type.

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