M

FamilyUtils.ConvertFamilyToFaceHostBased

Description:
Converts a family to be face host based.

Remarks:
Converts a family hosted by some element other than a face to be hosted by a face. This is done by replacing the existing host (wall, roof, ceiling, floor) with a face. Conversion can succeed only if FamilyUtils.FamilyCanConvertToFaceHostBased() returns true.

public static void ConvertFamilyToFaceHostBased(
	Document document,
	ElementId familyId
)

Public Shared Sub ConvertFamilyToFaceHostBased ( _
	document As Document, _
	familyId As ElementId _
)

public:
static void ConvertFamilyToFaceHostBased(
	Document^ document, 
	ElementId^ familyId
)

Autodesk.Revit.DB.Document

document

The document containing the family to be converted.
Autodesk.Revit.DB.ElementId

familyId

The family id.

Autodesk.Revit.Exceptions.ArgumentException

The input familyId cannot be converted to face host based.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was NULL
Autodesk.Revit.Exceptions.InvalidOperationException

Failed to convert the family to face host based. -or- The family is already unhosted.