Formatação condicional no Excel

Microsoft Office Excel permite que você organize seus dados de texto em um formato de planilha ou pasta de trabalho. Você pode trazer informações e dados de vários arquivos e locais para um único destino, para que eles sejam processados e analisados em um único arquivo. Defina vários tons de cor, negrito, itálico na planilha do Excel para destacar dados importantes. Você pode selecionar um esquema de cores apropriado para uma análise rápida. Especificados abaixo estão os usos comuns de arquivos do Excel

  • Entrada e armazenamento de dados
  • Coleta e Verificação de Dados Comerciais
  • Tarefas administrativas e gerenciais
  • Contabilidade e orçamento
  • Análise de dados
  • Relatórios + Visualizações
  • Previsão

Formatação Condicional

A formatação condicional é um recurso em muitos aplicativos de planilha. Ela permite que você aplique formatação específica a células que atendem a certos critérios. Ela é mais frequentemente usada como formatação baseada em cores para destacar, enfatizar ou diferenciar entre dados e informações armazenadas em uma planilha. Se as condições forem falsas, o intervalo de células não será formatado. Como exemplo, você pode ter números abaixo de mil na cor vermelha e números acima de mil na cor azul.

Abaixo estão as visualizações de formatação condicional populares disponíveis

  • Sombreamento de cor de fundo (das células)
  • Sombreamento de cor de primeiro plano (de fontes)
  • Barras de dados
  • Ícones (que têm 4 tipos de imagens diferentes)
  • Valores

Os tópicos especificados abaixo são elaborados com mais detalhes

Obter formatação condicional da planilha

O Aspose.Cells Cloud fornece os recursos para ler informações de formatação condicional de planilhas do Excel. O método GetWorksheetConditionalFormattings da API permite que você leia os detalhes de formatação da planilha do Excel. O primeiro passo é gerar um token JWT com base em seu ID de cliente e segredo de cliente personalizados. Para obter mais informações, visite Como obter o token JWT usando uma chave de ID de cliente e segredo de cliente

O comando cURL é mostrado abaixo, o que ajuda a ler detalhes de formatação de uma planilha do Excel

curl -X GET "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

C# .NET

// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/
CellsApi instance = new CellsApi(clientId, clientSecret, apiVersion, testbaseurl);
string name = BOOK1;
string sheetName = SHEET1;
string folder = TEMPFOLDER;
instance.UploadFile(folder + @"\" + name, File.Open( @"C:\TestData\" +name));
var response = instance.CellsConditionalFormattingsGetWorksheetConditionalFormattings(name, sheetName, folder);
Assert.IsInstanceOf<ConditionalFormattingsResponse>(response, "response is ConditionalFormattingsResponse");
Assert.AreEqual(response.Code, 200);

Adicionar formatação condicional

O Microsoft Excel oferece três predefinições para Formatação Condicional, Barras de Dados, Escalas de Cores e Conjuntos de Ícones, e a API Aspose.Cells Cloud oferece suporte a todos esses tipos. Especifique diferentes parâmetros da condição, incluindo Tipo, Operador, Estilo, Área da Célula, etc.

comando cURL

curl -X PUT "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings?cellArea=C4%3AC6" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"link\": { \"Href\": \"string\", \"Rel\": \"string\", \"Title\": \"string\", \"Type\": \"string\" }, \"Priority\": 2, \"Type\": \"CellValue\", \"StopIfTrue\": true, \"AboveAverage\": { \"IsAboveAverage\": true, \"IsEqualAverage\": true, \"StdDev\": 0 }, \"ColorScale\": { \"MaxCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MaxColor\": { \"A\": 100, \"R\": 200, \"G\": 200, \"B\": 0 }, \"MidCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MidColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"MinCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MinColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 } }, \"DataBar\": { \"AxisColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"AxisPosition\": \"string\", \"BarBorder\": { \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"Type\": \"string\" }, \"BarFillType\": \"string\", \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"Direction\": \"string\", \"MaxCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MaxLength\": 0, \"MinCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MinLength\": 0, \"NegativeBarFormat\": { \"BorderColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"BorderColorType\": \"string\", \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"ColorType\": \"string\" }, \"ShowValue\": true }, \"Formula1\": \"string\", \"Formula2\": \"string\", \"IconSet\": { \"CfIcons\": [ { \"ImageData\": \"string\", \"Index\": 0, \"Type\": \"string\" } ], \"Cfvos\": [ { \"IsGTE\": true, \"Type\": \"string\" } ], \"IsCustom\": true, \"Reverse\": true, \"ShowValue\": true, \"IconSetType\": \"string\" }, \"Operator\": \"string\", \"Style\": { \"link\": { \"Href\": \"string\", \"Rel\": \"string\", \"Title\": \"string\", \"Type\": \"string\" }, \"Font\": { \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"DoubleSize\": 0, \"IsBold\": true, \"IsItalic\": true, \"IsStrikeout\": true, \"IsSubscript\": true, \"IsSuperscript\": true, \"Name\": \"string\", \"Size\": 0, \"Underline\": \"string\" }, \"Name\": \"string\", \"CultureCustom\": \"string\", \"Custom\": \"string\", \"BackgroundColor\": { \"A\": 220, \"R\": 10, \"G\": 120, \"B\": 0 }, \"ForegroundColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"IsFormulaHidden\": true, \"IsDateTime\": true, \"IsTextWrapped\": true, \"IsGradient\": true, \"IsLocked\": true, \"IsPercent\": true, \"ShrinkToFit\": true, \"IndentLevel\": 0, \"Number\": 0, \"RotationAngle\": 0, \"Pattern\": \"None\", \"TextDirection\": \"Context\", \"VerticalAlignment\": \"Center\", \"HorizontalAlignment\": \"General\", \"BorderCollection\": [ { \"LineStyle\": \"string\", \"Color\": { \"A\": 120, \"R\": 0, \"G\": 0, \"B\": 0 }, \"BorderType\": \"BottomBorder\", \"ThemeColor\": { \"ColorType\": \"string\", \"Tint\": 0 }, \"ArgbColor\": -16777216 } ], \"BackgroundThemeColor\": { \"ColorType\": \"string\", \"Tint\": 0 }, \"ForegroundThemeColor\": { \"ColorType\": \"string\", \"Tint\": 0 } }, \"Text\": \"string\", \"TimePeriod\": \"string\", \"Top10\": { \"IsBottom\": true, \"IsPercent\": true, \"Rank\": 0 }}"

