Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
stopifTruecapacidad. - 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. |