Application.BoxLayoutEx method (Project)

Article
09/13/2021

Specifies the layout of boxes in the active Network Diagram view (PERT chart), where the background color can be specified as a hexadecimal value.

Syntax

expression. BoxLayoutEx( _LayoutMode_, _LayoutScheme_, _SummaryPrecedence_, _RowAlignment_, _ColumnAlignment_, _RowSpacing_, _ColumnSpacing_, _RowHeight_, _ColumnWidth_, _AdjustForPageBreaks_, _ShowSummaryTasks_, _ViewBackgroundColor_, _ViewBackgroundPattern_, _ShowProgressMarks_, _ShowPageBreaks_, _ShowIDOnly_ )

expression An expression that returns an Application object.

Parameters

Name	Required/Optional	Data type	Description
LayoutMode	Optional	Long	Specifies whether the layout of boxes is controlled automatically or by the user, either with the LayoutNow method or through the interface. Can be one of the PjLayoutMode constants.
LayoutScheme	Optional	Long	Specifies box alignment within each row. Can be one of the PjLayoutScheme constants.
SummaryPrecedence	Optional	Boolean	If True, summary tasks are placed before subtasks.
RowAlignment	Optional	Long	Alignment of text within a row. Can be one of the PjVerticalAlignment constants.
ColumnAlignment	Optional	Long	Alignment of text within a column. Can be one of the PjAlignment constants.
RowSpacing	Optional	Long	Spacing between rows. The value can be from 0 to 200.
ColumnSpacing	Optional	Long	Spacing between columns. The value can be from 0 to 200.
RowHeight	Optional	Long	The height of each row of boxes. Can be one of the PjRowColSize constants.
ColumnWidth	Optional	Long	The width of each column of boxes. Can be one of the PjRowColSize constants.
AdjustForPageBreaks	Optional	Boolean	If True, a new task is placed on the next page if it does not fit on the current page. If False, a new task can fall on a break between pages.
ShowSummaryTasks	Optional	Boolean	If True, summary tasks are shown. If False, summary tasks are hidden.
ViewBackgroundColor	Optional	Long	The background color of the view. Can be a hexadecimal value for the RGB color, where red is the last byte. For example, the value &HFF0000 is blue and &H00FFFF is yellow.
ViewBackgroundPattern	Optional	Long	The pattern used for the background. Can be one of the PjBackgroundPattern constants.
ShowProgressMarks	Optional	Boolean	True if tasks in progress are marked with a diagonal line from the upper-left corner of the box to the lower-right corner and completed tasks are marked with an additional diagonal line from the upper-right corner of the box to the lower-left corner. False if the progress of tasks is not marked.
ShowPageBreaks	Optional	Boolean	True if page breaks show in the Network Diagram; otherwise, False.
ShowIDOnly	Optional	Boolean	True if only task ID numbers are displayed. False if all the task data fields in Network Diagram boxes are displayed.

Return value

Boolean

Remarks

Using the BoxLayoutEx method without specifying any arguments displays the Box Layout dialog box.

Example

The following example sets the layout of boxes on the active Network Diagram view to the default values.

Sub ReturnToDefault()
    Application.BoxLayoutEx LayoutMode:=pjLayoutManual, LayoutScheme:=pjLayoutTopDownFromLeft, _
        SummaryPrecedence:=True, RowAlignment:=pjCenter, ColumnAlignment:=pjMiddle, RowSpacing:=45, _
        ColumnSpacing:=60, RowHeight:=pjSizeBestFit, ColumnWidth:=pjSizeBestFit, AdjustForPageBreaks:=True, _
        ShowSummaryTasks:=True, ViewBackgroundColor:=&HFFFFFF, ViewBackgroundPattern:=pjBackgroundSolidFill, _
        ShowProgressMarks:=False, ShowPageBreaks:=True, ShowIDOnly:=False
End Sub

Note

If you use any of the PjColor constants for the ViewBackgroundColor parameter, the color will be nearly black. For example, the value of pjGreen is 9, which in the BoxLayoutEx method is a very dark red. To use only the sixteen colors available with PjColor constants, use the BoxLayout method.

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.

Share via