ConditionalFormattingRule Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Spreadsheet

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Regla de formato condicional.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es x:cfRule.

public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

Public Class ConditionalFormattingRule
Inherits OpenXmlCompositeElement

Herencia

Object

OpenXmlElement

OpenXmlCompositeElement

ConditionalFormattingRule

Comentarios

[ISO/IEC 29500-1 1.ª edición]

cfRule (regla de formato condicional)

Esta colección representa una descripción de una regla de formato condicional.

[Ejemplo:

En este ejemplo se muestra una regla de formato condicional que resalta las celdas cuyos valores son superiores a 0,5. Tenga en cuenta que, en este caso, el contenido de <la fórmula> es un valor estático, pero también puede ser una expresión de fórmula.

<conditionalFormatting sqref="E3:E9">  
  <cfRule type="cellIs" dxfId="0" priority="1" operator="greaterThan">  
    <formula>0.5</formula>  
  </cfRule>  
</conditionalFormatting>  

Fin del ejemplo]

Solo las reglas con un valor de atributo de tipo de expresión admiten la sintaxis de fórmula.

Elementos primarios
conditionalFormatting (§18.3.1.18)

Elementos secundarios	Subclause
colorScale (Escala de colores)	§18.3.1.16
dataBar (barra de datos)	§18.3.1.28
extLst (Área de almacenamiento de datos de características futuras)	§18.2.10
fórmula (fórmula)	§18.3.1.43
iconSet (conjunto de iconos)	§18.3.1.49

Atributos	Descripción
aboveAverage (por encima o por debajo de la media)	Indica si la regla es una regla "por encima del promedio". '1' indica 'por encima de la media'. Este atributo se omite si el tipo no es igual a aboveAverage. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
inferior (N inferior)	Indica si una regla "top/bottom n" es una regla "bottom n". '1' indica 'abajo'. Este atributo se omite si el tipo no es igual a top10. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
dxfId (identificador de formato diferencial)	Se trata de un índice de un elemento dxf en la parte Estilos que indica qué formato de celda se aplicará cuando se cumplan los criterios de regla de formato condicional. Los valores posibles para este atributo se definen mediante el ST_DxfId tipo simple (§18.18.25).
equalAverage (igual promedio)	Marca que indica si los criterios "aboveAverage" y "belowAverage" incluyen el promedio en sí o excluyen ese valor. '1' indica que se debe incluir el valor medio en los criterios. Este atributo se omite si el tipo no es igual a aboveAverage. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
operador (operador)	El operador de una regla de formato condicional "el valor de celda es". Este atributo se omite si el tipo no es igual a cellIs. Los valores posibles para este atributo se definen mediante el ST_ConditionalFormattingOperator tipo simple (§18.18.15).
porcentaje (10 por ciento superior)	Indica si una regla "top/bottom n" es una regla "top/bottom n percent". Este atributo se omite si el tipo no es igual a top10. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
priority (Priority)	Prioridad de esta regla de formato condicional. Este valor se usa para determinar qué formato se debe evaluar y representar. Los valores numéricos más bajos son más prioritarios que los valores numéricos superiores, donde "1" es la prioridad más alta. Los valores posibles para este atributo se definen mediante el tipo de datos int del esquema XML de W3C.
rank (Rank)	Valor de "n" en una regla de formato condicional "top/bottom n". Este atributo se omite si el tipo no es igual a top10. Los valores posibles para este atributo los define el tipo de datos unsignedInt del esquema XML W3C.
stdDev (StdDev)	Número de desviaciones estándar que se van a incluir por encima o por debajo del promedio en la regla de formato condicional. Este atributo se omite si el tipo no es igual a aboveAverage. Si hay un valor para stdDev y el tipo de regla = aboveAverage, esta regla es automáticamente una regla "por encima o por debajo de N desviaciones estándar". Los valores posibles para este atributo se definen mediante el tipo de datos int del esquema XML de W3C.
stopIfTrue (Stop If True)	Si esta marca es "1", no se aplicará ninguna regla con prioridad inferior sobre esta regla, cuando esta regla se evalúe como true. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
text (Texto)	El valor de texto de una regla de formato condicional "text contains". Este atributo se omite si type no es igual a containsText. El tipo de datos string del esquema XML W3C define los valores posibles para este atributo.
timePeriod (período de tiempo)	El período de tiempo aplicable en una "fecha que se produce..." regla de formato condicional. Este atributo se omite si el tipo no es igual a timePeriod. Los valores posibles para este atributo se definen mediante el ST_TimePeriod tipo simple (§18.18.82).
type (Type)	Tipo de regla de formato condicional. Los valores posibles para este atributo se definen mediante el ST_CfType tipo simple (§18.18.12).

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_CfRule) se encuentra en §A.2. Fin de la nota]

ISO/IEC29500: 2008.

Constructores

ConditionalFormattingRule()	Inicializa una nueva instancia de la clase ConditionalFormattingRule.
ConditionalFormattingRule(IEnumerable<OpenXmlElement>)	Inicializa una nueva instancia de la clase ConditionalFormattingRule con los elementos secundarios especificados.
ConditionalFormattingRule(OpenXmlElement[])	Inicializa una nueva instancia de la clase ConditionalFormattingRule con los elementos secundarios especificados.
ConditionalFormattingRule(String)	Inicializa una nueva instancia de la clase ConditionalFormattingRule a partir de XML externo.

Propiedades

AboveAverage	Por encima o por debajo de la media Representa el atributo siguiente en el esquema: aboveAverage
Bottom	Inferior N Representa el atributo siguiente en el esquema: bottom
ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
EqualAverage	Promedio igual Representa el atributo siguiente en el esquema: equalAverage
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement actual. (Heredado de OpenXmlCompositeElement)
FormatId	Identificador de formato diferencial Representa el atributo siguiente en el esquema: dxfId
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlCompositeElement)
InnerText	Obtiene o establece los valores concatenados del nodo actual y todos sus elementos secundarios. (Heredado de OpenXmlCompositeElement)
InnerXml	Obtiene o establece el marcado que representa solo los nodos secundarios del nodo actual. (Heredado de OpenXmlCompositeElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlCompositeElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
Operator	Operador Representa el atributo siguiente en el esquema: operador
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Percent	10 por ciento superior Representa el atributo siguiente en el esquema: percent
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
Priority	Prioridad Representa el atributo siguiente en el esquema: priority
Rank	Jerarquia Representa el atributo siguiente en el esquema: rank
StdDev	StdDev Representa el atributo siguiente en el esquema: stdDev
StopIfTrue	Detener si es True Representa el atributo siguiente en el esquema: stopIfTrue
Text	Texto Representa el atributo siguiente en el esquema: text
TimePeriod	Período de tiempo Representa el atributo siguiente en el esquema: timePeriod
Type	Tipo Representa el atributo siguiente en el esquema: type
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Agrega el elemento especificado al elemento si es un elemento secundario conocido. Esto agrega el elemento en la ubicación correcta según el esquema. (Heredado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado de los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado. (Heredado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza uno de los elementos secundarios del elemento actual por otro elemento OpenXmlElement. (Heredado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Regla de formato condicional. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es x:cfRule. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)