RegisterDockablePane Method


Adds a new dockable pane to the Revit user interface.

Namespace: Autodesk.Revit.UI
Assembly: RevitAPIUI (in RevitAPIUI.dll) Version: 20.0.0.0 (20.1.1.1)
Since: 2014

Syntax

C#
public void RegisterDockablePane(
	DockablePaneId id,
	string title,
	IDockablePaneProvider provider
)
Visual Basic
Public Sub RegisterDockablePane ( _
	id As DockablePaneId, _
	title As String, _
	provider As IDockablePaneProvider _
)
Visual C++
public:
void RegisterDockablePane(
	DockablePaneId^ id, 
	String^ title, 
	IDockablePaneProvider^ provider
)

Parameters

id
Type: Autodesk.Revit.UI DockablePaneId
Unique identifier for the new pane.
title
Type: System String
String to use for the pane caption.
provider
Type: Autodesk.Revit.UI IDockablePaneProvider
Your add-in's implementation of the IDockablePaneProvider interface.

Examples

Copy C#
public Result OnStartup(UIControlledApplication application)
{
   // Create our pane provider and register it with the application
   PaneProvider prov = new PaneProvider();
   DockablePaneId id = new DockablePaneId(Guid.NewGuid());
   application.RegisterDockablePane(id, "test", prov);

   return Result.Succeeded;
}
Copy VB.NET
Public Function OnStartup(application As UIControlledApplication) As Result Implements IExternalApplication.OnStartup
    ' Create our pane provider and register it with the application
    Dim prov As New PaneProvider()
    Dim id As New DockablePaneId(Guid.NewGuid())
    application.RegisterDockablePane(id, "test", prov)

    Return Result.Succeeded
End Function

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException Thrown if a dockable pane with identifier %id% has already been registered.

See Also