Работа с рабочими листами GridWeb

Доступ к рабочим листам

В этом разделе обсуждается доступ к листам элемента управления GridWeb. Мы также можем называть эти рабочие листы веб-листами, поскольку они принадлежат GridWeb и используются в веб-приложениях.

Все рабочие листы, содержащиеся в элементе управления GridWeb, хранятся в коллекции GridWorksheetCollection элемента управления GridWeb. Существует простой доступ к конкретному рабочему листу по его индексу листа.

Разработчики могут получить доступ к определенному рабочему листу, указав его индекс листа, как показано ниже в примере фрагмента кода.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing a worksheet using its index
GridWorksheet firstSheet = gridweb.getWorkSheets().get(0);

Удаление рабочего листа

В этом разделе содержится краткая информация об удалении рабочих листов из файлов Excel Microsoft с помощью GridWeb API. Удалите рабочий лист, указав его индекс листа.

Разработчики могут удалить определенный рабочий лист, указав его индекс листа с помощью метода removeAt коллекции GridWorksheetCollection, как показано ниже в примере фрагмента кода.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Get the Worksheets
GridWorksheetCollection gridWorksheetCollection = gridweb.getWorkSheets();
//Remove the first worksheet in the Grid worksheets collection
gridWorksheetCollection.removeAt(0);

Добавление рабочих листов

Рабочие листы являются неотъемлемой частью GridWeb. Все данные управляются и хранятся в виде рабочих листов. GridWeb позволяет разработчикам добавлять один или несколько рабочих листов в элемент управления Aspose.Cells.GridWeb. В этом разделе показаны простые подходы к добавлению листов в GridWeb.

Без указания имени листа

Самый простой способ добавить рабочий лист в Aspose.Cells.GridWeb — вызвать метод добавления класса GridWorksheetCollection в элементе управления GridWeb. При этом создаются рабочие листы с именами по умолчанию (то есть Лист1, Лист2, Лист3 и т. д.) и добавляются в элемент управления GridWeb.

Вывод: рабочий лист с именем по умолчанию добавлен в GridWeb.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Adding a worksheet to GridWeb
int sheetIndex = gridweb.getWorkSheets().add();

С указанным именем листа

Чтобы добавить рабочий лист с определенным именем в элемент управления GridWeb вместо использования схемы именования по умолчанию, вызовите перегруженную версию метода добавления, который принимает указанную строку SheetName. Например, в приведенном ниже примере добавляется рабочий лист с именем Invoice.

Вывод: рабочий лист с указанным именем добавлен в GridWeb.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Adding a worksheet to GridWeb with a specified name
GridWorksheet sheet = gridweb.getWorkSheets().add("Invoice");

Метод add() возвращает индекс нового рабочего листа, который можно использовать для доступа к экземпляру этого рабочего листа. Подробнее о том, как получить доступ к рабочим листам, см.Доступ к рабочим листам.

Переименование рабочего листа

Переименование рабочего листа может быть очень полезным при работе с большим количеством рабочих листов в GridWeb и решении изменить их имена, чтобы сделать их более значимыми. Например, рабочий лист, содержащий счет-фактуру, можно переименовать в «Счет-фактура» вместо «Лист1». В этом разделе описывается эта простая, но полезная функция.

Переименование рабочего листа

Все рабочие листы содержат свойство Name, которое позволяет разработчикам получать доступ к именам рабочих листов или изменять их. Чтобы переименовать рабочий лист:

1. Получите доступ к рабочему листу из коллекции GridWorksheetCollection.
2. Переименуйте выбранный рабочий лист.

Дополнительные сведения о том, как получить доступ к рабочим листам в Aspose.Cells.GridWeb, см.Доступ к рабочим листам.

Перед выполнением кода рабочему листу присваивается имя по умолчанию, например Sheet1.

Входной файл: рабочий лист с именем по умолчанию Sheet1

После запуска кода рабочий лист переименовывается в Invoice.

Вывод: рабочий лист переименовывается в счет-фактуру.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Renaming a worksheet
gridweb.getWorkSheets().get(0).setName("Invoice");

Копирование рабочего листа

Добавление рабочих листовописывает, как добавлять новые рабочие листы в GridWeb. Также можно добавить копию (или реплику) другого рабочего листа в элемент управления Aspose.Cells.GridWeb. Эта функция может быть полезна, когда идентичные или похожие данные на одном листе требуются и на другом листе. В этом случае проще скопировать существующий рабочий лист и добавить его в Aspose.Cells.GridWeb в качестве нового рабочего листа, чем создавать его с нуля.

