topic Re: SpatialElementTag Leader position in Revit API Forum

SpatialElementTag Leader position

tamas.deri — Thu, 22 Apr 2021 14:54:54 GMT

I'm trying to manipulate the SpatialElementTag and its leaders coordinates, but although the Revit API docs states that both LeaderEnd, LeaderElbow and TagHeadPosition can be set, it doesn't work. Nothing happens, no exception, just nothing. Its the same for version 2020, and 2021 as well. It works with any tags of the IndependentTag class, and I'm trying the same with the SpatialElementTag without success. What is the magic, if there is any?

Re: SpatialElementTag Leader position

franciscopossetto — Fri, 23 Apr 2021 01:08:21 GMT

Hey,

I have tested this, in Revit 2020 and it worked.

Document doc = uiDoc.Document; Reference pickObject = uiDoc.Selection.PickObject(ObjectType.Element); SpatialElementTag tag = doc.GetElement(pickObject.ElementId) as SpatialElementTag; XYZ currentPosition1 = tag.LeaderEnd; XYZ newPosition1 = new XYZ(currentPosition1.X, currentPosition1.Y + 3, currentPosition1.Z); XYZ currentPosition2 = tag.LeaderElbow; XYZ newPosition2 = new XYZ(currentPosition2.X, currentPosition2.Y + 3, currentPosition2.Z); XYZ currentPosition3 = tag.TagHeadPosition; XYZ newPosition3 = new XYZ(currentPosition3.X, currentPosition3.Y + 3, currentPosition3.Z); using (Transaction t = new Transaction(doc, "Change leader position")) { t.Start(); tag.LeaderEnd = newPosition1; tag.LeaderElbow = newPosition2; tag.TagHeadPosition = newPosition3; t.Commit(); }

I used the Room tag that is by default in the Revit Sample Project. The location of the 3 points was modified correctly. The only caveat I got while testing was that the LeaderEnd has to be inside the room, which makes sense.

I hope it helps,

Kind regards!

Re: SpatialElementTag Leader position

tamas.deri — Tue, 27 Apr 2021 10:31:55 GMT

I've tried your code as a Macro, and it did work. However if I only apply

tag.TagHeadPosition = newPosition3;

the outcome is not visible on the screen, like nothing happened, but once I hit undo and redo, the change is visible. It seems there is some weird issue with regenerating. I'll attach a screen recording.

Re: SpatialElementTag Leader position

Sean_Page — Tue, 27 Apr 2021 20:38:39 GMT

Could try Regenerating the document after the changes?

Regenerate Method (revitapidocs.com)

Or update the current view

RefreshActiveView Method (revitapidocs.com)

Re: SpatialElementTag Leader position

tamas.deri — Thu, 29 Apr 2021 07:42:06 GMT

None of the above works, unfortunately. I understand that there is an automatic doc.Regenerate() at the end of each transaction, and calling it after commiting the transaction throws an InvalidOperationException that there is no open transactions, which is quite strange, why would I need a Transaction, to regenerate?

Re: SpatialElementTag Leader position

gankeyu — Wed, 21 May 2025 08:11:43 GMT

I ran into the same problem. It turns out you need to set LeaderElbow in the same transaction to force a update. No regen is required. For example of straight RoomTags:

tag.TagHeadPosition = SomeNewValue(); tag.LeaderElbow = (tag.LeaderEnd + tag.TagHeadPosition) / 2;

for elbowed tags, I think

tag.LeaderElbow = tag.LeaderElbow;

will do.