ConditionalFormattingRule Classe

Definição

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.SchemaAttr(53, "cfRule")]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr(53, "cfRule")]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr("x14:cfRule")]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr("x14:cfRule")]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)]
public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.SchemaAttr(53, "cfRule")>]
type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr(53, "cfRule")>]
type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("x14:cfRule")>]
type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("x14:cfRule")>]
type ConditionalFormattingRule = class
    inherit TypedOpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010 | DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office.Excel.Formula))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ColorScale), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DataBar), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.IconSet), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.DifferentialType), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.Excel.ExtensionList), DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2010)>]
type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

Public Class ConditionalFormattingRule
Inherits OpenXmlCompositeElement

Public Class ConditionalFormattingRule
Inherits TypedOpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

ConditionalFormattingRule

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

ConditionalFormattingRule

Atributos

ChildElementInfoAttribute OfficeAvailabilityAttribute SchemaAttrAttribute

Comentários

2.6.27 CT_CfRule

Namespace de destino:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

Referenciado por: CT_ConditionalFormatting

Esse tipo complexo especifica uma regra de formatação condicional para um intervalo.

Elementos filho:

XM:F: Elementos F que especificam as fórmulas na regra de formatação condicional. As fórmulas DEVEM seguir a gramática especificada em Fórmulas, com as seguintes restrições:

A fórmula NÃO DEVE estar em conformidade com as regras de produção ref-infix-operator, book-prefix, local-cell-reference, array-constant, bang-reference, bang-name, sheet-range-reference ou structure-reference.

A fórmula NÃO DEVE corresponder à regra de produção de área de folha única.

A tabela a seguir explica como interpretar as fórmulas.

Valor do tipo	Interpretação das fórmulas em f
cellIs	f Elementos que especificam as fórmulas, valores numéricos ou referências de célula que especificam os operandos para o ST_ConditionalFormattingOperator ([ISO/IEC-29500-1] seção 18.18.15) especificado pelo operador. Se o operador for "between" ou "notBetween", f DEVE conter duas fórmulas; caso contrário, f DEVE conter uma fórmula.
expression	Um elemento f que especifica uma fórmula. Quando a fórmula retorna zero, a formatação condicional não é exibida. Quando a fórmula retorna um valor diferente de zero, a formatação condicional é exibida.
colorScale, dataBar, iconSet	Um elemento f que especifica uma fórmula. Quando a fórmula retorna zero, a formatação condicional não é exibida. Quando a fórmula retorna um valor diferente de zero ou não está presente, a formatação condicional é exibida.
containsText, notContainsText, beginsWith, endsWith, containsBlanks, notContainsBlanks, containsErrors, notContainsErrors	Um elemento f que especifica uma fórmula que implementa a operação especificada pelo tipo. Quando a fórmula retorna zero, a formatação condicional não é exibida. Quando a fórmula retorna um valor diferente de zero, a formatação condicional é exibida.

colorScale: Um elemento CT_ColorScale que especifica uma escala de cores.

dataBar: Um elemento CT_DataBar que especifica uma barra de dados.

iconSet: Um elemento CT_IconSet que especifica um conjunto de ícones.

DXF: Um elemento CT_Dxf ([ISO/IEC-29500-4] seção A.2) que especifica a formatação diferencial ([ISO/IEC-29500-1] seção M.2.7.3.8) aplicada ao intervalo. Se o tipo for "colorScale", "dataBar" ou "iconSet", ou o atributo de prioridade não existir, esse elemento NÃO DEVE existir.

extLst: Um elemento CT_ExtensionList ([ISO/IEC-29500-4] seção A.2) que especifica a extensibilidade futura para este elemento.

Atributos:

Tipo: Um atributo ST_CfType ([ISO/IEC-29500-1] seção 18.18.12) que especifica a forma como a formatação condicional é exibida no intervalo.

Se e somente se o tipo for "colorScale", um elemento filho colorScale DEVE existir neste elemento.

Se e somente se type for "dataBar", um elemento filho dataBar DEVE existir neste elemento.

Se e somente se o tipo for "iconSet", um elemento filho iconSet DEVE existir nesse elemento.