Использование индекса листа

В приведенном ниже примере кода показано, как добавить копию рабочего листа в элемент управления GridWeb, указав индекс рабочего листа в методе addCopy GridWorksheetCollection.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Adding the copy of a worksheet to GridWeb by specifying its sheet index
int sheetIndex = gridweb.getWorkSheets().addCopy(0);
 

Использование имени листа

В приведенном ниже примере кода показано, как добавить копию рабочего листа в элемент управления GridWeb, указав имя рабочего листа в методе addCopy GridWorksheetCollection.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Adding the copy of a worksheet to GridWeb by specifying its sheet name
int sheetIndex = gridweb.getWorkSheets().addCopy("Sheet1");

Метод addCopy возвращает индекс недавно добавленного рабочего листа, который можно использовать для доступа к экземпляру рабочего листа. Подробнее о том, как получить доступ к рабочим листам, см.Доступ к рабочим листам.

Работа с именованными диапазонами

Обычно метки столбцов и строк используются для уникальной ссылки на ячейки. Но вы можете создавать описательные имена для представления ячеек, диапазонов ячеек, формул или постоянных значений.

Словоимя может относиться к строке символов, представляющей ячейку, диапазон ячеек, формулу или постоянное значение. Например, используйте простые для понимания имена, такие как «Продукты», для обозначения труднопонятных диапазонов, таких как «Продажи!C20:C30».

Метки можно использовать в формулах, которые ссылаются на данные на одном листе; если вы хотите представить диапазон на другом листе, вы можете использовать имя.Именованные диапазоны — одна из самых мощных функций Microsoft Excel.

Пользователи могут присвоить имя диапазону и использовать это имя в формулах. Aspose.Cells.GridWeb поддерживает эту функцию.

Добавление/ссылка на именованные диапазоны в формулах

Элемент управления GridWeb предоставляет два класса (GridName и GridNameCollection) для работы с именованными диапазонами.

Следующий фрагмент кода поможет вам понять, как их использовать.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Clear the Worksheets first
gridweb.getWorkSheets().clear();

//Load an Excel file to the GridWeb which contains a named range i.e. Range1
gridweb.importExcelFile(filePath);

//Apply a formula to a cell that refers to a named range "Range1"
gridweb.getWorkSheets().get(0).getCells().get("G6").setFormula("=SUM(Range1)");

//Add a new named range "MyRange" with based area A2:B5
int index = gridweb.getWorkSheets().getNames().add("MyRange", "Sheet1!A2:B5");
//Get the named range
GridName name = gridweb.getWorkSheets().getNames().get(index);

//Apply a formula to G7 cell
gridweb.getWorkSheets().get(0).getCells().get("G7").setFormula("=Average(MyRange)");
//Calculate the results of the formulas
gridweb.getWorkSheets().calculateFormula();
		
//Save the Excel file
gridweb.saveToExcelFile("AddingNameRangeInFormula.xlsx");

Управление комментариями на листе

В этом разделе обсуждается добавление, доступ и удаление комментариев из рабочих листов. Комментарии полезны для добавления примечаний или полезной информации для пользователей, которые будут работать с таблицей. Разработчики могут добавлять комментарии к любой ячейке рабочего листа.

Работа с комментариями

Добавление комментариев

Чтобы добавить комментарий к рабочему листу, выполните следующие действия:

1. Добавьте элемент управления Aspose.Cells.GridWeb в веб-форму.
2. Получите доступ к рабочему листу, к которому вы добавляете комментарии.
3. Добавьте комментарий к ячейке.
4. Установите примечание для нового комментария.

На рабочий лист добавлен комментарий

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

//Adding comment to "A1" cell of the worksheet
GridComment comment = sheet.getComments().get(sheet.getComments().add("A1"));

//Setting the comment note
comment.setNote("These are my comments for the cell");

Доступ к комментариям

Чтобы получить доступ к комментарию:

1. Доступ к ячейке, содержащей комментарий.
2. Получить ссылку на ячейку.
3. Передайте ссылку на коллекцию комментариев, чтобы получить доступ к комментарию.
4. Теперь можно изменить свойства комментария.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet =  gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

