Método Application.BoxFormatEx (Project)

Formata caixas individuais no modo de exibição Diagrama de Rede (Gráfico PERT), onde as cores podem ser especificadas com valores hexadecimais.

Sintaxe

expression. BoxFormatEx( _ProjectName_, _TaskID_, _DataTemplate_, _HorizontalGridlines_, _VerticalGridlines_, _BorderShape_, _BorderColor_, _BorderWidth_, _BackgroundColor_, _BackgroundPattern_, _Reset_ )

expressão Uma expressão que devolve um objeto Aplicação .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
ProjectName	Opcional	String	O nome do projeto que contém a TaskID quando estiver trabalhando com projetos consolidados. O valor padrão é o nome do projeto ativo.
TaskID	Opcional	Long	O número de identificação da tarefa representada pela caixa a ser alterada. O comportamento padrão é alterar as caixas que representam uma ou mais tarefas selecionadas.
DataTemplate	Opcional	String	O nome do modelo de dados a ser usado.
HorizontalGridlines	Opcional	Boolean	True se linhas de grade horizontais separam cada linha na caixa; Caso contrário, False.
VerticalGridlines	Opcional	Boolean	True se linhas de grade verticais separarem cada coluna na caixa; Caso contrário, False.
BorderShape	Opcional	Long	A forma da borda da caixa. Pode ser uma das constantes PjBoxShape.
BorderColor	Opcional	Long	A cor da borda da caixa. Pode ser um valor hexadecimal para a cor RGB, onde vermelho é o último byte. Por exemplo, o valor &HFF0000 é azul e &H00FFFF é amarelo.
BorderWidth	Opcional	Long	Especifica a largura da borda da caixa, onde os valores podem ser de 1 a 4 para as larguras de quatro linhas mostradas na caixa de diálogo Formatar Caixa.
BackgroundColor	Opcional	Long	A cor de fundo da caixa. Pode ser um valor hexadecimal, onde vermelho é o último byte. Por exemplo, o valor &HFFFF00 é azul-verde e &HFF00FF é roxo.
BackgroundPattern	Opcional	Long	O padrão do plano de fundo. Pode ser uma das constantes PjBackgroundPattern.
Reset	Opcional	Boolean	True se a formatação da caixa for redefinida para o estilo padrão, conforme mostrado na caixa de diálogo Estilos de caixa. Se Redefinir for True, todos os argumentos exceto NomeDoProjeto e TaskID serão ignorados.

Valor de retorno

Boolean

Comentários

Se TaskID for especificada, a tarefa associada não pode ser ocultada com a aplicação de um filtro ou uma estrutura de contorno recolhida.

Usar o método BoxFormatEx sem argumentos exibe a caixa de diálogo Formatar caixa das tarefas selecionadas. Se nenhuma tarefa for selecionada, o método BoxFormatEx não terá efeito.

Use o método BoxFormatEx para alterar a formatação das caixas de seus estilos padrão. Para definir os estilos padrão, use o BoxStylesEdit ou o método BoxStylesEditEx.

Exemplo

O exemplo a seguir altera a cor da borda de caixa para vermelho e a cor de plano de fundo para um padrão pontilhado azul claro.

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

Observação

Se utilizar qualquer uma das constantes PjColor para os parâmetros BorderColor ou BackgroundColor , a cor será quase preta. Por exemplo, o valor de pjGreen é 9, que no método BoxFormatEx é um vermelho muito escuro. Para usar somente as dezesseis cores disponíveis com constantes PjColor, use o método BoxFormat.

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.