Compartilhar via

Como trabalhar com o acesso condicional

  • Artigo

Este tópico discute a classe Open XML SDK ConditionalFormatting e como ela se relaciona com o esquema Open XML File Format SpreadsheetML. Para obter mais informações sobre a estrutura geral das partes e elementos que compõem um documento SpreadsheetML, consulte Estrutura de um documento De planilha**.

Formatação condicional em PlanilhaML

A formatação condicional baseada em células fornece estrutura para dados dentro de uma planilha. Mostrar cores, além de mostrar um valor, ajuda a distinguir a altura relativa desses valores. Há várias opções de formatação que você pode aplicar às células com base no valor delas. Você pode realçar a parte superior ou inferior da maioria dos itens, fornecer barras de dados para mostrar uma interface de usuário do tipo de barra de progresso ou usar dimensionamentos de cores para indicar os altos e baixos. A formatação condicional é aplicável a uma célula em uma planilha diretamente. O valor não precisa fazer parte de uma tabela.

Todas as configurações de formatação condicional são armazenadas no nível da planilha. A planilha armazena um < elemento condicionalFormatting> para cada formato aplicado a uma célula ou série de células. A coleção de células nas quais o formato é aplicado é definida usando o atributo sqref . O atributo sqref especifica um intervalo de células usando a notação 'from:to', por exemplo, 'A1:A10'.

A tabela a seguir lista as classes comuns de SDK Open XML usadas ao trabalhar com a classe ConditionalFormatting .

Elemento SpreadsheetML Classe SDK Open XML
cfRule ConditionalFormattingRule
dataBar DataBar
colorScale ColorScale
Iconset IconSet

Abrir classe de formatação condicional do SDK XML

A classe Open XML SDKConditionalFormatting representa o elemento table (<condicionalFormatting>) definido no esquema Open XML File Format para documentos SpreadsheetML. Use a classe ConditionalFormatting para manipular elementos condicionais individuaisFormatting>< em um documento SpreadsheetML.

As informações a seguir da especificação ISO/IEC 29500 introduzem o elemento ConditionalFormatting (<condicionalFormatting>).

Um Formato Condicional é um formato, como sombreamento de célula ou cor de fonte, que um aplicativo de planilha pode aplicar automaticamente às células se uma condição especificada for verdadeira. Essa coleção expressa regras de formatação condicional aplicadas a uma determinada célula ou intervalo.

Exemplo: este exemplo aplica uma regra 'top10' às células C3:C8. A @dxfId referencia a formatação (definida na parte estilos) a ser aplicada às células que correspondem aos critérios.

    <conditionalFormatting sqref="C3:C8">
        <cfRule type="top10" dxfId="1" priority="3" rank="2"/>
    </conditionalFormatting>

© ISO/IEC29500: 2008.

Classe de regra de formatação condicional

As informações a seguir da especificação ISO/IEC 29500 introduzem o elemento ConditionalFormattingRule (<cfRule>).

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>

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

© ISO/IEC29500: 2008.

Cada formato condicional tem permissão para especificar várias regras de formatação. Você pode aplicar a escala de cores e a formatação da barra de dados ao mesmo tempo, por exemplo. Cada formato condicional é representado usando um elemento cfRule> separado<. Para especificar a prioridade de exibição da interface do usuário, você pode usar o atributo de prioridade . Como um < elemento condicionalFormatting> pode sobrepor outras áreas formatadas na planilha, a prioridade é global para todos os formatos condicionais definidos para essa planilha.

O < elemento cfRule> tem muitos tipos de formatação, como cellIs e top10, que podem ser aplicados. Cada tipo de formatação usa elementos comuns para definir suas configurações. Para obter mais informações sobre atributos de regra de formatação condicional, consulte a especificação ISO/IEC 29500.

Classe Barra de Dados

As informações a seguir da especificação ISO/IEC 29500 introduzem o elemento DataBar (<dataBar>).

Descreve uma regra de formatação condicional da barra de dados.

Exemplo:

Neste exemplo, um formato condicional de barra de dados é expresso, que se espalha por todos os valores de célula no intervalo de células e cuja cor é azul.

    <dataBar>
        <cfvo type="min" val="0"/>
        <cfvo type="max" val="0"/>
        <color rgb="FF638EC6"/>
    </dataBar>

