ColorScale Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.Excel

Ensamblado:

Microsoft.Office.Interop.Excel.dll

Representa una regla de formato condicional de escala de colores.

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

Ejemplos

El ejemplo de código siguiente crea un rango de números y después le aplica a dicho rango una regla de formato condicional de escala de dos colores. Al umbral mínimo se le asigna el color rojo y al umbral máximo, el 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>

Comentarios

Todos los objetos de formato condicional se encuentran dentro de un FormatConditions objeto de colección, que es un elemento secundario de una Range colección. Puede crear una regla de formato de escala de colores mediante el Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) método o AddColorScale(Int32) de la colección FormatConditions .

Las escalas de colores son guías visuales que ayudan a comprender la distribución y la variación de los datos. Puede aplicar una escala de colores de dos colores o una escala de tres colores a un rango de datos, a datos de una tabla o a los datos de un informe de tabla dinámica. En el caso de formato condicional de escala de dos colores, se asigna el valor, tipo y color a los umbrales mínimo y máximo de un rango. Las escalas de tres colores también tienen un umbral de punto medio.

Cada uno de estos umbrales se determina estableciendo las propiedades del ColorScaleCriteria objeto . El objeto ColorScaleCriteria , que es un elemento secundario del objeto ColorScale , es una colección de todos los ColorScaleCriterion objetos para la escala de colores.

Propiedades

Application	Cuando se usa sin un calificador de objeto, esta propiedad devuelve un _Application objeto que representa la aplicación de Microsoft Office Excel. Cuando se utiliza con un calificador de objeto, esta propiedad devuelve un objeto Application que representa al creador del objeto especificado. Solo lectura.
AppliesTo	Devuelve un Range objeto que especifica el intervalo de celdas al que se aplica la regla de formato.
ColorScaleCriteria	Devuelve un ColorScaleCriteria objeto , que es una colección de objetos individuales ColorScaleCriterion . El ColorScaleCriterion objeto especifica el tipo, el valor y el color de los criterios de umbral usados en el formato condicional de escala de colores. Solo lectura.
Creator	Devuelve una constante en la XlCreator enumeración que indica la aplicación en la que se creó este objeto. Solo lectura.
Formula	Devuelve o establece un valor String que representa una fórmula que determina los valores a los que se aplicará el conjunto de iconos.
Parent	Devuelve el objeto primario del objeto especificado. Solo lectura.
Priority	Devuelve o establece el valor de prioridad de la regla de formato condicional. La prioridad determina el orden de evaluación cuando existen varias reglas de formato condicional en una hoja de cálculo.
PTCondition	Devuelve un valor booleano que indica si el formato condicional se está aplicando a un PivotTable gráfico. Solo lectura.
ScopeType	Devuelve o establece una de las constantes de la XlPivotConditionScope enumeración, que determina el ámbito del formato condicional cuando se aplica a un gráfico de tabla dinámica.
StopIfTrue	Devuelve o establece un valor Boolean que determina si se deben evaluar reglas adicionales de formato en la celda si la regla actual da como resultado True.
Type	Devuelve una de las constantes de la XlFormatConditionType enumeración, que especifica el tipo de formato condicional. Solo lectura.

Métodos

Delete()	Elimina el objeto de reglas de formato condicional especificado.
ModifyAppliesToRange(Range)	Establece el rango de celdas al que se aplica esta regla de formato.
SetFirstPriority()	Establece el valor de prioridad para esta regla de formato condicional en "1" para que se evalúe antes que todas las demás reglas en la hoja de cálculo.
SetLastPriority()	Establece el orden de evaluación para esta regla de formato condicional de modo que se evalúe después que todas las demás reglas en la hoja de cálculo.