Angular usando planilhas

O Infragistics Angular Excel Enginesworksheet é onde seus dados são guardados. Você pode inserir dados trabalhando com as linhas e células da planilha e definindo seus valores correspondentes. Eleworksheet permite filtrar, ordenar e personalizar os formatos das células, conforme mostrado abaixo.

Angular Using Worksheets Example

O código a seguir mostra as importações necessárias para usar os trechos de código abaixo:

import { Workbook } from "igniteui-angular-excel";
import { Worksheet } from "igniteui-angular-excel";
import { WorkbookFormat } from "igniteui-angular-excel";
import { Color } from "igniteui-angular-core";

import { CustomFilterCondition } from "igniteui-angular-excel";
import { ExcelComparisonOperator } from "igniteui-angular-excel";
import { FormatConditionTextOperator } from "igniteui-angular-excel";
import { OrderedSortCondition } from "igniteui-angular-excel";
import { RelativeIndex } from "igniteui-angular-excel";
import { SortDirection } from "igniteui-angular-excel";
import { WorkbookColorInfo } from "igniteui-angular-excel";

Configuring the Gridlines

As linhas de grade são usadas para separar visualmente as células na planilha. Você pode mostrar ou ocultar as linhas de grade e também alterar suas cores.

Você pode mostrar ou esconder as linhas de grade usando ashowGridlines propriedade dadisplayOptions folha de exercícios. O código a seguir demonstra como você pode ocultar as linhas de grade na sua planilha:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.displayOptions.showGridlines = false;

Você pode configurar a cor das linhas de grade usando agridlineColor propriedadedisplayOptions da folha de exercícios. O código a seguir demonstra como você pode mudar as linhas da grade na sua planilha para ficarem vermelhas:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.displayOptions.gridlineColor = "Red";

Configuring the Headers

Os cabeçalhos de coluna e linha são usados para identificar visualmente colunas e linhas. Eles também são usados para destacar visualmente a célula ou região de célula selecionada no momento.

Você pode mostrar ou esconder os cabeçalhos das colunas e linhas usando ashowRowAndColumnHeaders propriedade dadisplayOptions folha de exercícios. O código a seguir demonstra como você pode ocultar os cabeçalhos de linha e coluna:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.displayOptions.showRowAndColumnHeaders = false;

Configuring Editing of the Worksheet

Por padrão, osworksheet objetos que você salvar serão editáveis. Você pode desativar a edição de uma planilha protegendo-a usando oworksheet método doprotect objeto. Esse método tem muitos argumentos anuláveisbool que determinam quais peças estão protegidas, e uma dessas opções é permitir a edição de objetos, o que, se configurado como falso, impede a edição da planilha.

O código a seguir demonstra como desabilitar a edição na sua planilha:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.protect();

Você também pode usar oworksheet método doprotect objeto para proteger uma planilha contra mudanças estruturais.

Quando a proteção está definida, você pode definir acellFormat propriedade dolocked objeto em células individuais, linhas, regiões de células mescadas ou colunas para sobrescrever a proteção do objeto da planilha nesses objetos. Por exemplo, se você precisar que todas as células de uma planilha sejam somente leitura, exceto as células de uma coluna, você pode proteger a planilha e então definir acellFormat propriedade dolocked objeto como falsa em um objeto específicoWorksheetColumn. Isso permitirá que seus usuários editem células dentro da coluna enquanto desativam a edição das outras células da planilha.

O código a seguir demonstra como você pode fazer isso:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.protect();
worksheet.columns(0).cellFormat.locked = false;

Filtering Worksheet Regions

A filtragem é feita definindo uma condição de filtro em uma folhaWorksheetFilterSettings de exercícios que pode ser recuperada a partir daworksheet propriedade dofilterSettings objeto. As condições do filtro só são reaplicadas quando são adicionadas, removidas, modificadas ou quando oreapplyFilters método é chamado na planilha. Eles não são constantemente avaliados à medida que os dados dentro da região mudam.

Você pode especificar a região para aplicar o filtro usando osetRegion método noWorksheetFilterSettings objeto.

Abaixo está uma lista de métodos e suas descrições que você pode usar para adicionar um filtro a uma planilha:

Método	Descrição
`applyAverageFilter`	Representa um filtro que pode filtrar dados com base no fato de os dados estarem abaixo ou acima da média de todo o intervalo de dados.
`applyDatePeriodFilter`	Representa um filtro que pode filtrar datas em um mês ou trimestre de qualquer ano.
`applyFillFilter`	Representa um filtro que filtrará células com base em seus preenchimentos de fundo. Este filtro especifica um único CellFill. Células com este preenchimento ficarão visíveis no intervalo de dados. Todas as outras células ficarão ocultas.
`ApplyFixedValuesFilter`	Representa um filtro que pode filtrar células com base em valores específicos e fixos, que podem ser exibidos.
`applyFontColorFilter`	Representa um filtro que filtrará células com base em suas cores de fonte. Este filtro especifica uma única cor. Células com esta fonte de cor serão visíveis no intervalo de dados. Todas as outras células serão ocultadas.
`applyIconFilter`	Representa um filtro que pode filtrar células com base em seu ícone de formatação condicional.
`applyRelativeDateRangeFilter`	Representa um filtro que pode filtrar células de data com base em datas relativas a quando o filtro foi aplicado.
`applyTopOrBottomFilter`	Representa um filtro que pode filtrar células na parte superior ou inferior dos valores classificados.
`applyYearToDateFilter`	Representa um filtro que pode filtrar em células de data se as datas ocorrerem entre o início do ano atual e o momento em que o filtro é avaliado.
`applyCustomFilter`	Representa um filtro que pode filtrar dados com base em uma ou duas condições personalizadas. Essas duas condições de filtro podem ser combinadas com uma operação lógica "e" ou uma operação lógica "ou".

