ConditionalFormattingRule Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Regra de formatação condicional.

Essa classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é x:cfRule.

public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

Public Class ConditionalFormattingRule
Inherits OpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

ConditionalFormattingRule

Comentários

[ISO/IEC 29500-1 1st Edition]

cfRule (Regra de Formatação Condicional)

Esta coleção representa uma descrição de uma regra de formatação condicional.

[Exemplo:

Este exemplo mostra uma regra de formatação condicional destacando células cujos valores são maiores que 0,5. Observe que, nesse caso, o conteúdo da <fórmula> é um valor estático, mas também pode ser uma expressão de fórmula.

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

exemplo final]

Somente regras com um valor de atributo de tipo de sintaxe de fórmula de suporte de expressão .

Elementos pai
condicionalFormatting (§18.3.1.18)

Elementos filho	Subclause
colorScale (Dimensionamento de Cores)	§18.3.1.16
dataBar (Barra de Dados)	§18.3.1.28
extLst (Área de Armazenamento de Dados de Recursos Futuros)	§18.2.10
fórmula (Fórmula)	§18.3.1.43
iconSet (Conjunto de Ícones)	§18.3.1.49

Atributos	Descrição
aboveAverage (acima ou abaixo da média)	Indica se a regra é uma regra "acima da média". '1' indica 'acima da média'. Esse atributo será ignorado se o tipo não for igual a aboveAverage. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
inferior (Inferior N)	Indica se uma regra "superior/inferior n" é uma regra "inferior n". '1' indica 'inferior'. Esse atributo será ignorado se o tipo não for igual ao top10. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
dxfId (ID de formatação diferencial)	Este é um índice para um elemento dxf na Parte Estilos indicando qual formatação de célula deve ser aplicada quando os critérios da regra de formatação condicional são atendidos. Os valores possíveis para esse atributo são definidos pelo tipo ST_DxfId simples (§18.18.25).
equalAverage (Média Igual)	Sinalizador indicando se os critérios 'aboveAverage' e 'belowAverage' são inclusivos da própria média ou exclusivos desse valor. '1' indica incluir o valor médio nos critérios. Esse atributo será ignorado se o tipo não for igual a aboveAverage. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
operador (Operador)	O operador em uma regra de formatação condicional "valor de célula é". Esse atributo será ignorado se o tipo não for igual às cellIs Os valores possíveis para esse atributo são definidos pelo tipo ST_ConditionalFormattingOperator simples (§18.18.15).
percentual (10% superior)	Indica se uma regra "superior/inferior n" é uma regra "top/bottom n percent". Esse atributo será ignorado se o tipo não for igual ao top10. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
prioridade (Prioridade)	A prioridade dessa regra de formatação condicional. Esse valor é usado para determinar qual formato deve ser avaliado e renderizado. Valores numéricos mais baixos são prioridade maior do que valores numéricos mais altos, em que '1' é a prioridade mais alta. Os valores possíveis para esse atributo são definidos pelo tipo de dados int do esquema XML W3C.
classificação (Classificação)	O valor de "n" em uma regra de formatação condicional "superior/inferior n". Esse atributo será ignorado se o tipo não for igual ao top10. Os valores possíveis para esse atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
stdDev (StdDev)	O número de desvios padrão a serem incluídos acima ou abaixo da média na regra de formatação condicional. Esse atributo será ignorado se o tipo não for igual a aboveAverage. Se um valor estiver presente para stdDev e o tipo de regra = aboveAverage, essa regra será automaticamente uma regra "acima ou abaixo de N desvios padrão". Os valores possíveis para esse atributo são definidos pelo tipo de dados int do esquema XML W3C.
stopIfTrue (Stop If True)	Se esse sinalizador for '1', nenhuma regra com prioridade inferior será aplicada sobre essa regra, quando essa regra for avaliada como true. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
texto (Texto)	O valor de texto em uma regra de formatação condicional "texto contém". Esse atributo será ignorado se o tipo não for igual a containsText. Os valores possíveis para esse atributo são definidos pelo tipo de dados de cadeia de caracteres W3C XML Schema.
timePeriod (Período de Tempo)	O período de tempo aplicável em uma "data ocorrendo..." regra de formatação condicional. Esse atributo será ignorado se o tipo não for igual ao timePeriod. Os valores possíveis para esse atributo são definidos pelo tipo ST_TimePeriod simples (§18.18.82).
tipo (Tipo)	Tipo de regra de formatação condicional. Os valores possíveis para esse atributo são definidos pelo tipo ST_CfType simples (§18.18.12).

[Observação: a definição de esquema XML W3C do modelo de conteúdo desse elemento (CT_CfRule) está localizada em §A.2. nota final]

ISO/IEC29500: 2008.

Construtores

ConditionalFormattingRule()	Inicializa uma nova instância da classe ConditionalFormattingRule.
ConditionalFormattingRule(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe ConditionalFormattingRule com os elementos filho especificados.
ConditionalFormattingRule(OpenXmlElement[])	Inicializa uma nova instância da classe ConditionalFormattingRule com os elementos filho especificados.
ConditionalFormattingRule(String)	Inicializa uma nova instância da classe ConditionalFormattingRule do XML externo.

Propriedades

AboveAverage	Acima ou abaixo da média Representa o seguinte atributo no esquema: aboveAverage
Bottom	N inferior Representa o seguinte atributo no esquema: inferior
ChildElements	Obtém todos os nós filho do elemento atual. (Herdado de OpenXmlElement)
EqualAverage	Média Igual Representa o seguinte atributo no esquema: equalAverage
ExtendedAttributes	Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro filho do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement)
FormatId	ID de Formatação Diferencial Representa o seguinte atributo no esquema: dxfId
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos filho. (Herdado de OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os seus filhos. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós filho do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último filho do elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de namespace definidas no elemento atual. Retornará um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do namespace do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
Operator	Operador Representa o seguinte atributo no esquema: operador
OuterXml	Obtém a marcação que representa o elemento atual e todos os seus elementos filho. (Herdado de OpenXmlElement)
Parent	Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement)
Percent	Top 10% Representa o seguinte atributo no esquema: percent
Prefix	Obtém o prefixo namespace do elemento atual. (Herdado de OpenXmlElement)
Priority	Prioridade Representa o seguinte atributo no esquema: prioridade
Rank	Rank Representa o seguinte atributo no esquema: rank
StdDev	Stddev Representa o seguinte atributo no esquema: stdDev
StopIfTrue	Parar se true Representa o seguinte atributo no esquema: stopIfTrue
Text	Texto Representa o seguinte atributo no esquema: texto
TimePeriod	Período de tempo Representa o seguinte atributo no esquema: timePeriod
Type	Tipo Representa o seguinte atributo no esquema: tipo
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se ele for uma criança conhecida. Isso adiciona o elemento no local correto de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos até o final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao final da lista de nós filho do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement)
Clone()	Cria uma duplicata do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria uma duplicata desse nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumera todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da marca e o URI do namespace especificados. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento filho no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado dos filhos do elemento atual. (Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual é exibido após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual é exibido antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo namespace no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um uri de namespace no escopo do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver o próximo OpenXmlElement. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós filho do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual de seu pai. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos filho do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento filho especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace do prefixo especificado. Não removerá nada se não houver nenhum prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos filho do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define uma série de atributos para o elemento. Se um atributo for um atributo conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Regra de formatação condicional. Essa classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:cfRule. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)