//Accessing a specific cell that contains comment
GridCell cell = sheet.getCells().get("A1");

//Accessing the comment from the specific cell
GridComment comment = sheet.getComments().get(cell.getName());

//Modifying the comment note
comment.setNote("I have modified the comment note.");

Удаление комментариев

Чтобы удалить комментарий:

1. Получите доступ к ячейке, как описано выше.
2. Используйте метод removeAt коллекции Comment, чтобы удалить комментарий.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet =  gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

//Accessing a specific cell that contains comment
GridCell cell = sheet.getCells().get("A1");

//Removing comment from the specific cell
sheet.getComments().removeAt(cell.getName());

Управление гиперссылками на листе

В этом разделе обсуждается, какие типы гиперссылок поддерживаются в Aspose.Cells.GridWeb и как управлять ими программно. Гиперссылки можно использовать либо для создания ссылок на веб-URL-адреса, либо для выполнения обратной передачи на сервер.

Типы гиперссылок

Следующие гиперссылки поддерживаются Aspose.Cells.GridWeb:

• Текстовые URL-гиперссылки, URL-гиперссылки, применяемые к тексту.
• Гиперссылки URL-адресов изображений, гиперссылки URL-адресов, применяемые к изображениям.

Текстовые URL-гиперссылки

В приведенном ниже примере на рабочий лист добавляются две гиперссылки. У одного есть_ пустая цель, в то время как другой установлен на_родитель.

Вывод: текстовые гиперссылки добавлены на лист.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

//Adding hyperlink to the worksheet
String address = "http://www.aspose.com";
int lnkIdx = sheet.getHyperlinks().add("B1", address);
GridHyperlink lnk = sheet.getHyperlinks().get(lnkIdx);

//Setting text of the hyperlink
lnk.setTextToDisplay("Aspose");

//Setting target of the hyperlink
lnk.setTarget("_blank");

//Setting tool tip of the hyperlink
lnk.setScreenTip("Open Aspose Web Site in new window");

//Adding hyperlink to the worksheet
address = "http://www.aspose.com/community/forums/aspose.cells-product-family/19/showforum.aspx";
lnkIdx = sheet.getHyperlinks().add("B2", address);
lnk = sheet.getHyperlinks().get(lnkIdx);

//Setting text of the hyperlink
lnk.setTextToDisplay("Aspose.Grid Technical Support");

//Setting target of the hyperlink
lnk.setTarget("_parent");

//Setting tool tip of the hyperlink
lnk.setScreenTip("Open Aspose.Grid Technical Support in parent window");

Гиперссылки URL-адреса изображения

В приведенном ниже примере гиперссылка URL-адреса изображения добавляется на рабочий лист.

Вывод: гиперссылка на изображение добавлена на лист

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

//Adding hyperlink to the worksheet
String address = "http://www.aspose.com";
int lnkIdx = sheet.getHyperlinks().add("B1", address);
GridHyperlink lnk = sheet.getHyperlinks().get(lnkIdx);

//Setting URL of the image that will be displayed as hyperlink
lnk.setImageURL("Style/AsposeLogo.png");

//Setting target of the hyperlink
lnk.setTarget("_blank");

//Setting tool tip of the hyperlink
lnk.setScreenTip("Open Aspose Web Site in new window");

Сортировка данных

Сортировка — очень ценная функция, когда дело доходит до обработки данных. Несортированные данные доставляют неудобства пользователям при поиске конкретной информации. Aspose.Cells.GridWeb поддерживает мощные функции сортировки. В этом разделе обсуждается сортировка данных с помощью Aspose.Cells.GridWeb API.

Aspose.Cells.GridWeb позволяет разработчикам сортировать данные по горизонтали и вертикали, чтобы разработчики могли сортировать данные сверху вниз или слева направо.

Сверху донизу

Чтобы отсортировать данные сверху вниз:

1. Добавьте элемент управления Aspose.Cells.GridWeb в свою веб-форму.
2. Получите доступ к рабочему листу, который вы хотите отсортировать.
3. Отсортируйте диапазон данных в любом порядке (по возрастанию или по убыванию). Обязательно выберите ориентацию сверху вниз.

В приведенном ниже примере данные в двух столбцах (идентификатор учащегося и имя учащегося) сортируются в порядке возрастания. Только двенадцать строк из двух столбцов сортируются сверху вниз.

Перед применением кода рабочий лист содержит неупорядоченные данные.

