Novedades de la API de JavaScript de Excel 1.6

Formato condicional

Presenta el formato condicional de un rango. Permite los siguientes tipos de formato condicional.

  • Escala de colores
  • Barra de datos
  • Conjunto de iconos
  • Personalizado

Además:

  • Devuelve el intervalo en el que se aplica el formato condicional.
  • Eliminación del formato condicional.
  • Proporciona prioridad y stopifTrue capacidad.
  • Obtiene la colección de todo el formato condicional de un intervalo determinado.
  • Borra todos los formatos condicionales activos en el intervalo actual especificado.

Lista de API

En la tabla siguiente se enumeran las API en el conjunto de requisitos de API de JavaScript de Excel 1.6. Para ver la documentación de referencia de API para todas las API compatibles con el conjunto de requisitos de API de JavaScript de Excel 1.6 o anterior, consulte API de Excel en el conjunto de requisitos 1.6 o anterior.

Clase Campos Descripción
Application suspendApiCalculationUntilNextSync() Suspende el cálculo hasta que se llama al siguiente context.sync() .
CellValueConditionalFormat format Devuelve un objeto de formato, que encapsula los formatos condicionales fuente, relleno, bordes y otras propiedades.
regla Especifica el objeto de regla en este formato condicional.
ColorScaleConditionalFormat criteria Los criterios de la escala de colores.
threeColorScale Si true, la escala de colores tendrá tres puntos (mínimo, punto medio, máximo), de lo contrario tendrá dos (mínimo, máximo).
ConditionalCellValueRule Fórmula1 La fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional.
fórmula2 La fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional.
operator Operador del formato condicional del valor de celda.
ConditionalColorScaleCriteria maximum El punto máximo del criterio de escala de colores.
Punto medio El punto medio del criterio de escala de colores, si la escala de colores es una escala de 3 colores.
minimum El punto mínimo del criterio de escala de colores.
ConditionalColorScaleCriterion color Representación de código de color HTML del color de escala de colores (por ejemplo, #FF0000 representa el rojo).
formula Un número, una fórmula o null (si type es lowestValue).
type En qué se debe basar la fórmula condicional de criterio.
ConditionalDataBarNegativeFormat borderColor Código de color HTML que representa el color de la línea de borde, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
fillColor Código de color HTML que representa el color de relleno, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
matchPositiveBorderColor Especifica si la barra de datos negativos tiene el mismo color de borde que la barra de datos positiva.
matchPositiveFillColor Especifica si la barra de datos negativos tiene el mismo color de relleno que la barra de datos positiva.
ConditionalDataBarPositiveFormat borderColor Código de color HTML que representa el color de la línea de borde, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
fillColor Código de color HTML que representa el color de relleno, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
gradientFill Especifica si la barra de datos tiene un degradado.
ConditionalDataBarRule formula La fórmula, si es necesario, sobre la que se evaluará la regla de la barra de datos.
type El tipo de regla de la barra de datos.
ConditionalFormat valor de celda Devuelve las propiedades de formato condicional del valor de la celda si el formato condicional actual es un CellValue tipo.
cellValueOrNullObject Devuelve las propiedades de formato condicional del valor de la celda si el formato condicional actual es un CellValue tipo.
escala de color Devuelve las propiedades de formato condicional de escala de colores si el formato condicional actual es un ColorScale tipo.
colorScaleOrNullObject Devuelve las propiedades de formato condicional de escala de colores si el formato condicional actual es un ColorScale tipo.
personalizada Devuelve las propiedades de formato condicional personalizadas si el formato condicional actual es un tipo personalizado.
customOrNullObject Devuelve las propiedades de formato condicional personalizadas si el formato condicional actual es un tipo personalizado.
dataBar Devuelve las propiedades de la barra de datos si el formato condicional actual es una barra de datos.
dataBarOrNullObject Devuelve las propiedades de la barra de datos si el formato condicional actual es una barra de datos.
delete() Elimina este formato condicional.
getRange() Devuelve el intervalo en el que se aplica el formato condicional.
getRangeOrNullObject() Devuelve el rango al que se aplica el formato condicional.
iconSet Devuelve las propiedades de formato condicional del conjunto de iconos si el formato condicional actual es un IconSet tipo.
iconSetOrNullObject Devuelve las propiedades de formato condicional del conjunto de iconos si el formato condicional actual es un IconSet tipo.
id La prioridad del formato condicional en el archivo .SRoe actual ConditionalFormatCollection
Valor predeterminado Devuelve el formato condicional de los criterios preestablecidos.
presetOrNullObject Devuelve el formato condicional de los criterios preestablecidos.
prioridad La prioridad (o índice) dentro de la colección de formato condicional en la que existe actualmente este formato condicional.
stopIfTrue Si se cumplen las condiciones de este formato condicional, los formatos de menor prioridad no surtirán efecto en esa celda.
textComparison Devuelve las propiedades de formato condicional de texto específico si el formato condicional actual es un tipo de texto.
textComparisonOrNullObject Devuelve las propiedades de formato condicional de texto específico si el formato condicional actual es un tipo de texto.
topBottom Devuelve las propiedades de formato condicional superior e inferior si el formato condicional actual es un TopBottom tipo.
topBottomOrNullObject Devuelve las propiedades de formato condicional superior e inferior si el formato condicional actual es un TopBottom tipo.
type Un tipo de formato condicional.
ConditionalFormatCollection add(type: Excel.ConditionalFormatType) Agrega un nuevo formato condicional a la colección en la prioridad primera/superior.
clearAll() Borra todos los formatos condicionales activos en el intervalo actual especificado.
getCount() Devuelve el número de formatos condicionales del libro.
getItem(id: string) Devuelve un formato condicional para el identificador especificado.
getItemAt(index: number) Devuelve un formato condicional en el índice especificado.
items Obtiene los elementos secundarios cargados en esta colección.
ConditionalFormatRule formula La fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional.
formulaLocal La fórmula, si es necesario, en la que se evaluará la regla de formato condicional en el idioma del usuario.
formulaR1C1 La fórmula, si es necesario, sobre la que evaluar la regla de formato condicional en notación de estilo R1C1.
ConditionalIconCriterion customIcon Si es diferente del conjunto de iconos predeterminado, se devolverá el icono personalizado del criterio actual.null
formula Número o fórmula en función del tipo.
operator greaterThan o para greaterThanOrEqual cada uno de los tipos de regla para el formato condicional del icono.
type Elemento en el que se debe basar la fórmula condicional de icono.
ConditionalPresetCriteriaRule criterio El criterio del formato condicional.
ConditionalRangeBorder color Código de color HTML que representa el color de la línea de borde, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
sideIndex Valor constante que indica el lado específico del borde.
estilo Una de las constantes de estilo de línea que especifica el estilo de línea del borde.
ConditionalRangeBorderCollection bottom Obtiene el borde inferior.
count Número de objetos de borde de la colección.
getItem(index: Excel.ConditionalRangeBorderIndex) Obtiene un objeto de borde mediante su nombre.
getItemAt(index: number) Obtiene un objeto de borde mediante su índice.
items Obtiene los elementos secundarios cargados en esta colección.
left Obtiene el borde izquierdo.
right Consigue el borde correcto.
top Obtiene el borde superior.
ConditionalRangeFill clear() Restablece el relleno.
color Código de color HTML que representa el color del relleno, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
ConditionalRangeFont bold Especifica si la fuente está en negrita.
clear() Restablece los formatos de fuente.
color Representación de código de color HTML del color del texto (por ejemplo, #FF0000 representa el rojo).
italic Especifica si la fuente es cursiva.
strikethrough Especifica el estado de tachado de la fuente.
underline El tipo de subrayado aplicado a la fuente.
ConditionalRangeFormat borders Colección de objetos de borde que se aplican al rango de formato condicional general.
fill Devuelve el objeto de relleno definido en el rango de formato condicional general.
font Devuelve el objeto de fuente definido en el rango de formato condicional general.
numberFormat Representa el código de formato de número de Excel para un rango determinado.
ConditionalTextComparisonRule operator Operador del formato condicional de texto.
text El valor de texto del formato condicional.
ConditionalTopBottomRule rank El rango entre 1 y 1000 para los rangos numéricos o entre 1 y 100 para los rangos porcentuales.
type Aplique formato a los valores según la clasificación superior o inferior.
CustomConditionalFormat format Devuelve un objeto de formato, que encapsula los formatos condicionales fuente, relleno, bordes y otras propiedades.
regla Especifica el Rule objeto en este formato condicional.
DataBarConditionalFormat axisColor Código de color HTML que representa el color de la línea del eje, en la forma #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
axisFormat Representación de cómo se determina el eje para una barra de datos de Excel.
barDirection Especifica la dirección en la que se debe basar el gráfico de barras de datos.
lowerBoundRule La regla de lo que constituye el límite inferior (y cómo calcularlo, si procede) de una barra de datos.
formato negativo Representación de todos los valores a la izquierda del eje en una barra de datos de Excel.
positiveFormat Representación de todos los valores a la derecha del eje en una barra de datos de Excel.
showDataBarOnly Si true, oculta los valores de las celdas en las que se aplica la barra de datos.
upperBoundRule Regla de lo que constituye el límite superior (y cómo calcularlo, si es aplicable) de una barra de datos.
IconSetConditionalFormat criteria Una matriz de criterios y conjuntos de iconos para las reglas y posibles iconos personalizados para los iconos condicionales.
reverseIconOrder Si true, invierte el orden de los iconos del conjunto de iconos.
showIconOnly Si true, oculta los valores y solo muestra los iconos.
estilo Si se establece, muestra la opción de conjunto de iconos para el formato condicional.
PresetCriteriaConditionalFormat format Devuelve un objeto de formato, que encapsula los formatos condicionales fuente, relleno, bordes y otras propiedades.
regla Regla del formato condicional.
Rango calculate() Calcula un rango de celdas en una hoja de cálculo.
conditionalFormats La colección de ConditionalFormats eso cruza la cordillera.
TextConditionalFormat format Devuelve un objeto de formato, que encapsula la fuente, el relleno, los bordes y otras propiedades del formato condicional.
regla Regla del formato condicional.
TopBottomConditionalFormat format Devuelve un objeto de formato, que encapsula la fuente, el relleno, los bordes y otras propiedades del formato condicional.
regla Los criterios del formato condicional superior/inferior.
Worksheet calculate(markAllDirty: boolean) Calcula todas las celdas de una hoja de cálculo.

Vea también