•  

AddControl Method

Creates an in-canvas control.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 22.0.0.0 (22.1.0.0)
Since: 2022

Syntax

C# 
public int AddControl(
	InCanvasControlData data,
	ElementId ownerViewId
)
Visual Basic 
Public Function AddControl ( _
	data As InCanvasControlData, _
	ownerViewId As ElementId _
) As Integer
Visual C++ 
public:
int AddControl(
	InCanvasControlData^ data, 
	ElementId^ ownerViewId
)

Parameters

data
Type: Autodesk.Revit.DB InCanvasControlData
Data to generate in-canvas control appearance.
ownerViewId
Type: Autodesk.Revit.DB ElementId
The view in which the control appears. It will show in all views if the id is invalidElementId.

Return Value

Unique index of control for future references.

Remarks

This method can perform drawing an image (supplied by the caller) as an in-canvas control in the view(s). The control can react on click by invoking a callback defined in [!:Autodesk::Revit::UI::ITemporaryGraphicsHandler::OnClick(TemporaryGraphicsCommandData)] . The caller can use the returned index to update the control (changing image/location), delete and change visibility (hide/unhide) in response to any events later.

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException The ownerViewId provided is not an id of a view.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was null
Autodesk.Revit.Exceptions InvalidOperationException Failed to load the image from specified path.

See Also