Revit 2025 API
UIControlled |
Create a new RibbonPanel on the Add-Ins tab.
Namespace: Autodesk.Revit.UI
Assembly: RevitAPIUI (in RevitAPIUI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntax
public virtual RibbonPanel CreateRibbonPanel( string panelName )
Public Overridable Function CreateRibbonPanel ( panelName As String ) As RibbonPanel
public: virtual RibbonPanel^ CreateRibbonPanel( String^ panelName )
abstract CreateRibbonPanel : panelName : string -> RibbonPanel override CreateRibbonPanel : panelName : string -> RibbonPanel
Parameters
- panelName String
- The name of the panel to be created.
Return Value
RibbonPanel
Exceptions| Exception | Condition |
|---|---|
| ArgumentNullException | panelName is . |
| ArgumentException | panelName is Empty. |
| InvalidOperationException | If more than 100 panels were created. |
Remarks This method will create a custom panel appending to the Revit AddIns tab. This method is not supported in Macros.
Examplepublic Result OnStartup(UIControlledApplication application) { // add new ribbon panel RibbonPanel ribbonPanel = application.CreateRibbonPanel("NewRibbonPanel"); //Create a push button in the ribbon panel “NewRibbonPanel” //the add-in application “HelloWorld” will be triggered when button is pushed PushButton pushButton = ribbonPanel.AddItem(new PushButtonData("HelloWorld", "HelloWorld", @"D:\HelloWorld.dll", "HelloWorld.CsHelloWorld")) as PushButton; // Set the large image shown on button Uri uriImage = new Uri(@"D:\Sample\HelloWorld\bin\Debug\39-Globe_32x32.png"); BitmapImage largeImage = new BitmapImage(uriImage); pushButton.LargeImage = largeImage; return Result.Succeeded; }
Public Function OnStartup(application As UIControlledApplication) As Autodesk.Revit.UI.Result Implements IExternalApplication.OnStartup ' add new ribbon panel Dim ribbonPanel As RibbonPanel = application.CreateRibbonPanel("NewRibbonPanel") 'Create a push button in the ribbon panel “NewRibbonPanel” 'the add-in application “HelloWorld” will be triggered when button is pushed Dim pushButton As PushButton = TryCast(ribbonPanel.AddItem(New PushButtonData("HelloWorld", "HelloWorld", "D:\HelloWorld.dll", "HelloWorld.CsHelloWorld")), PushButton) ' Set the large image shown on button Dim uriImage As New Uri("D:\Sample\HelloWorld\bin\Debug\39-Globe_32x32.png") Dim largeImage As New BitmapImage(uriImage) pushButton.LargeImage = largeImage Return Result.Succeeded End Function
No code example is currently available or this language may not be supported.
No code example is currently available or this language may not be supported.
See Also