M

UIDocument.PromptToPlaceElementTypeOnLegendView

Description:
Prompts the user to place an element type onto a legend view.

Remarks:
This method works only for non-annotation element types. For annotations, use PromptForFamilyInstancePlacement(Autodesk::Revit::DB::FamilySymbol) instead. This method uses its own transaction, so it's not permitted to be invoked in an active transaction. The user is not permitted to change the active legend view or during this placement operation (the operation will be cancelled). In a single invocation, the user can place multiple instances of the input element type until they finish the placement (with Cancel or ESC or a click elsewhere in the UI).

public void PromptToPlaceElementTypeOnLegendView(
	ElementType elementType
)

Public Sub PromptToPlaceElementTypeOnLegendView ( _
	elementType As ElementType _
)

public:
void PromptToPlaceElementTypeOnLegendView(
	ElementType^ elementType
)

Autodesk.Revit.DB.ElementType

elementType

The ElementType of which instances are to be placed.

Autodesk.Revit.Exceptions.ArgumentException

The input element type does not belong to a model-level category.
Autodesk.Revit.Exceptions.ArgumentNullException

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

This document is not the currently active one. -or- Starting a new transaction is not permitted. It could be because another transaction already started and has not been completed yet, or the document is in a state in which it cannot start a new transaction. -or- Thrown when the active view isn't a legend view. -or- Can not create this kind of element in legend view.