Show Contents / Index / Search

Add a Button to Run a Macro

With the UI Designer, you can add a button or other control that runs a macro or a macro-related action to the Ribbon. All supported macros, including RCL scripts and legacy macro editors, are available as actions. Legacy compatibility features must be installed for these options to appear in the Actions list. For more information, see the Reflection Administrator's Reference.

Note: The UI Designer is just one way to create controls — the Context Menu Editor, Keyboard Mapper, Mouse Mapper, and Hotspots provide other ways for you to run favorite macros and actions.

To add a button that runs a macro-related action

  1. From the Appearance tab, click UI Designer.
  2. From the Design View pane, from the Ribbon simulation, select the tab and group to which you want to add the control.

    To select a group, click the group name. Create a new group, if needed.

  3. From the Insert Controls pane, click Button.
  4. From the Settings pane, click the Select Action button.
  5. From the Action category menu, choose Macro.
  6. Select an action from the Action list.

    If you selected an action that runs a macro, specify the appropriate parameter as needed:

    To

    Specify

    Select a macro (or open a file that contains macros) each time you click the button

    Select macro when action occurs

    Specify a macro that runs automatically each time you click the button

    Select macro

  7. From the Settings pane, set the action and other properties for the new button that appears on the Ribbon.
  8. Click OK.
  9. If prompted, type a new filename for the custom ribbon and then save the file.

    The button is saved to a custom ribbon file that you can use in other session documents.

Related Topics

Select Action Dialog Box

Creating and Using Macros

Add Controls to the Ribbon