GetTargetHostFaceAndTransform Method


Returns the face to which the RebarConstraint is attached associated to the given target index. The RebarConstraintType of the RebarConstraint must be 'FixedDistanceToHostFace' or 'ToCover.'

Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since:  2018

Syntax

C#
public Face GetTargetHostFaceAndTransform(
	int targetIndex,
	Transform faceTransform
)
Visual Basic
Public Function GetTargetHostFaceAndTransform ( _
	targetIndex As Integer, _
	faceTransform As Transform _
) As Face
Visual C++
public:
Face^ GetTargetHostFaceAndTransform(
	int targetIndex, 
	Transform^ faceTransform
)

Parameters

targetIndex
Type: SystemInt32
The index of the target. Should be between 0 and NumberOfTargets().
faceTransform
Type: Autodesk.Revit.DBTransform
Returns the transform that is associated to the face's element geometry.

Return Value

Requested Face.

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentException targetIndex is out of range.
Autodesk.Revit.ExceptionsArgumentNullException A non-optional argument was null
Autodesk.Revit.ExceptionsInvalidOperationException RebarConstraint is no longer valid. -or- The RebarConstraint is not of RebarConstraintType 'FixedDistanceToHostFace' or 'ToCover.'

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 →