Namespace: Autodesk.Revit.UI Class: UIDocument

UIDocument.RequestViewChange

Method

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

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.

Syntax

public void RequestViewChange(
	View view
)

Public Sub RequestViewChange ( 
	view As View
)

public:
void RequestViewChange(
	View^ view
)

member RequestViewChange : 
        view : View -> unit

Parameters

Parameter	Type	Description
view	View	The View.

Return Value

Exceptions

Exception	Condition
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.