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, 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 exibe uma caixa de diálogo 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

Você pode definir a cor do gradiente em segundo plano para uma janela de estêncil individual usando o ActiveWindow.Windows(n). Propriedade BackgroundColorGradient , em que n representa o número de índice da janela do estêncil 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 você abriu uma janela de estêncil dessa maneira, definir a propriedade BackgroundColor da janela de estêncil ativo como um valor diferente do padrão (-1) substituirá a configuraçã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.