Edit

Application.BoxSet method (Project)

  • Article

Creates, selects, or moves a task in the Network Diagram view.

Syntax

expression.BoxSet (action, TaskID, XPosition, YPosition, ProjectName)

expression A variable that represents an Application object.

Parameters

Name Required/Optional Data type Description
action Optional Long The operation to perform on the specified task(s). The default value is pjBoxSelect. Can be one of the PjBoxSet constants.
TaskID Optional Long The identification number of the task. If action is pjBoxCreate, TaskID is ignored.
XPosition Optional Long The horizontal position of the task, in pixels. Required if action is pjBoxMoveAbsolute or pjBoxMoveRelative.

If action is pjBoxCreate or pjBoxMoveAbsolute, XPosition is the absolute horizontal position of the upper-left corner of the task.

If action is pjBoxMoveRelative, XPosition is the amount to move the task horizontally relative to the current position.

If action is pjBoxAddToSelection, pjBoxSelect, or pjBoxUnselect, XPosition is ignored.
YPosition Optional Long The vertical position of the task, in pixels. Required if action is pjBoxMoveAbsolute or pjBoxMoveRelative.

If action is pjBoxCreate or pjBoxMoveAbsolute, YPosition is the absolute vertical position of the upper-left corner of the task.

If action is pjBoxMoveRelative, YPosition is the amount to move the task vertically relative to the current position.

If action is pjBoxAddToSelection, pjBoxSelect, or pjBoxUnselect, YPosition is ignored.
ProjectName Optional String If the active project is a consolidated project, specifies the name of the project for the identification number specified by TaskID. If TaskID is not specified, ProjectName is ignored. The default value is the name of the active project.

Return value

Boolean

Remarks

If only one task box is selected, specifying pjBoxUnselect has no effect.

If automatic layout has been activated for the Network Diagram view, XPosition and YPosition have no effect.

Example

The following example adds the task with TaskID 2 to the selected tasks.

Sub Box_Set() 
 
 'Activate the Network Diagram view 
 ViewApply Name:="Network Diagram" 
 BoxSet action:=pjBoxAddToSelection, TaskID:="2" 
End Sub

Note

BoxSet does not currently work for subprojects. You can place the subproject name in the Project Name attribute and set the TaskID, but it does not perform the action to the box from the subproject in the Network Diagram.

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.