ConditionalFormattingRule Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Regra de Formatação Condicional.

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

Quando o objeto é serializado como xml, o 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 a realçar células cujos valores são superiores a 0,5. Tenha em atenção que, neste 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]

Apenas as regras com um valor de atributo de tipo de expressão suportam a sintaxe da fórmula.

Elementos pai
conditionalFormatting (}18.3.1.18)

Elementos filho	Subclautilizar
colorScale (Escala de Cores)	§18.3.1.16
barra de dados (Barra de Dados)	§18.3.1.28
extLst (Área de Armazenamento de Dados de Funcionalidades Futuras)	§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". Este atributo é ignorado se o tipo não for igual a aboveAverage. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
inferior (Inferior N)	Indica se uma regra "superior/inferior n" é uma regra "inferior n". "1" indica "inferior". Este atributo é ignorado se o tipo não for igual ao top10. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
dxfId (ID de Formatação Diferencial)	Este é um índice para um elemento dxf na Peça Estilos que indica a formatação de célula a aplicar quando os critérios da regra de formatação condicional são cumpridos. Os valores possíveis para este atributo são definidos pelo ST_DxfId tipo simples (}18.18.25).
equalAverage (Média Igual)	Sinalizador que indica se os critérios "aboveAverage" e "belowAverage" incluem a própria média ou se são exclusivos desse valor. "1" indica incluir o valor médio nos critérios. Este atributo é ignorado se o tipo não for igual a aboveAverage. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
operador (Operador)	O operador numa regra de formatação condicional "valor da célula é". Este atributo é ignorado se o tipo não for igual a cellIs Os valores possíveis para este atributo são definidos pelo ST_ConditionalFormattingOperator tipo simples (}18.18.15).
percentagem (10% superior)	Indica se uma regra "superior/inferior n" é uma regra de "n% superior/inferior". Este atributo é ignorado se o tipo não for igual ao top10. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
prioridade (Prioridade)	A prioridade desta regra de formatação condicional. Este valor é utilizado para determinar que formato deve ser avaliado e composto. Os valores numéricos mais baixos são de maior prioridade do que os valores numéricos mais elevados, em que "1" é a prioridade mais alta. Os valores possíveis para este atributo são definidos pelo tipo de dados int esquema XML W3C.
classificação (Classificação)	O valor de "n" numa regra de formatação condicional "top/bottom n". Este atributo é ignorado se o tipo não for igual ao top10. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
stdDev (StdDev)	O número de desvios padrão a incluir acima ou abaixo da média na regra de formatação condicional. Este atributo é ignorado se o tipo não for igual a aboveAverage. Se estiver presente um valor para stdDev e o tipo de regra = aboveAverage, esta regra é automaticamente uma regra "acima ou abaixo de N desvios padrão". Os valores possíveis para este atributo são definidos pelo tipo de dados int esquema XML W3C.
stopIfTrue (Parar Se Verdadeiro)	Se este sinalizador for "1", não serão aplicadas regras com prioridade inferior sobre esta regra, quando esta regra for avaliada como verdadeira. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
texto (Texto)	O valor de texto numa regra de formatação condicional "o texto contém". Este atributo é ignorado se o tipo não for igual a containsText. Os valores possíveis para este atributo são definidos pelo tipo de dados de cadeia de esquema W3C XML.
timePeriod (Período de Tempo)	O período de tempo aplicável numa "data que está a ocorrer..." regra de formatação condicional. Este atributo é ignorado se o tipo não for igual a timePeriod. Os valores possíveis para este atributo são definidos pelo ST_TimePeriod tipo simples (}18.18.82).
tipo (Tipo)	Tipo de regra de formatação condicional. Os valores possíveis para este atributo são definidos pelo ST_CfType tipo simples (}18.18.12).

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_CfRule) está localizada em {A.2. nota de fim]

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 subordinados especificados.
ConditionalFormattingRule(OpenXmlElement[])	Inicializa uma nova instância da classe ConditionalFormattingRule com os elementos subordinados 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	Inferior N Representa o seguinte atributo no esquema: inferior
ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
EqualAverage	Média Igual Representa o seguinte atributo no esquema: equalAverage
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro elemento subordinado 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 subordinados. (Herdado de OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os respetivos subordinados. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós subordinados do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir 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 markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
Operator	Operador Representa o seguinte atributo no operador schema:
OuterXml	Obtém a marcação que representa o elemento atual e todos os respetivos elementos subordinados. (Herdado de OpenXmlElement)
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Percent	10% Superior Representa o seguinte atributo no esquema: percentagem
Prefix	Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
Priority	Prioridade Representa o seguinte atributo no esquema: prioridade
Rank	Rank Representa o seguinte atributo no esquema: classificação
StdDev	StdDev Representa o seguinte atributo no esquema: stdDev
StopIfTrue	Parar Se Verdadeiro 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 for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir 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 fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento subordinado 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 subordinados 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 aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados 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 subordinado especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos subordinados 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 é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Regra de Formatação Condicional. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:cfRule. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)