Prioridade: Um atributo int ([XMLSCHEMA2] seção 3.3.17) que especifica a prioridade relativa desta regra em comparação com as outras regras nesta planilha (1), ou se esta CT_CfRule especifica informações de extensão para uma regra de barras de dados de formatação condicional, conforme especificado pelo elemento de CT_CfRule associado ([ISO/IEC-29500-4] seção A.2). DEVE ser maior que 0.

Se houver prioridade , as regras serão aplicadas em ordem da menor prioridade para a maior prioridade e NÃO DEVE duplicar um valor de prioridade em qualquer outra CT_CfRule ou elemento CT_CfRule ([ISO/IEC-29500-4] seção A.2) que exista na mesma parte da planilha.

Se a prioridade não existir, esse CT_CfRule especifica informações de extensão para uma regra de barra de dados de formatação condicional e o elemento filho dataBar DEVE existir e descrever essas informações adicionais. O atributo id é usado para identificar o CT_CfRule associado ([ISO/IEC-29500-4] seção A.2), e o atributo de prioridade desta CT_CfRule ([ISO/IEC-29500-4] seção A.2) especifica a prioridade relativa desta regra. Se nem o atributo priority nem o atributo id existirem neste elemento, ou se id existir, mas não existir nenhum elemento CT_CfRule ([ISO/IEC-29500-4] seção A.2) contendo um GUID correspondente, esse registro e o elemento filho dataBar subsequente DEVEM ser ignorados. Se o atributo priority existir neste elemento, id DEVE ser ignorado.

stopIfTrue: Um atributo booleano ([XMLSCHEMA2] seção 3.2.2) que especifica se a avaliação de regras de formatação condicional adicionais será ignorada para uma célula se essa regra for avaliada como "verdadeira" para essa célula.

acima da média: Um atributo booliano ([XMLSCHEMA2] seção 3.2.2) que especifica se a regra de formatação condicional é aplicada a células com valores acima ou abaixo do valor médio de outras células no intervalo, conforme especificado pela tabela a seguir. Esse atributo NÃO DEVE existir se o tipo não for igual a "aboveAverage".

Valor	Significado
"verdadeiro"	A regra de formatação condicional é aplicada às células com valores acima do valor médio de todas as células do intervalo.
"False"	A regra de formatação condicional é aplicada às células com valores abaixo do valor médio de todas as células do intervalo.

porcentagem: Um atributo booliano ([XMLSCHEMA2] seção 3.2.2) que especifica se a regra de formatação condicional é aplicada a uma porcentagem de células, conforme especificado pela tabela a seguir. Este atributo NÃO DEVE existir se o tipo não for igual a "top10".

Valor	Significado
"verdadeiro"	CLASSIFICAÇÃO Especifica a porcentagem de células no intervalo ao qual a formatação condicional é aplicada.
"False"	A regra de formatação condicional é aplicada ao número de células especificado por ordem.

parte inferior: Um atributo booleano ([XMLSCHEMA2] seção 3.2.2) que especifica como a regra de formatação condicional é aplicada, conforme especificado pela tabela a seguir. Este atributo NÃO DEVE existir se o tipo não for igual a "top10".

Valor	Significado
"verdadeiro"	A formatação condicional é aplicada às células cujo valor está na extremidade inferior do intervalo especificado por porcentagem e ordem.
"False"	A formatação condicional é aplicada às células cujo valor está na extremidade superior do intervalo especificado por porcentagem e ordem.

do operador: Um atributo ST_ConditionalFormattingOperator (seção 18.18.15 da ISO/IEC-29500-1) que especifica o tipo de comparação de valor usado para essa regra de formatação condicional. Esse atributo NÃO DEVE existir se o tipo não for igual a "cellIs".

Texto: Um atributo de cadeia de caracteres ([XMLSCHEMA2] seção 3.2.1) que especifica um valor de texto usado para esta regra de formatação condicional. Esse atributo NÃO DEVE existir se o tipo não for igual a "beginsWith", "containsText", "endsWith" ou "notContainsText".

timePeriod: Um atributo ST_TimePeriod ([ISO/IEC-29500-1] seção 18.18.82) que especifica o período de tempo usado para esta regra de formatação condicional. Este atributo NÃO DEVE existir se o tipo não for igual a "timePeriod".

