UIDocument.RequestViewChange Method

UIDocumentRequestViewChange Method

Requests an asynchronous change of the active view in the currently active document.

Namespace: Autodesk.Revit.UI
Assembly: RevitAPIUI (in RevitAPIUI.dll) Version: 26.0.4.0 (26.0.4.0)
Syntax
public void RequestViewChange(
	View view
)
Public Sub RequestViewChange ( 
	view As View
)
public:
void RequestViewChange(
	View^ view
)
member RequestViewChange : 
        view : View -> unit

Parameters

view  View
The View.
Exceptions
ExceptionCondition
ArgumentNullException If the 'view' argument is NULL.
ArgumentException
  • If the given view is not a valid view of the document; -or-
  • If the given view is a template view; -or-
  • If the given view is an internal view.
InvalidOperationException
  • If the given view is not from the currently active document; -or-
  • If the active document is currently modifiable (i.e. with an active transaction); -or-
  • If the active document is currently in read-only state; -or-
  • During either ViewActivating or ViewActivated event; -or-
  • During any pre-action kind of event, such as DocumentSaving, etc.
Remarks

This method requests to change the active view by posting a message asynchronously. Unlike setting the ActiveView property, this will not make the change in active view immediately. Instead the request will be posted to occur when control returns to Revit from the API context. This method is permitted to change the active view from the Idling event or an ExternalEvent callback.

The active view cannot be changed when:

  • There is an open transaction in the currently active document.
  • IsModifiable is true.
  • IsReadOnly is true.
  • ViewActivating, ViewActivated, or any pre-event (such as DocumentSaving) is being handled.

See Also

M:Autodesk.Revit.UI.UIDocument.RequestViewChange(Autodesk.Revit.DB.View)