Вход: несортированные данные

После выполнения кода данные сортируются в порядке возрастания.

Вывод: данные отсортированы сверху вниз в порядке возрастания

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

int startRow = 1;
int startColumn = 0;
int rows = 12;
int columns = 2;
int index = 0; //This is the index of the column or row which you need to sort
boolean isAsending = true;
boolean isCaseSensitive = false;
boolean islefttoright = false;

//Sorting data in ascending order
sheet.getCells().sort(startRow, startColumn, rows, columns, index, isAsending, isCaseSensitive, islefttoright);

Слева направо

Чтобы отсортировать данные слева направо:

1. Добавьте элемент управления Aspose.Cells.GridWeb в свою веб-форму.
2. Получите доступ к рабочему листу, который вы хотите отсортировать.
3. Отсортируйте диапазон данных в любом порядке (по возрастанию или по убыванию). Обязательно выберите слева направо.

В приведенном ниже примере данные сортируются в двух строках (идентификатор учащегося и имя учащегося) в порядке возрастания. Только две строки из четырех столбцов сортируются слева направо.

Перед применением кода рабочий лист содержит неупорядоченные данные.

Ввод: несортированные данные перед выполнением фрагмента кода

После выполнения кода данные сортируются в порядке возрастания.

Вывод: данные отсортированы слева направо в порядке возрастания

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

//Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = gridweb.getWorkSheets().get(gridweb.getActiveSheetIndex());

int startRow = 0;
int startColumn = 1;
int rows = 2;
int columns = 12;
int index = 0; //This is the index of the column or row which you need to sort
boolean isAsending = true;
boolean isCaseSensitive = false;
boolean islefttoright = true;

//Sorting data in ascending order
sheet.getCells().sort(startRow, startColumn, rows, columns, index, isAsending, isCaseSensitive, islefttoright);

Поиск и замена

Один из самых быстрых способов внести повторяющиеся изменения в большую электронную таблицу — использовать функцию поиска и замены. Поиск помогает найти текстовую строку или данные и заменить их новым значением. Aspose.Cells.GridWeb предоставляет эту функцию. Это позволяет вам искать и заменять определенной текстовой строкой или значением на стороне клиента рабочего листа с помощью простого диалогового окна. Это даже позволяет вам искать частичные данные.

Диалоговое окно «Найти/Заменить»

Диалоговое окно «Найти/Заменить» можно открыть двумя способами:

1. Когда элемент управления активен, нажмитеCTRL+F чтобы открыть диалоговое окно, или нажмитеCTRL+R клавиша для открытия диалога сЗаменять кнопка включена.
2. Переместите курсор в область ячейки на листе, затем щелкните правой кнопкой мыши. ВыбиратьНаходить или жеЗаменять из меню.

Выбор поиска

Отображается диалоговое окно поиска и замены.

Диалоговое окно «Найти/Заменить»

Использование поиска

Искать:

1. Откройте диалоговое окно «Найти/Заменить».
2. Введите строку, которую вы хотите найти, в поле «Найти».
3. Нажмите «Найти далее» для поиска.

Следующая ячейка, соответствующая условию поиска, будет выделена.

Если ваш критерий поиска не найден, отображается диалоговое окно, чтобы сообщить вам об этом.

Параметры поиска

Есть несколько параметров поиска, которые можно настроить в диалоговом окне. В таблице ниже они перечислены.

Нет.	Название опции	Описание
1	Учитывать регистр	Указывает, использовать ли регистр при поиске.
2	Соответствие целому слову	Указывает, следует ли сопоставлять все слово при поиске.
3	Искать вверх	Указывает, будет ли выполняться поиск снизу вверх.
4	Регулярное выражение	Если этот флажок установлен, элемент управления будет обрабатывать строку в текстовом поле «Найти что» как регулярное выражение в процессе поиска.
5	Найти в формулах/значениях	Когда выбраны формулы, элемент управления будет соответствовать формуле или неформатированному значению ячеек, если присутствует формула или неформатированное значение. Когда выбраны значения, элемент управления будет соответствовать только отображаемому значению ячеек.

Использование замены

Чтобы заменить текст или значения:

1. Откройте диалоговое окно «Найти/Заменить», нажавCTRL+F или щелкните правой кнопкой мыши ячейку и выберитеНаходить прежде чем нажатьЗаменять.
2. Введите строку замены в полеЗаменитьполе.
3. НажмитеЗаменять.

