FormatCondition

FormatCondition class

Representa la condición de formato condicional.

public class FormatCondition

Propiedades

NombreDescripción
AboveAverage { get; }Obtenga la instancia “AboveAverage” del formato condicional. La regla de la instancia predeterminada resalta las celdas que están por encima del promedio para todos los valores en el rango. Válido solo para el tipo = AboveAverage.
ColorScale { get; }Obtenga la instancia “ColorScale” del formato condicional. La instancia predeterminada es una 3ColorScale “verde-amarillo-rojo”. Válido solo para el tipo = ColorScale.
DataBar { get; }Obtener la instancia “DataBar” del formato condicional. El color predeterminado de la instancia es azul. Válido solo para el tipo DataBar.
Formula1 { get; set; }Obtiene y establece el valor o la expresión asociada con el formato condicional.
Formula2 { get; set; }Obtiene y establece el valor o la expresión asociada con el formato condicional.
IconSet { get; }Obtenga la instancia “IconSet” del formato condicional. El IconSetType de la instancia predeterminada es TrafficLights31. Válido solo para el tipo = IconSet.
Operator { get; set; }Obtiene y establece el tipo de operador de formato condicional.
Priority { get; set; }La prioridad de esta regla de formato condicional. Este valor se utiliza para determinar qué formato se debe evaluar y representar. Los valores numéricos más bajos tienen mayor prioridad que valores numéricos más altos, donde ‘1’ es la prioridad más alta.
StopIfTrue { get; set; }Verdadero, no se pueden aplicar reglas con menor prioridad sobre esta regla, cuando esta regla se evalúa como verdadera. Solo se aplica a Excel 2007;
Style { get; set; }Obtiene o establece el estilo de los rangos de celdas con formato condicional.
Text { get; set; }El valor de texto en una regla de formato condicional “el texto contiene”. Válido solo para tipo = contiene texto, no contiene texto, comienza con y termina con. El valor predeterminado es nulo.
TimePeriod { get; set; }El período de tiempo aplicable en una regla de formato condicional de “fecha que ocurre…”. Válido solo para tipo = timePeriod. El valor predeterminado es TimePeriodType.Today.
Top10 { get; }Obtener la instancia “Top10” del formato condicional. La regla de la instancia predeterminada resalta las celdas cuyos valores caen en el paréntesis de los 10 primeros. Válido solo para el tipo Top10.
Type { get; set; }Obtiene y establece si el formato condicional Type.

Métodos

NombreDescripción
GetFormula1(bool, bool)Obtiene el valor o la expresión asociada a esta condición de formato.
GetFormula1(int, int)Obtiene la fórmula del formato condicional de la celda.
GetFormula1(bool, bool, int, int)Obtiene el valor o expresión del formato condicional de la celda.
GetFormula2(bool, bool)Obtiene el valor o la expresión asociada a esta condición de formato.
GetFormula2(int, int)Obtiene la fórmula del formato condicional de la celda.
GetFormula2(bool, bool, int, int)Obtiene el valor o expresión del formato condicional de la celda.
SetFormula1(string, bool, bool)Establece el valor o la expresión asociada a esta condición de formato.
SetFormula2(string, bool, bool)Establece el valor o la expresión asociada a esta condición de formato.
SetFormulas(string, string, bool, bool)Establece el valor o la expresión asociada a esta condición de formato.

Ejemplos


[C#]
// Instanciando un objeto Workbook
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
 
//Agrega un formato condicional vacío
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
 
//Establece el rango de formato condicional.
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
 
ca = new CellArea();
ca.StartRow = 1;
ca.EndRow = 1;
ca.StartColumn = 1;
ca.EndColumn = 1;
fcs.AddArea(ca);
 
//Agrega condición.
int conditionIndex = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100");
 
//Agrega condición.
int conditionIndex2 = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100");
 
//Establece el color de fondo.
FormatCondition fc = fcs[conditionIndex];
fc.Style.BackgroundColor = Color.Red;
 
//Guardando el archivo de Excel
workbook.Save("output.xls");

[VB.NET]

'Crear una instancia de un objeto Workbook
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
 
' Agrega un formato condicional vacío
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
 
'Establece el rango de formato condicional.
Dim ca As CellArea = New CellArea()
ca.StartRow = 0
ca.EndRow = 0
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
ca = New CellArea()
ca.StartRow = 1
ca.EndRow = 1
ca.StartColumn = 1
ca.EndColumn = 1
fcs.AddArea(ca)
 
'Agrega condición.
Dim conditionIndex As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100")
 
'Agrega condición.
Dim conditionIndex2 As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100")
 
'Establece el color de fondo.
Dim fc As FormatCondition = fcs(conditionIndex)
fc.Style.BackgroundColor = Color.Red
 
'Guardar el archivo de Excel
workbook.Save("output.xls")

Ver también