ColorScale Interface

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Representa uma regra de formatação condicional de escala de cores.

public interface class ColorScale

[System.Runtime.InteropServices.Guid("00024493-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ColorScale

Public Interface ColorScale

Atributos

GuidAttribute InterfaceTypeAttribute

Exemplos

O exemplo de código a seguir cria um intervalo de números e aplica uma regra de formatação de escala de duas cores a esse intervalo. A cor do limite mínimo é vermelha e o limite máximo é azul.

<span class="label">Sub CreateColorScaleCF() 































































































































































































































































    Dim cfColorScale As </span>
<i>ColorScale</i>
<span class="label">'Fill cells with sample data from 1 to 10     With ActiveSheet         .Range("C1") = 1         .Range("C2") = 2         .Range("C1:C2").AutoFill Destination:=Range("C1:C10")     End With          Range("C1:C10").Select          'Create a two-color ColorScale object for the created sample data range     Set cfColorScale = Selection.FormatConditions.AddColorScale(ColorScaleType:=2)          'Set the minimum threshold to red and maximum threshold to blue     cfColorScale.ColorScaleCriteria(1).FormatColor.Color = RGB(255, 0, 0)     cfColorScale.ColorScaleCriteria(2).FormatColor.Color = RGB(0, 0, 255)          End Sub</span>

Comentários

Todos os objetos de formatação condicional estão contidos em um FormatConditions objeto de coleção, que é filho de uma Range coleção. Você pode criar uma regra de formatação de escala de cores usando o Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) método ou AddColorScale(Int32) da coleção FormatConditions .

As escalas de cores são guias visuais que ajudam você a compreender a distribuição e a variação de dados. Você pode aplicar uma escala de duas cores ou de três cores a um intervalo de dados, dados em uma tabela, ou dados um relatório de tabela dinâmica. Para uma formatação condicional de escala de duas cores, você pode atribuir o valor, tipo e cor aos limites mínimo e máximo de um intervalo. Uma escala de três cores também possui um limite médio.

Cada um desses limites é determinado definindo as propriedades do ColorScaleCriteria objeto. O objeto ColorScaleCriteria , que é filho do objeto ColorScale , é uma coleção de todos os ColorScaleCriterion objetos para a escala de cores.

Propriedades

Application	Quando usada sem um qualificador de objeto, essa propriedade retorna um _Application objeto que representa o aplicativo do Microsoft Office Excel. Quando usado com um qualificador de objeto, essa propriedade retorna um objeto Application que representa o criador do objeto especificado. Somente leitura.
AppliesTo	Retorna um Range objeto que especifica o intervalo de células ao qual a regra de formatação é aplicada.
ColorScaleCriteria	Retorna um ColorScaleCriteria objeto, que é uma coleção de objetos individuais ColorScaleCriterion . O ColorScaleCriterion objeto especifica o tipo, o valor e a cor dos critérios de limite usados no formato condicional de escala de cores. Somente leitura.
Creator	Retorna uma constante na XlCreator enumeração que indica o aplicativo no qual esse objeto foi criado. Somente leitura.
Formula	Retorna ou define um valor String representando uma fórmula que determina os valores em que o conjunto de ícones será aplicado.
Parent	Retorna o objeto pai do objeto especificado. Somente leitura.
Priority	Retorna ou define um valor de prioridade da regra de formatação condicional. A prioridade determina a ordem da avaliação quando houver várias regras de formatação condicional em uma planilha.
PTCondition	Retorna um valor booliano indicando se o formato condicional está sendo aplicado a um PivotTable gráfico. Somente leitura.
ScopeType	Retorna ou define uma das constantes da XlPivotConditionScope enumeração, que determina o escopo do formato condicional quando ele é aplicado a um gráfico de Tabela Dinâmica.
StopIfTrue	Retorna ou define um valor Boolean que determina se as regras de formatação adicionais na célula devem ser avaliadas se a regra atual avaliar para True.
Type	Retorna uma das constantes da XlFormatConditionType enumeração, que especifica o tipo de formato condicional. Somente leitura.

Métodos

Delete()	Exclui o objeto de regra da formatação condicional especificado.
ModifyAppliesToRange(Range)	Define o intervalo de células ao qual esta regra de formatação se aplicará.
SetFirstPriority()	Define o valor de prioridade para esta regra de formatação condicional como "1", de forma que esta regra seja avaliada antes das outras regras na planilha.
SetLastPriority()	Define a ordem de avaliação para esta regra de formatação condicional, de forma que seja avaliada após todas as outras regras da planilha.