Application.ViewApplyEx method (Project)
Applies a view to the active window, where the change can be one of the built-in views and can be applied to a specified pane in a split view.
Syntax
expression.ViewApplyEx (Name, SinglePane, Toggle, ApplyTo, BuiltInView)
expression An expression that returns an Application object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| Name | Optional | String | The name of the view to display in the active window. |
| SinglePane | Optional | Boolean | True if an existing split is removed and the active window displays a single-pane view. The default value is False. |
| Toggle | Optional | Boolean | True if the active window switches from one pane to two panes, or from two panes to one pane. Toggle is ignored if SinglePane is True. The default value is False. |
| ApplyTo | Optional | Integer | Specifies where the view is applied. The value can be one of the ApplyTo values. |
| BuiltInView | Optional | PjViewType | Specifies a built-in view. Can be one of the PjViewType constants. The default is pjViewUndefined. BuiltInView is ignored if Name is specified. |
ApplyTo values
| Value | Description |
|---|---|
| 0 | Primary (usually the top) pane of a split view |
| 1 | Secondary (usually the bottom) pane of a split view |
| 4 | Active pane |
| 5 | Primary pane, or the Timeline if it is active |
Return value
Boolean
Remarks
Note
In a combination view, the primary pane is the view that remains when a details or secondary pane is closed. Usually the primary pane is at the top; however, the Timeline is a secondary pane, but it displays at the top. For example, with the Resource Sheet view, clicking Details on the View tab on the ribbon shows the secondary Resource Form pane on the bottom. Clicking Timeline closes the Resource Form at the bottom and opens the Timeline pane at the top.
The Gantt Chart view cannot be combined with the Team Planner view. Some views, such as the Calendar view, cannot be displayed in a details pane. The ViewApply method shows an error message, and then shows error 1004, "An unexpected error occurred with the method."
Example
The following example sets the single-pane active window to a combination view with the Gantt Chart in the lower pane. It assumes that the active view is something other than the Gantt Chart.
Sub ChangeWindowToGanttChart()
ViewApplyEx Toggle:=True, BuiltInView:=pjViewGantt
End Sub
If the current split view includes the Resource Usage and the Timeline views, where either pane is selected, the following example displays the Resource Usage view in the top pane and the Task Usage view in the bottom pane.
Sub ChangeSecondaryToTaskForm()
ViewApplyEx(Name:="Task Usage", ApplyTo:=1)
End sub
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.