Clase IconCriterion (Excel VBA)

La clase IconCriterion representa el criterio de un icono concreto de un conjunto de iconos.

Set

Para usar una variable de clase IconCriterion, primero debe ser instanciado, por ejemplo

Dim icncrt as IconCriterion
Set icncrt = ActiveCell.FormatConditions(1).IconCriteria(Index:=1)

Los siguientes procedimientos se pueden usar para establecer variables de clase IconCriterion : IconSetCondition.IconCriteria y IconCriteria.Item

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos IconCriterion en una colección.

Dim icncrtIconCriteria As IconCriterion
For Each icncrtIconCriteria In ActiveCell.FormatConditions(1).IconCriteria
	
Next icncrtIconCriteria

IconCriteria.Count

Devuelve un valor de tipo Long que especifica el número de criterios de una regla de formato condicional de conjunto de iconos.

El número de criterios es equivalente al número de valores de umbral asignados a un conjunto de iconos.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions(1).IconCriteria.Count

IconCriteria.Item

Devuelve un único objeto IconCriterion de la colección IconCriteria .

El valor del parámetro Index no puede ser mayor que el número de criterios establecidos para un formato condicional de conjunto de iconos.

Sintaxis : expression.Item (Index)

Index: Número de índice del objeto IconCriterion.

Dim icncrtItem As IconCriterion
Set icncrtItem = ActiveCell.FormatConditions(1).IconCriteria(Index:=1)

Icon

Devuelve o especifica el icono para un criterio en una regla de formato condicional de conjunto de iconos.

Valores posibles son xlIcon0Bars - Metro de señal sin barras rellenas, xlIcon0FilledBoxes - Cero cuadros rellenos, xlIcon1Bar - Metro de señal con una barra rellena, xlIcon1FilledBox - Un cuadro relleno, xlIcon2Bars - Metro de señal con dos barras rellenas, xlIcon2FilledBoxes - Dos cuadros rellenos, xlIcon3Bars - Metro de señal con tres barras rellenas, xlIcon3FilledBoxes - Tres cuadros rellenos, xlIcon4Bars - Metro de señal con cuatro barras rellenas, xlIcon4FilledBoxes - Cuatro cuadros rellenos, xlIconBlackCircle - Círculo negro, xlIconBlackCircleWithBorder - Círculo negro con borde, xlIconCircleWithOneWhiteQuarter - Círculo con un cuarto blanco, xlIconCircleWithThreeWhiteQuarters - Círculo con tres cuartos blancos, xlIconCircleWithTwoWhiteQuarters - Círculo con dos cuartos blancos, xlIconGoldStar - Estrella dorada, xlIconGrayCircle - Círculo gris, xlIconGrayDownArrow - Flecha abajo roja, xlIconGrayDownInclineArrow - Flecha inclinada hacia abajo gris, xlIconGraySideArrow - Flecha lateral gris, xlIconGrayUpArrow - Flecha arriba gris, xlIconGrayUpInclineArrow - Flecha inclinada hacia arriba gris, xlIconGreenCheck - Marca de verificación verde, xlIconGreenCheckSymbol - Símbolo de verificación verde, xlIconGreenCircle - Círculo verde, xlIconGreenFlag - Marca verde, xlIconGreenTrafficLight - Semáforo verde, xlIconGreenUpArrow - Flecha arriba verde, xlIconGreenUpTriangle - Triángulo verde hacia arriba, xlIconHalfGoldStar - Media estrella dorada, xlIconNoCellIcon - No hay icono de celda, xlIconPinkCircle - Círculo rosa, xlIconRedCircle - Círculo rojo, xlIconRedCircleWithBorder - Círculo rojo con borde, xlIconRedCross - Cruz roja, xlIconRedCrossSymbol - Signo de cruz roja, xlIconRedDiamond - Rombo rojo, xlIconRedDownArrow - Flecha abajo roja, xlIconRedDownTriangle - Triángulo rojo hacia abajo, xlIconRedFlag - Marca roja, xlIconRedTrafficLight - Semáforo rojo, xlIconSilverStar - Estrella de plata, xlIconWhiteCircleAllWhiteQuarters - Círculo blanco (con todos los cuartos blancos), xlIconYellowCircle - Círculo amarillo, xlIconYellowDash - Guión amarillo, xlIconYellowDownInclineArrow - Flecha inclinada hacia abajo amarilla, xlIconYellowExclamation - Signo de exclamación amarillo, xlIconYellowExclamationSymbol - Signo de exclamación amarillo, xlIconYellowFlag - Marca amarilla, xlIconYellowSideArrow - Flecha lateral amarilla, xlIconYellowTrafficLight - Semáforo amarillo, xlIconYellowTriangle - Triángulo amarillo, xlIconYellowUpInclineArrow - Flecha inclinada hacia arriba amarilla.

Después de establecer la propiedad Icon para el criterio del icono en una regla de formato condicional de conjunto de iconos, la propiedad IconSet del objeto IconSetCondition se cambia a xlCustomSet.

ActiveCell.FormatConditions(1).IconCriteria(1).Icon = xlIcon0Bars

Index

Devuelve un valor de tipo Long que indica el umbral que el criterio representa.

Para un conjunto de iconos, esta propiedad devolverá un valor de 1 para el umbral mínimo, 2 para el siguiente umbral, y así sucesivamente.

Dim lngIndex As Long
lngIndex = ActiveCell.FormatConditions(1).IconCriteria(1).Index

Operator

Devuelve o establece una de las constantes de la enumeración XlFormatConditionOperator , que especifica si el umbral es "mayor que" o "mayor o igual que" el valor del umbral.

En el caso de una regla de formato condicional de conjunto de iconos, esta propiedad sólo se puede establecer en una de las dos constantes siguientes: xlGreater o xlGreaterEqual.

ActiveCell.FormatConditions(1).IconCriteria(1).Operator =

Type

Devuelve una de las constantes de la enumeración XlConditionValueTypes , que especifica cómo se determina el valor de umbral de un conjunto de iconos.

Valores posibles son xlConditionValueAutomaticMax - La barra de datos más larga es proporcional al valor máximo del rango, xlConditionValueAutomaticMin - La barra de datos más corta es proporcional al valor mínimo del rango, xlConditionValueFormula - Se utiliza una fórmula, xlConditionValueHighestValue - Valor más alto de la lista de valores, xlConditionValueLowestValue - Valor más bajo de la lista de valores, xlConditionValueNone - Ningún valor condicional, xlConditionValueNumber - Se utiliza un número, xlConditionValuePercent - Se utiliza un porcentaje, xlConditionValuePercentile - Se utiliza un percentil.

El tipo de valor de umbral de un conjunto de iconos puede ser un número, un porcentaje, una fórmula o un percentil.

ActiveCell.FormatConditions(1).IconCriteria(1).Type = xlConditionValueAutomaticMax

Value

Devuelve o establece el valor de umbral de un icono en un formato condicional.

El valor solo se puede establecer si la propiedad Type del formato condicional está establecida en una de las siguientes constantes XlConditionValueTypes : xlConditionValueNumber, xlConditionValuePercent, ** xlConditionValuePercentile**o xlConditionValueFormula. Si el tipo de umbral es una fórmula, puede establecer la fórmula como un valor de tipo String.

ActiveCell.FormatConditions(1).IconCriteria(1).Value =