Compartilhar via


Propriedade ApplicationSettings.StencilBackgroundColorGradient (Visio)

Determina a cor do gradiente do plano de fundo da janela de estêncil do Microsoft Visio, para a sessão atual. Leitura/gravação.

Sintaxe

expressão. StencilBackgroundColorGradient

expressão Uma variável que representa um objeto ApplicationSettings .

Valor de retorno

OLE_COLOR

Comentários

A configuração da propriedade StencilBackgroundColorGradient não persiste de uma sessão do Visio para a próxima.

Valores válidos para uma propriedade OLE_COLOR dentro do Visio podem ser um dos seguintes:

  • &H00 bbggrr, em que 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 , procure " 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 apresenta uma caixa de diálogo de seletor de cores que permite ao utilizador selecionar a cor da propriedade visualmente, em vez de ter de se lembrar do 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
Azul-vb 0xFF0000 Azul
vbMagenta 0xFF00FF Magenta
vbCyan 0xFFFF00 Ciano
vbWhite 0xFFFFFF Branco

Pode definir a cor de gradação de fundo para uma janela de stencil individual utilizando ActiveWindow.Windows(n). Propriedade BackgroundColorGradient , em que n representa o número de índice da janela do stencil na coleção do Windows . Quando uma janela de estêncil é aberta como uma janela flutuante, ela pode ser uma janela ativa e você pode definir sua cor do gradiente do plano de fundo usando a propriedade ActiveWindow.BackgroundColorGradient. Se tiver aberto uma janela de stencil desta forma, definir a propriedade BackgroundColor da janela do stencil ativo para um valor diferente do predefinido (-1) substitui a definição StencilBackgroundColorGradient para essa janela. Para poder redefinir a cor do gradiente do plano de fundo da mesma janela de estêncil ativa definindo a propriedade StencilBackgroundColorGradient, você deverá redefinir BackgroundColorGradient para seu valor padrão, -1. Se várias janelas de estêncil desse tipo forem abertas, definir BackgroundColorGradient para uma janela não terá efeito na definição de outras janelas abertas.

Observação

Você pode especificar duas cores para o plano de fundo do estêncil. Se a resolução de tela dos usuários for adequada, uma das cores formará um matiz com a outra da parte superior à inferior da tela. Para poder usar esse recurso, os usuários devem definir seus monitores para exibirem cores de 32 bits. A capacidade de definir a cor do plano de fundo do estêncil programaticamente para os usuários executarem em modo de alto contraste é restrita.

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.