Application.TaskOnTimeline method (Project)

Manages tasks on the Timeline pane or for a specified custom timeline.

Syntax

expression. TaskOnTimeline( _TaskID_, _Remove_, _TimelineViewName_ )

expression An expression that returns an Application object.

Parameters

Name	Required/Optional	Data type	Description
TaskID	Optional	Long	Specifies the identification number of a task to add to the timeline or remove from the timeline. If TaskID is specified, selected tasks are ignored.
Remove	Optional	Boolean	True if the task specified by TaskID or the selected tasks are removed from the timeline; otherwise, False. The default value is False.
TimelineViewName	Optional	String	Specifies the name of a timeline to use. The name can be the built-in "Timeline" or an existing custom timeline such as "My Timeline". The default value is the name of the active timeline.
ShowDialog	Optional	Boolean	True if Project displays the Add Tasks to Timeline dialog box; otherwise, False. Any tasks that are already on the timeline have a check by their names. If ShowDialog is True, Project ignores the TaskID and Remove arguments. The default value is False.

Return value

Boolean

Remarks

Running TaskOnTimeline with no arguments puts selected tasks on the active timeline.

If the project includes custom timeline views, using the TimelineViewName argument activates the specified timeline, and then applies changes specified by the other arguments. If the specified timeline does not exist, TaskOnTimeline takes no action, but still returns True.

Example

The following statement removes selected tasks from the timeline. You can select the tasks in the Gantt Chart or on the timeline.

application.TaskOnTimeline Remove:=True

If the built-in Timeline pane is active and a custom timeline named "My Timeline" exists, the following statement replaces the Timeline pane with "My Timeline", and then adds task 3 to the custom timeline.

application.TaskOnTimeline TaskID:=3, TimelineViewName:="My Timeline"

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.