Você pode usar o seguinte trecho de código como exemplo para adicionar um filtro a uma região da planilha:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.filterSettings.setRegion("Sheet1!A1:A10");
worksheet.filterSettings.applyAverageFilter(0, AverageFilterType.AboveAverage);

Freezing and Splitting Panes

Você pode congelar linhas na parte superior da sua planilha ou colunas à esquerda usando os recursos de painéis de congelamento. Linhas e colunas congeladas permanecem visíveis o tempo todo enquanto o usuário rola. As linhas e colunas congeladas são separadas do restante da planilha por uma única linha sólida, que não pode ser removida.

Para habilitar o congelamento de painéis, você precisa definir apanesAreFrozen propriedade doworksheet objetodisplayOptions como verdadeira. Você pode então especificar as linhas ou colunas a serem congeladas usando asFrozenRows propriedades eFrozenColumns das opçõesfrozenPaneSettings de exibição, respectivamente.

Você também pode especificar a primeira linha no painel inferior ou a primeira coluna no painel direito usando asFirstRowInBottomPane propriedades e (eFirstColumnInRightPane também), respectivamente.

O trecho de código a seguir demonstra como usar os recursos de congelamento de painéis em uma planilha:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.displayOptions.panesAreFrozen = true;

worksheet.displayOptions.frozenPaneSettings.frozenRows = 3;
worksheet.displayOptions.frozenPaneSettings.frozenColumns = 1;

worksheet.displayOptions.frozenPaneSettings.firstColumnInRightPane = 2;
worksheet.displayOptions.frozenPaneSettings.firstRowInBottomPane = 6;

Setting the Worksheet Zoom Level

Você pode mudar o nível de zoom de cada planilha independentemente usando aMagnificationInNormalView propriedade doworksheet objetodisplayOptions. Essa propriedade recebe um valor entre 10 e 400 e representa a porcentagem de zoom que você deseja aplicar.

O código a seguir demonstra como você pode fazer isso:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.displayOptions.magnificationInNormalView = 300;

Worksheet Level Sorting

A classificação é feita definindo uma condição de classificação em um objeto de nível de planilha em colunas ou linhas. Você pode classificar colunas ou linhas em ordem crescente ou decrescente.

Isso é feito especificando uma região e um tipo de ordenação para osworksheet objetosWorksheetSortSettings que podem ser recuperados usando asortSettings propriedade da folha.

As condições de ordenação em uma planilha só são reaplicadas quando condições de ordenação são adicionadas, removidas, modificadas ou quando oreapplySortConditions método é chamado na planilha. Colunas ou linhas serão ordenadas dentro da região. "Rows" é o tipo padrão de ordenação.

O trecho de código a seguir demonstra como aplicar uma classificação a uma região de células em uma planilha:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.sortSettings.sortConditions().addItem(new RelativeIndex(0), new OrderedSortCondition(SortDirection.Ascending));

Worksheet Protection

Você pode proteger uma planilha chamando oprotect método noworksheet objeto. Esse método expõe muitos parâmetros anuláveisbool que permitem restringir ou permitir as seguintes operações do usuário:

Edição de células.
Edição de objetos como formas, comentários, gráficos ou outros controles.
Edição de cenários.
Filtragem de dados.
Formatação de células.
Inserir, excluir e formatar colunas.
Inserir, excluir e formatar linhas.
Inserção de hiperlinks.
Classificação de dados.
Uso de tabelas dinâmicas.

Você pode remover a proteção da folha de exercícios chamando ounprotect método noworksheet objeto.

O trecho de código a seguir mostra como habilitar a proteção de todas as operações de usuário listadas acima:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

worksheet.protect();

Worksheet Conditional Formatting

Você pode configurar a formatação condicional de umworksheet objeto usando os muitos métodos "Add" expostos naconditionalFormats coleção daquela planilha. O primeiro parâmetro desses métodos "Adicionar" é astring região da planilha à qual você deseja aplicar o formato condicional.

Muitos dos formatos condicionais que você pode adicionar à sua planilha possuem umacellFormat propriedade que determina como osWorksheetCell elementos devem se apresentar quando a condição nesse formato condicional se mantém válida. Por exemplo, você pode usar as propriedades associadas a essacellFormat propriedade, comofill efont para determinar as configurações de fundo e fonte das suas células sob um formato condicional específico, respectivamente.

Existem alguns formatos condicionais que não possuem propriedadecellFormat, pois a visualização deles na célula da planilha se comporta de forma diferente. Esses formatos condicionais são oDataBarConditionalFormat,ColorScaleConditionalFormat, eIconSetConditionalFormat.

Ao carregar um pré-existenteworkbook do Excel, os formatos serão preservados quando eleworkbook for carregado. O mesmo vale quando você salva aworkbook saída em um arquivo Excel.

O exemplo de código a seguir demonstra o uso de formatos condicionais em uma planilha:

var workbook = new Workbook(WorkbookFormat.Excel2007);
var worksheet = workbook.worksheets().add("Sheet1");

var color = new Color();
color.colorString = "Red";

var format = worksheet.conditionalFormats().addAverageCondition("A1:A10", FormatConditionAboveBelow.AboveAverage);
format.cellFormat.font.colorInfo = new WorkbookColorInfo(color);