topic Ribbon Panel Caption Button in Revit API Forum

Ribbon Panel Caption Button

Zoltan.Ferenczy — Mon, 02 Mar 2020 17:24:11 GMT

Is it possible to create a caption button on a custom ribbon panel? The caption button is the little arrow in the corner that usually opens a settings dialog related to the commands on the panel. I don't see any way to do it through the API.

Re: Ribbon Panel Caption Button

Kennan.Chen — Tue, 03 Mar 2020 01:17:59 GMT

You can make use of some APIs defined in AdWindows.dll which you can easily find in Revit root folder.

Everything starts from getting the RibbonControl instance by calling Autodesk.Revit.Windows.ComponentManager.Ribbon property.

You need to create the RibbonTab and RibbonPanel in AdWindows way, then organize then in the RibbonControl instance.

When the RibbonPanel is created, you can set a RibbonButton to RibbonPanel.Source.DialogLauncher property to create the caption button. The RibbonButton will respond to UI click event by calling its CommandHandler command.

That's it!

Re: Ribbon Panel Caption Button

Zoltan.Ferenczy — Tue, 03 Mar 2020 18:56:53 GMT

In The CommandHandler of buttons created using the AdWindows API, how does one get access to the ExternalCommandData in the ICommnand implementation? Or, How does one call an IExternalCommand's Execute method?

Buttons created in this way are not like buttons created with the Autodesk.Revit.UI classes.

Re: Ribbon Panel Caption Button

Kennan.Chen — Wed, 04 Mar 2020 00:06:33 GMT

Simply pass the Application object via constructor

Re: Ribbon Panel Caption Button

Kennan.Chen — Thu, 05 Mar 2020 11:47:33 GMT

If you create a RibbonButton in AdWindows way(WPF way more specifically), you gain much more freedom to manipulate the Button. A RibbonButton provides a CommandHandler property. You can assign an instance implementing ICommand interface to that property, which will enable the RibbonButton to react to the UI click event. In that ICommand implementation, you can raise a predefinded ExternalEvent to run Revit API code. Alternatively you can adopt Revit.Async library to run Revit API directly. You can access this library on nuget or source code on github.com.

Re: Ribbon Panel Caption Button

PYTHINKS — Fri, 28 Mar 2025 06:48:35 GMT

Hello ! Can you give me a sample code?

Re: Ribbon Panel Caption Button

ricaun — Fri, 28 Mar 2025 13:57:08 GMT

I add that in my ricaun.Revit.UI library:

Autodesk.Revit.UI.PushButton pushButton; ribbonPanel.SetDialogLauncher(pushButton);

Here is video about that:

See yaa

Re: Ribbon Panel Caption Button

PYTHINKS — Mon, 31 Mar 2025 01:21:24 GMT

Thanks Ricaun, it helped me