Classificação: Um atributo unsignedInt ([XMLSCHEMA2] seção 3.3.22) que especifica quantas células são formatadas por esta regra de formatação condicional. O valor de porcentagem especifica se a classificação é uma porcentagem ou uma quantidade de células. Quando porcentagem é "verdadeira", a classificação DEVE ser maior ou igual a zero e menor ou igual a 100. Caso contrário, a classificação DEVE ser maior ou igual a 1 e menor ou igual a 1.000. Este atributo NÃO DEVE existir se o tipo não for igual a "top10".

stdDev: Um atributo int ([XMLSCHEMA2] seção 3.3.17) que especifica o número de desvios padrão acima ou abaixo da média para formatar na regra de formatação condicional. Este atributo NÃO DEVE existir se o tipo não for igual a "aboveAverage" ou se equalAverage for "true".

equalAverage: Um atributo booliano ([XMLSCHEMA2] seção 3.2.2) que especifica, juntamente com aboveAverage, como a regra de formatação condicional é aplicada, conforme especificado pela tabela a seguir. Esse atributo NÃO DEVE existir se o tipo não for igual a "aboveAverage".

Valor de equalAverage	Valor de aboveAverage	Significado
"verdadeiro"	"verdadeiro"	A formatação condicional é aplicada às células cujo valor é igual ou superior ao valor médio das células no intervalo.
"verdadeiro"	"False"	A formatação condicional é aplicada às células cujo valor é igual ou inferior ao valor médio das células no intervalo.
"False"	"verdadeiro"	A formatação condicional é aplicada às células cujo valor está acima do valor médio de todas as células do intervalo mais stdDev e multiplicado pelo desvio padrão de todas as células do intervalo.
"False"	"False"	A formatação condicional é aplicada às células cujo valor está abaixo do valor médio de todas as células do intervalo menos stdDev e multiplicado pelo desvio padrão de todas as células do intervalo.

activePresent: Um atributo booleano ([XMLSCHEMA2] seção 3.2.2) que DEVE ser "verdadeiro" se, e somente se, uma fórmula estiver presente em f e o tipo for "colorScale", "dataBar" ou "iconSet".

Identificação: Um atributo ST_Guid ([ISO/IEC-29500-1] seção 22.9.2.4) que identifica esta regra de formatação condicional. Se o atributo de prioridade não existir e esse atributo existir, esse atributo será usado para combinar esse elemento CT_CfRule com o elemento CT_CfRule correspondente ([ISO/IEC-29500-4] seção A.2). Se nem o atributo de prioridade nem esse atributo existirem, esse CT_CfRule e seu elemento de CT_DataBar filho DEVEM ser ignorados.

O seguinte fragmento do esquema XML do W3C ([XMLSCHEMA1] seção 2.1) especifica o conteúdo desse tipo complexo.

<xsd:complexType name="CT_CfRule">

<xsd:sequência>

<xsd:element ref="xm:f" minOccurs="0" maxOccurs="3"/>

<xsd:element name="colorScale" type="CT_ColorScale" minOccurs="0" maxOccurs="1"/>

<xsd:element name="dataBar" type="CT_DataBar" minOccurs="0" maxOccurs="1"/>

<xsd:element name="iconSet" type="CT_IconSet" minOccurs="0" maxOccurs="1"/>

<xsd:element name="dxf" type="x:CT_Dxf" minOccurs="0" maxOccurs="1"/>

<xsd:element name="extLst" type="x:CT_ExtensionList" minOccurs="0" maxOccurs="1"/>

</xsd:sequência>

<xsd:attribute name="type" type="x:ST_CfType" use="optional"/>

<xsd:attribute name="priority" type="xsd:int" use="optional"/>

<xsd:attribute name="stopIfTrue" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="aboveAverage" type="xsd:boolean" use="optional" default="true"/>

<xsd:attribute name="percent" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="bottom" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="operator" type="x:ST_ConditionalFormattingOperator" use="optional"/>

<xsd:attribute name="text" type="xsd:string" use="optional"/>

<xsd:attribute name="timePeriod" type="x:ST_TimePeriod" use="optional"/>

<xsd:attribute name="rank" type="xsd:unsignedInt" use="optional"/>

<xsd:attribute name="stdDev" type="xsd:int" use="optional"/>

<xsd:attribute name="equalAverage" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="activePresent" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="id" type="x:ST_Guid" use="optional"/>

</xsd:complexType>

Consulte a seção 5.4 para obter o esquema XML completo do W3C ([XMLSCHEMA1] seção 2.1).