Compartilhar via


Propriedade Window.BackgroundColor (Visio)

Determina a cor do plano de fundo da janela de desenho ativa do Microsoft Visio e das respectivas janelas associadas de visualização de impressão e exibição em tela inteira. Leitura/gravação.

Sintaxe

expression. BackgroundColor

Expressão Uma variável que representa um objeto Window .

Valor de retorno

OLE_COLOR

Comentários

Os valores válidos para uma propriedade OLE_COLOR do Visio pode ser um dos valores a seguir:

  • &H00 bbggrr, onde bb é o valor azul entre 0 e 0xFF (255), gg o valor verde e rr o valor vermelho.

  • &H800000 xx , em que xx é um índice GetSysColor válido.

Para obter detalhes sobre a função GetSysColor , pesquise por " GetSysColor " no SDK da Plataforma Microsoft no MSDN.

O tipo de dados OLE_COLOR é usado para propriedades que retornam cores. Quando uma propriedade é declarada como OLE_COLOR, o janela Propriedades no Editor do Visual Basic exibe uma caixa de diálogo de seletor de cores que permite que o usuário selecione a cor da propriedade visualmente, em vez de ter que lembrar o equivalente numérico.

Além disso, você pode usar as seguintes constantes de cores do Microsoft Visual Basic for Applications (VBA) para OLE_COLOR.

Constant Valor Descrição
vbBlack 0x0 Preto
vbRed 0xff Vermelho
vbGreen 0xFF00 Verde
vbYellow 0xffff Amarelo
vbBlue 0xFF0000 Azul
vbMagenta 0xFF00FF Magenta
vbCyan 0xFFFF00 Ciano
vbWhite 0xFFFFFF Branco

Para uma janela de desenho, print preview window ou full-screen view window, definindo a propriedade BackgroundColor da janela como um valor diferente do padrão (-1) substitui as configurações ApplicationSettings.DrawingBackgroundColor, ApplicationSettings.PrintPreviewBackgroundColor e ApplicationSettings.FullScreenBackgroundColor para esse conjunto de janelas. Para poder redefinir essas propriedades para o mesmo conjunto de janelas, você deve redefinir BackgroundColor para seu valor padrão, -1. Se vários desenhos estiverem abertos, definir BackgroundColor para um conjunto de janelas não terá efeito na configuração de outros conjuntos de janelas abertas.

No entanto, para uma janela ShapeSheet, definir a propriedade BackgroundColor da janela como um valor diferente do padrão altera a cor de fundo da janela ShapeSheet, mas não tem efeito em nenhuma das outras configurações de janela.

Exemplo

A seguinte macro VBA mostra como utilizar a propriedade BackgroundColor para obter e definir a cor do plano de fundo da janela de desenho atual. Ele também mostra como obter um objeto ApplicationSettings do objeto Aplicativo Visio e demonstra a relação entre a propriedade BackgroundColor e a propriedade ApplicationSettings.DrawingBackgroundColor . Este exemplo pressupõe que há uma janela de desenho ativa aberta no Visio e que, inicialmente, todas as propriedades de cor em segundo plano estão definidas como seus valores padrão.

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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.