Application.BoxFormat method (Project)
Formats individual boxes in the Network Diagram view (PERT chart).
Syntax
expression. BoxFormat( _ProjectName_, _TaskID_, _DataTemplate_, _HorizontalGridlines_, _VerticalGridlines_, _BorderShape_, _BorderColor_, _BorderWidth_, _BackgroundColor_, _BackgroundPattern_, _Reset_ )
expression A variable that represents an Application object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| ProjectName | Optional | String | The name of the project containing TaskID when working with consolidated projects. The default value is the name of the active project. |
| TaskID | Optional | Long | The identification number of the task represented by the box to change. The default behavior is to change the boxes that represent one or more selected tasks. |
| DataTemplate | Optional | String | The name of the data template to use. |
| HorizontalGridlines | Optional | Boolean | True if horizontal gridlines separate each row in the box; otherwise, False. |
| VerticalGridlines | Optional | Boolean | True if vertical gridlines separate each column in the box; otherwise, False. |
| BorderShape | Optional | Long | The shape of the box border. Can be one of the PjBoxShape constants. |
| BorderColor | Optional | Long | The color of the box border. Can be one of the PjColor constants. |
| BorderWidth | Optional | Long | Specifies the box border width, where values can be 1 to 4 for the four line widths shown in the Format Box dialog box. |
| BackgroundColor | Optional | Long | The color of the box background. Can be one of the PjColor constants. |
| BackgroundPattern | Optional | Long | The pattern for the background. Can be one of the PjBackgroundPattern constants. |
| Reset | Optional | Boolean | True if the box formatting is reset to the default style as shown in the Box Styles dialog box. If Reset is True, all arguments except ProjectName and TaskID are ignored. |
Return value
Boolean
Remarks
If TaskID is specified, the associated task cannot be hidden due to application of a filter or a collapsed outline structure.
Using the BoxFormat method without specifying any arguments displays the Format Box dialog box for the selected tasks. If no tasks are selected, the BoxFormat method has no effect.
Use the BoxFormat method to change the formatting of boxes from their default styles. To define the default styles, use the BoxStylesEdit or BoxStylesEditEx method.
To format Network Diagram boxes using hexadecimal values for BorderColor and BackgroundColor, see the BoxFormatEx method.
Example
The following example changes the border color to red and the background color to a light blue dithered pattern.
Sub BoxFormat_Color()
'Activate the Network Diagram view
ViewApply Name:="Network Diagram"
BoxFormat TaskID:="2", bordershape:=pjBoxRoundedRectangle, VerticalGridlines:=True, _
BorderWidth:=2, backgroundpattern:=pjBackgroundLightDither, _
Backgroundcolor:=pjBlue, BorderColor:=pjRed
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.