Свойство Window.BackgroundColor (Visio)

Статья
01/17/2024

Определяет цвет фона активного окна рисования Microsoft Visio и связанных с ним окон предварительного просмотра и полноэкранного режима. Для чтения и записи.

Синтаксис

выражение. BackgroundColor

Выражение Переменная, представляющая объект Window .

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

OLE_COLOR

Замечания

Допустимые значения свойства OLE_COLOR в Visio могут иметь одно из следующих значений:

&H00 bbggrr, где bb — это синее значение от 0 до 0xFF (255), gg — зеленое значение, а rr — красное.
&H800000 xx , где xx — допустимый индекс GetSysColor .

Дополнительные сведения о функции GetSysColor можно найти по запросу GetSysColor в пакете SDK платформы Майкрософт на сайте MSDN.

Тип данных OLE_COLOR используется для свойств, возвращающих цвета. Если свойство объявляется как OLE_COLOR, окно свойств в редакторе Visual Basic отображает диалоговое окно выбора цвета, которое позволяет пользователю выбрать цвет для свойства визуально, а не запоминать числовой эквивалент.

Кроме того, для OLE_COLOR можно использовать следующие цветовые константы Microsoft Visual Basic для приложений (VBA).

Константа	Значение	Описание
vbBlack	0x0	Черный
vbRed	0xff	Красный
vbGreen	0xFF00	Зеленый
vbYellow	0xffff	Желтый
vbBlue	0xFF0000	Синий
vbMagenta	0xFF00FF	Пурпурный
vbCyan	0xFFFF00	Cyan
vbWhite	0xFFFFFF	Белый

В окне рисования, окне предварительного просмотра или полноэкранном режиме при установке свойства BackgroundColor окна значение, отличное от значения по умолчанию (-1), переопределяет параметры ApplicationSettings.DrawingBackgroundColor, ApplicationSettings.PrintPreviewBackgroundColor и ApplicationSettings.FullScreenBackgroundColor для этого набора окон. Чтобы иметь возможность сбрасывать эти свойства для того же набора окон, необходимо сбросить backgroundColor до значения по умолчанию -1. Если открыто несколько рисунков, параметр BackgroundColor для одного набора окон не влияет на параметр для других открытых окон.

Однако для окна Таблицы фигур установка свойства BackgroundColor окна на значение, отличное от значения по умолчанию, изменяет цвет фона окна таблицы фигур, но не влияет ни на один из других параметров окна.

Пример

В следующем макросе VBA показано, как с помощью свойства BackgroundColor получить и задать текущий цвет фона окна документа. Здесь также показано, как получить объект ApplicationSettings из объекта Visio Application , а также показана связь между свойством BackgroundColor и свойством ApplicationSettings.DrawingBackgroundColor . В этом примере предполагается, что в Visio открыто активное окно рисования, и изначально для всех свойств цвета фона заданы значения по умолчанию.

Public Sub BackgroundColor_Example() 
 
 Dim vsoApplicationSettings As Visio.ApplicationSettings 
 Set vsoApplicationSettings = Visio.Application.Settings 
 
 'Get the current application background color. 
 Debug.Print vsoApplicationSettings.DrawingBackgroundColor 
 
 'Get the active window background color. 
 Debug.Print ActiveWindow.BackgroundColor 
 
 'Change the application background color. 
 'This also changes the active window color as 
 'well as the setting in the Color Settings dialog box. 
 vsoApplicationSettings.DrawingBackgroundColor = vbRed 
 
 'Change the active window background color. 
 ActiveWindow.BackgroundColor = vbMagenta 
 
 'Change the application background color again. 
 'This time, there is no change in the current 
 'window color, but the dialog box setting changes. 
 vsoApplicationSettings.DrawingBackgroundColor = vbYellow 
 
 'Reset Window.BackgroundColor to its default value. 
 ActiveWindow.BackgroundColor = -1 
 
 'Change the application background color again. 
 'Now both the active window color 
 'and the dialog box setting change. 
 vsoApplicationSettings.DrawingBackgroundColor = vbBlue 
 
End Sub

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

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

Поделиться через