Чтобы заменить текст:

1. Откройте диалоговое окно.
2. Введите текст, который вы хотите найти вНайти то, что поле и текст, который вы хотите заменить вЗаменить поле.
3. Замените по одному вхождению, щелкнувНайти следующий с последующимЗаменять.
4. Если вы абсолютно уверены в том, что содержит рабочий лист, щелкнитеЗаменить все.

Если лист не находится в режиме редактирования,Заменять кнопка не отображается.

Добавить/удалить гиперссылки со стороны клиента

Aspose.Cells GridWeb теперь поддерживает добавление и удаление гиперссылок на стороне клиента. Для этого API предоставляет функции «addCelllink» и «delCelllink». Следующие фрагменты кода демонстрируют добавление и удаление гиперссылок на стороне клиента в GridWeb.

Образец кода

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
<script>
    function addLink() {
        var linkinfo = {};
        linkinfo.url = "http://www.aspose.com",
            linkinfo.text = "Link to Aspose Webbsite",
            gridwebinstance.getByIndex(0).rangeupdate(addCelllink, linkinfo);
    }
    function removeLink() {
        gridwebinstance.getByIndex(0).rangeupdate(delCelllink);
    }
</script>

Вы также можете создать ссылку на лист, используя следующий фрагмент кода.

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

linkinfo.url="Sheet4!B8",
linkinfo.text="link to sheet4 B8",
linkinfo.targetsheetindex= 8,
linkinfo.targetcellname="B8"

Обновите настройки шрифта со стороны клиента

Aspose.Cells GridWeb теперь поддерживает изменение настроек шрифта на стороне клиента. Для этого API предоставляет следующие функции

• обновлениеCellFontStyle: Params - r/i/b/ib для обычного/курсивного/жирного/курсивного и&жирного
• updateCellFontSize: Params — имя шрифта и т. д. «Система»
• updateCellFontName: Params - размер шрифта и т.д. ‘12pt’
• обновитьCellFontColor: Params - none/u/l/ul/ для none/underline/strikeout/underline&&strikeout
• обновлениеCellFontLine: Params - цвет html, например #aa22ee, или известное название цвета, например, зеленый, красный,…
• обновитьCellBackGroundColor: Params - цвет html, например #aa22ee, или известное название цвета, например, зеленый, красный,…

В следующем фрагменте кода показано изменение параметров шрифта на стороне клиента в GridWeb.

Образец кода

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
<script>
    function makeFontItalic() {
        gridwebinstance.getByIndex(0).rangeupdate(updateCellFontStyle, "i");
    }
    function makeFontBold() {
        gridwebinstance.getByIndex(0).rangeupdate(updateCellFontStyle, "b");
    }
    function changeFontSize() {
        gridwebinstance.getByIndex(0).rangeupdate(updateCellFontSize, "5pt");
    }
    function changeFontFamily() {
        gridwebinstance.getByIndex(0).rangeupdate(updateCellFontName, "Corbel Light");
    }
    function changeFontColor() {
        gridwebinstance.getByIndex(0).rangeupdate(updateCellFontColor, "green");
    }
    function changeFontBackgroundColor() {
        gridwebinstance.getByIndex(0).rangeupdate(updateCellBackGroundColor, "yellow");
    }
</script>

Добавить/удалить комментарии со стороны клиента

Aspose.Cells GridWeb теперь поддерживает добавление и удаление комментариев на стороне клиента. Для этого в API предусмотрены функции «добавить комментарий» и «удалить комментарий». В следующем фрагменте кода показано добавление и удаление комментариев на стороне клиента в GridWeb.

Образец кода

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
<script>
    function addComment() {
        gridwebinstance.getByIndex(0).addcomments({note:'hello',author:'aspose'});
    }
    function removeComment() {
        gridwebinstance.getByIndex(0).delcomments();
    }
</script>

Показать кнопки для добавления/удаления рабочих листов

Aspose.Cells GridWeb теперь поддерживает добавление и удаление листов с помощью кнопок на панели инструментов. Чтобы кнопки были видны на фронтенде, нужно установитьGridWeb1.ShowAddButton кистинный. В следующем фрагменте кода показано добавление кнопок «Добавить и удалить» на панель инструментов GridWeb.

Образец кода

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java

// Show buttons to add/remove Worksheets
gridweb.setShowAddButton(true);