Novedades de la API de JavaScript de Excel 1.6

  • Artículo

Formato condicional

Presenta el formato condicional de un intervalo. 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 funcionalidad.
  • 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 del conjunto de requisitos de la 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 la API de JavaScript de Excel 1.6 o versiones anteriores, 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 llame al siguiente context.sync() .
CellValueConditionalFormat format Devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes y otras propiedades de los formatos condicionales.
Regla Especifica el objeto de regla en este formato condicional.
ColorScaleConditionalFormat criteria Criterios de la escala de colores.
threeColorScale Si truees , 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 Fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional.
fórmula2 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.
Puntomedio Punto medio del criterio de escala de colores, si la escala de colores es una escala de tres colores.
minimum Punto mínimo del criterio de escala de colores.
ConditionalColorScaleCriterion color Representación del código de color HTML del color de escala de colores (por ejemplo, #FF0000 representa Rojo).
formula Un número, una fórmula o null (si type es lowestValue).
type En qué se debe basar la fórmula condicional del criterio.
ConditionalDataBarNegativeFormat borderColor Código de color HTML que representa el color de la línea de borde, con el formato #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 el formulario #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja").
matchPositiveBorderColor Especifica si la barra de datos negativa tiene el mismo color de borde que la barra de datos positiva.
matchPositiveFillColor Especifica si la barra de datos negativa 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, con el formato #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 el formulario #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 Fórmula, si es necesario, en la que se va a evaluar la regla de barra de datos.
type Tipo de regla de la barra de datos.
ConditionalFormat cellValue Devuelve las propiedades de formato condicional del valor de celda si el formato condicional actual es un CellValue tipo.
cellValueOrNullObject Devuelve las propiedades de formato condicional del valor de celda si el formato condicional actual es un CellValue tipo.
colorScale 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.
Personalizado Devuelve las propiedades de formato condicional personalizado si el formato condicional actual es un tipo personalizado.
customOrNullObject Devuelve las propiedades de formato condicional personalizado 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 intervalo al que se aplica el formato conditonal.
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 Prioridad del formato condicional en el objeto actual ConditionalFormatCollection.
Preset Devuelve el formato condicional de los criterios preestablecidos.
presetOrNullObject Devuelve el formato condicional de los criterios preestablecidos.
Prioridad 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íficas si el formato condicional actual es un tipo de texto.
textComparisonOrNullObject Devuelve las propiedades de formato condicional de texto específicas 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 Tipo de formato condicional.
ConditionalFormatCollection add(type: Excel.ConditionalFormatType) Agrega un nuevo formato condicional a la colección con la prioridad primera o 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 Fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional.
formulaLocal Fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional en el idioma del usuario.
formulaR1C1 Fórmula, si es necesario, en la que se va a evaluar la regla de formato condicional en la notación de estilo R1C1.
ConditionalIconCriterion customIcon El icono personalizado para el criterio actual, si es diferente del conjunto de iconos predeterminado, se devolverá.null
formula Número o fórmula en función del tipo.
operator greaterThan o greaterThanOrEqual para cada uno de los tipos de regla para el formato condicional de icono.
type Elemento en el que se debe basar la fórmula condicional de icono.
ConditionalPresetCriteriaRule Criterio Criterio del formato condicional.
ConditionalRangeBorder color Código de color HTML que representa el color de la línea de borde, con el formato #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 Obtiene el borde derecho.
top Obtiene el borde superior.
ConditionalRangeFill clear() Restablece el relleno.
color Código de color HTML que representa el color del relleno, en el formulario #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 del código de color HTML del color de texto (por ejemplo, #FF0000 representa Rojo).
italic Especifica si la fuente está en cursiva.
strikethrough Especifica el estado de tachado de la fuente.
underline Tipo de subrayado aplicado a la fuente.
ConditionalRangeFormat borders Colección de objetos de borde que se aplican al intervalo de formato condicional general.
fill Devuelve el objeto de relleno definido en el intervalo de formato condicional general.
font Devuelve el objeto de fuente definido en el intervalo de formato condicional general.
numberFormat Representa el código de formato de número de Excel para el intervalo especificado.
ConditionalTextComparisonRule operator Operador del formato condicional de texto.
text 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 Dar formato a los valores en función de la clasificación superior o inferior.
CustomConditionalFormat format Devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes y otras propiedades de los formatos condicionales.
Regla Especifica el Rule objeto en este formato condicional.
DataBarConditionalFormat axisColor Código de color HTML que representa el color de la línea Axis, en el formato #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 la barra de datos.
lowerBoundRule Regla para lo que constituye el límite inferior (y cómo calcularlo, si procede) para una barra de datos.
negativeFormat 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 truees , oculta los valores de las celdas donde 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 Matriz de criterios y conjuntos de iconos para las reglas y posibles iconos personalizados para iconos condicionales.
reverseIconOrder Si truees , invierte los pedidos de icono para el conjunto de iconos.
showIconOnly Si truees , oculta los valores y solo muestra iconos.
estilo Si se establece, muestra la opción de conjunto de iconos para el formato condicional.
PresetCriteriaConditionalFormat format Devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes y otras propiedades de los formatos condicionales.
Regla Regla del formato condicional.
Range calculate() Calcula un rango de celdas en una hoja de cálculo.
conditionalFormats La colección de ConditionalFormats que interseca el intervalo.
TextConditionalFormat format Devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes y otras propiedades del formato condicional.
Regla Regla del formato condicional.
TopBottomConditionalFormat format Devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes y otras propiedades del formato condicional.
Regla Criterios del formato condicional superior e inferior.
Worksheet calculate(markAllDirty: boolean) Calcula todas las celdas de una hoja de cálculo.

Vea también