O comprimento da barra de dados para qualquer célula pode ser calculado da seguinte maneira:

Comprimento da barra de dados = minLength + (valor de célula – valor mínimo no intervalo) / (valor máximo no intervalo - valor mínimo no intervalo) * (maxLength - minLength),

em que o comprimento mínimo e máximo são uma porcentagem fixa da largura da coluna (por padrão, 10% e 90% respectivamente.)

A diferença mínima de comprimento (ou quantidade de incremento) é de 1 pixel.

© ISO/IEC29500: 2008.

As barras de dados pegam uma única cor e exibem-na como uma barra. O comprimento da barra indica a altura relativa do valor da célula. Uma barra de dados usa um modelo separado dentro da regra de formatação condicional para definir suas configurações. O < elemento dataBar> armazena todos os dados relevantes. Uma barra de dados requer três configurações: os valores mínimos e máximos para comparar valores de célula e uma cor. O primeiro < elemento cfvo>, ou objeto de valor de formato condicional, define o valor mínimo, os segundo < elementos cfvo> definem o valor máximo. Você pode usar maneiras diferentes de especificar um valor, como usar uma fórmula ou um valor codificado. Outra opção comum é usar os tipos 'min' e 'max'. Esses < tipos de elemento cfvo> especificam os valores mínimos e máximos encontrados no intervalo de células que têm o formato aplicado. Isso fornece um gradiente escalonado limpo entre os itens mais baixos e mais altos. Além disso, você pode especificar a cor da barra de dados usando o < elemento de cor>.

Classe Dimensionamento de Cores

As informações a seguir da especificação ISO/IEC 29500 introduzem o elemento ColorScale (<colorScale>).

Descreve uma escala de cores graduada nesta regra de formatação condicional.

Exemplo:

    <colorScale>
        <cfvo type="min" val="0"/>
        <cfvo type="max" val="0"/>
        <color theme="5"/>
        <color rgb="FFFFEF9C"/>
    </colorScale>

© ISO/IEC29500: 2008.

As escalas de cores fornecem uma exibição que indica o valor relativo entre todos os itens de célula, semelhante a uma barra de dados. Uma escala de cores usa um modelo separado dentro da regra de formatação condicional para definir suas configurações. Você pode especificar até três < valores de elemento cfvo> ou de valor de formato condicional: um para o início da escala, um para o meio da escala e outro para o final da escala. O valor médio é opcional. Além disso, você pode especificar a cor da escala de cores usando o < elemento de cor>.

Classe Conjunto de Ícones

As informações a seguir da especificação ISO/IEC 29500 introduzem o elemento IconSet (<iconSet>).

Descreve uma regra de formatação condicional do conjunto de ícones.

Exemplo: este exemplo demonstra o estilo "3Arrows" dos ícones. O primeiro ícone no conjunto deve ser mostrado se o valor da célula for menor que o percentil 33. O segundo ícone no conjunto deve ser mostrado se o valor da célula for menor que o percentil 67 e maior ou igual ao percentil 33. O terceiro ícone no conjunto deve ser mostrado se o valor da célula for maior ou igual ao percentil 67.

    <iconSet iconSet="3Arrows">
        <cfvo type="percentile" val="0"/>
        <cfvo type="percentile" val="33"/>
        <cfvo type="percentile" val="67"/>
    </iconSet>

© ISO/IEC29500: 2008.

Usando conjuntos de ícones, você pode aplicar diferentes conjuntos de ícones às células que contêm seus dados. O conjunto de ícones usa um intervalo de valores para identificar a qual conjunto de células aplicar a regra de formatação. O primeiro < elemento cfvo> identifica o valor mais baixo do intervalo, o segundo < elemento cfvo>identifica o ponto médio e o terceiro < elemento cfvo> identifica o valor mais alto. Um conjunto de ícones identifica quais ícones devem ser aplicados às células. Você pode escolher entre vários ícones codificados em código. Para obter mais informações sobre quais ícones estão disponíveis, consulte a especificação ISO/IEC 29500.