M

Document.NewRoomTag

Description:
Creates a new RoomTag referencing a room in the host model or in a Revit link.

public RoomTag NewRoomTag(
	LinkElementId roomId,
	UV point,
	ElementId viewId
)

Public Function NewRoomTag ( 
	roomId As LinkElementId,
	point As UV,
	viewId As ElementId
) As RoomTag

public:
RoomTag^ NewRoomTag(
	LinkElementId^ roomId, 
	UV^ point, 
	ElementId^ viewId
)

member NewRoomTag : 
        roomId : LinkElementId * 
        point : UV * 
        viewId : ElementId -> RoomTag

LinkElementId

roomId

The HostOrLinkElementId of the Room.
UV

point

A 2D point that defines the tag location on the level of the room.
ElementId

viewId

The id of the view where the tag will be shown. If null and the room in not in a Revit link, the view of the room will be used.

Return Value RoomTag If successful a RoomTag object will be returned, otherwise .

RoomTag CreateRoomTag(Autodesk.Revit.DB.Document document, Room room)
{
    // Create a UV structure which determine the room tag location
   UV roomTagLocation = new UV(0, 0); 

    // Create a new room tag in the created room
    LinkElementId roomId = new LinkElementId(room.Id);
    RoomTag roomTag = document.Create.NewRoomTag(roomId, roomTagLocation, ElementId.InvalidElementId);
    if (null == roomTag)
    {
        throw new Exception("Create a new room tag failed.");
    }

    // Give the user some information
    TaskDialog.Show("Revit","Room tag created successfully.");

    return roomTag;
}

Private Function CreateRoomTag(document As Autodesk.Revit.DB.Document, room As Room) As RoomTag
    ' Create a UV structure which determine the room tag location
    Dim roomTagLocation As New UV(0, 0)

    ' Create a new room tag in the created room
    Dim roomId As New LinkElementId(room.Id)
    Dim roomTag As RoomTag = document.Create.NewRoomTag(roomId, roomTagLocation, ElementId.InvalidElementId)
    If roomTag Is Nothing Then
        Throw New Exception("Create a new room tag failed.")
    End If

    ' Give the user some information
    TaskDialog.Show("Revit", "Room tag created successfully.")

    Return roomTag
End Function

ArgumentException

viewId is not associated with a plan view or section view.
InvalidOperationException

viewId is null and the room is in a linked file.