Namespace: Autodesk.Revit.UI Class: UIControlledApplication

UIControlledApplication.CreateRibbonPanel(String)

Method

Description:
Create a new RibbonPanel on the Add-Ins tab.

Remarks:
This method will create a custom panel appending to the Revit AddIns tab. This method is not supported in Macros.

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

Examples

public 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

Parameters

Parameter	Type	Description
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.