O trecho de código C# abaixo adiciona a formatação condicional na planilha do Excel:

C# .NET

// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Cells-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet

CellsApi cellsApi = new CellsApi(AppKey, AppSid);
string name = "BOOK1.xlsx";
string sheetName = "SHEET1";
string cellArea = "A1:C10";
FormatCondition formatcondition = new FormatCondition();
formatcondition.Type = "CellValue";
formatcondition.Operator = "Between";
formatcondition.Formula1 = "10";
formatcondition.Formula2 = "20";
var color = new Color();
color.A = 1;
color.R = 132;
color.G = 157;
color.B = 204;
Style style = new Style();
style.BackgroundColor = color;
formatcondition.Style = style;
string folder = "TEMPFOLDER";
var response = cellsApi.CellsConditionalFormattingsPutWorksheetConditionalFormatting(name, sheetName, cellArea, formatcondition, folder);

Limpar toda a formatação condicional

O Aspose.Cells Cloud permite que você limpe a formatação da formatação condicional. O método DeleteWorksheetConditionalFormattings fornece a você a alavancagem para limpar a formatação condicional de uma planilha do Excel. O comando cURL fornecido abaixo pode ser usado para cumprir esse requisito

comando cURL

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

C# .NET

// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/
CellsApi instance = new CellsApi(clientId, clientSecret, apiVersion, testbaseurl);
string name = BOOK1;
string sheetName = SHEET1;
string folder = TEMPFOLDER;
instance.UploadFile(folder + @"\" + name, File.Open( @"C:\TestData\" +name));
var response = instance.CellsConditionalFormattingsDeleteWorksheetConditionalFormattings(name, sheetName, folder);
Assert.IsInstanceOf<CellsCloudResponse>(response, "response is CellsCloudResponse");
Assert.AreEqual(response.Code, 200);

O método acima remove toda a formatação condicional e se você quiser remover qualquer formatação específica, tente usar o método DeleteWorksheetConditionalFormatting. Este método aceita o número de índice para condições de formatação em uma planilha do Excel.

O comando abaixo remove a formatação condicional no índice 1 (onde o valor do índice começa em 0).

comando cURL

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings/1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
Formatação removida da planilha.

Imagem 1:- Formatação removida da planilha do Excel.

Remover formatação condicional para determinada área

Se você precisar remover a formatação condicional de uma área específica, use o método DeleteWorksheetConditionalFormattingArea. Precisamos especificar as informações startRow, startColumn, totalRows e totalColumns para cumprir os requisitos. Observe que os índices de linha e coluna começam com 0.

comando cURL

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings/area?startRow=4&startColumn=1&totalRows=3&totalColumns=1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

Conclusão

O Aspose.Cells Cloud API é um produto incrível e oferece os recursos para criar, manipular e transformar arquivos MS Excel e OpenOffice sheet em outros formatos suportados. Não é necessária a instalação do produto.

Para obter mais informações, visite Página inicial do Aspose.Cells Cloud. E para obter informações sobre a instalação e configuração de SDKs específicos de linguagem de programação, visite Como instalar SDKs do Aspose.Cloud.