Метод Application.BoxFormatEx (Project)

Статья
04/07/2023

Форматирует отдельные поля в представлении сетевой схемы (диаграмма PERT), где цвета можно указать с шестнадцатеричными значениями.

Синтаксис

выражение. BoxFormatEx( _ProjectName_, _TaskID_, _DataTemplate_, _HorizontalGridlines_, _VerticalGridlines_, _BorderShape_, _BorderColor_, _BorderWidth_, _BackgroundColor_, _BackgroundPattern_, _Reset_ )

Выражение Выражение, возвращающее объект Application .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
ProjectName	Необязательный	String	Имя проекта, содержащего TaskID при работе с консолидированными проектами. Значение по умолчанию — это имя активного проекта.
TaskID	Необязательный	Long	Идентификационный номер задачи, представленной полем для изменения. Поведение по умолчанию — изменение полей, представляющих одну или несколько выбранных задач.
Datatemplate	Необязательный	String	Имя используемого шаблона данных.
HorizontalGridlines	Необязательный	Логический	Значение true, если горизонтальные линии сетки разделяют каждую строку в поле; в противном случае — False.
VerticalGridlines	Необязательный	Логический	Значение true, если вертикальные линии сетки разделяют каждый столбец в поле; в противном случае — False.
BorderShape	Необязательный	Long	Форма рамки поля. Может быть одной из констант PjBoxShape .
BorderColor	Необязательный	Long	Цвет рамки поля. Может быть шестнадцатеричным значением для цвета RGB, где красный — последний байт. Например, значение `&HFF0000` синее и `&H00FFFF` желтое.
BorderWidth	Необязательный	Long	Задает ширину границы поля, где значения могут быть от 1 до 4 для четырех ширин линий, показанных в диалоговом окне Формат поля .
BackgroundColor	Необязательный	Long	Цвет фона коробки. Может быть шестнадцатеричным значением, где красный — последний байт. Например, значение `&HFFFF00` — сине-зеленый, а `&HFF00FF` — фиолетовый.
BackgroundPattern	Необязательный	Long	Шаблон фона. Может быть одной из констант PjBackgroundPattern .
Reset	Необязательный	Логический	Значение true , если форматирование поля сбрасывается до стиля по умолчанию, как показано в диалоговом окне Стили поля . Если параметр Reset имеет значение True, все аргументы, кроме ProjectName и TaskID , игнорируются.

Возвращаемое значение

Boolean

Примечания

Если указан Идентификатор задачи , связанную задачу нельзя скрыть из-за применения фильтра или свернутой структуры структуры структуры.

При использовании метода BoxFormatEx без аргументов отображается диалоговое окно "Поле форматирования" для выбранных задач. Если задачи не выбраны, метод BoxFormatEx не действует.

Используйте метод BoxFormatEx , чтобы изменить форматирование полей по умолчанию. Чтобы определить стили по умолчанию, используйте метод BoxStylesEdit или BoxStylesEditEx .

Пример

В следующем примере цвет границы поля изменяется на красный, а цвет фона — на светло-голубой.

Sub BoxFormat_Color() 
    'Activate the Network Diagram view
    ViewApply Name:="Network Diagram"

    BoxFormatEx TaskID:="2", bordershape:=pjBoxRoundedRectangle, VerticalGridlines:=False, _
        BorderWidth:=3, backgroundpattern:=pjBackgroundLightDither, _
        BackgroundColor:=&HFF0000, BorderColor:=&HFF
End Sub

Примечание.

Если вы используете любую из констант PjColor для параметров BorderColor или BackgroundColor , цвет будет почти черным. Например, значение pjGreen равно 9, что в методе BoxFormatEx является очень темно-красным. Чтобы использовать только шестнадцать цветов, доступных с константами PjColor , используйте метод BoxFormat .

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Share via