topic Re: Close Active Project/Document using UIFramework in Revit API Forum

Close Active Project/Document using UIFramework

ricaun — Tue, 25 Feb 2025 12:50:48 GMT

Hello,

For some reason Revit API does not allow to close an ActiveUIDocument, and I know is possible to close using press F4 or PostCommand.Close.

I want to share a different approach using UIFramework reference.

Here is the extension for the UIApplication to enable CloseAllUIDocument and CloseActiveUIDocument.

https://gist.github.com/ricaun/ff6814faf407ee044b93ee8e787f628c

Basically the code close UI document window and use the event DialogBoxShowing to force to save or not the document if the save popup happens.

Here is a simple Command to close the ActiveUIDocument.

[Transaction(TransactionMode.Manual)] public class CommandCloseActiveUIDocument : IExternalCommand { public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elementSet) { UIApplication uiapp = commandData.Application; uiapp.CloseActiveUIDocument(); return Result.Succeeded; } }

To use the extension your project need to have the UIFramework reference, you can add the reference using the packages below.

See yaa!

Re: Close Active Project/Document using UIFramework

nice3point — Tue, 25 Feb 2025 14:31:54 GMT

This should definitely be in the default API, why such restrictions🙈

Re: Close Active Project/Document using UIFramework

rhanzlick — Tue, 29 Apr 2025 23:57:06 GMT

Is there a reason you would want to close a UIDocument vs the UIDocument.Document? What’s the nuance/usecase for the former? (Just out of curiosity.)

Re: Close Active Project/Document using UIFramework

ricaun — Wed, 30 Apr 2025 12:23:24 GMT

@rhanzlick wrote:
Is there a reason you would want to close a UIDocument vs the UIDocument.Document? What’s the nuance/usecase for the former? (Just out of curiosity.)

Is not possible to close the active document, the Remarks in the documentation for the Close method mention that.

"The currently active document may not be closed by this function. It can only be closed via Revit's UI."

So if you use OpenAndActivateDocument and need to close the active document the Close method does not work.

UIDocument uidoc = uiapp.OpenAndActivateDocument("Sample.rvt"); uidoc.Document.Close(false); // Fail to close.

Using the extension should work to close the active document using the Revit UI.

UIDocument uidoc = uiapp.OpenAndActivateDocument("Sample.rvt"); uiapp.CloseActiveUIDocument();

Re: Close Active Project/Document using UIFramework

K.Calero_Arup — Fri, 01 May 2026 22:21:30 GMT

@ricaun Somehow I tested willy nilly and got this working with your extension methods, although I'm passing commandlinks instead of yes/no in the OnDialogBoxShowing handler. So it can be applied to any dialog right? (https://rvtdocs.com/2025/bde54cc2-a445-8610-0ced-1851f04eea18)