PlaceAsTap Method


Places the part by its connector to a specific position on the straight part at the specified distance from the host part connector.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 16.0.0.0 (16.0.0.0)
Since: 2016

Syntax

C#
public static void PlaceAsTap(
	Document doc,
	Connector tapPartConn,
	Connector hostPartConn,
	double distance,
	double axisRotation,
	double secondaryAxisRotation
)
Visual Basic
Public Shared Sub PlaceAsTap ( _
	doc As Document, _
	tapPartConn As Connector, _
	hostPartConn As Connector, _
	distance As Double, _
	axisRotation As Double, _
	secondaryAxisRotation As Double _
)
Visual C++
public:
static void PlaceAsTap(
	Document^ doc, 
	Connector^ tapPartConn, 
	Connector^ hostPartConn, 
	double distance, 
	double axisRotation, 
	double secondaryAxisRotation
)

Parameters

doc
Type: Autodesk.Revit.DB Document
The document.
tapPartConn
Type: Autodesk.Revit.DB Connector
The connector of the part to place.
hostPartConn
Type: Autodesk.Revit.DB Connector
The connector of host part.
distance
Type: System Double
The distance to host part connector where to place the part.
axisRotation
Type: System Double
The axis rotation in radians.
secondaryAxisRotation
Type: System Double
The secondary axis rotation in radians.

Remarks

Tap cannot be placed if it is already connected.

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException It is not a valid part to place as tap. -or- Tap should be placed on straight part. -or- The distance is out of range. -or- For rectangular and oval parts the axis rotation must be a multiple of PI/2. -or- Invalid tap for host's profile type. -or- The fabrication part is connected.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was NULL
Autodesk.Revit.Exceptions InvalidOperationException tap is not connected by its primary connector.
[!:Autodesk::Revit::Exceptions::InvalidOpertationException] tap does not fit on the host.

See Also

ArchiLabs

Stop fighting Revit automation.

Build repeatable BIM design and documentation workflows with scripts, data, and AI in one place, without wrestling brittle one-off automations.

Try ArchiLabs →