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

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

Работа с гиперссылками

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

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

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

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

Добавление гиперссылок

URL гиперссылки

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

Существуют различные типы URL-гиперссылок:

• Текстовые гиперссылки.
• Гиперссылки на изображения.

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

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

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

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

ПРИМЕЧАНИЕ. Цель гиперссылки может быть установлена на_ себя,_top или _parent для открытия URL-адресов в новом, текущем или верхнем окне соответственно.

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adds a text hyperlink that goes to Aspose site and opens in new window
int linkIndex = sheet.Hyperlinks.Add("B1", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting text and tool tip of the hyperlink
link1.TextToDisplay = "Aspose";
link1.ScreenTip = "Open Aspose Web Site in new window";
 
// Adding hyperlink to the worksheet to open in parent window
linkIndex = sheet.Hyperlinks.Add("B2", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_parent";

// Setting text and tool tip of the hyperlink
link2.TextToDisplay = "Aspose.Grid Docs";
link2.ScreenTip = "Open Aspose.Grid Docs in parent window";

Гиперссылки изображений

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

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

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

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

Не удалось найти изображение для URL-адреса изображения

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B5", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting Image URL and tool tip of hyperlink
link1.ImageURL = "../Images/Aspose.Banner.gif";
link1.ScreenTip = "Open Aspose Web Site in new window";

// Adding hyperlink to the worksheet
linkIndex = sheet.Hyperlinks.Add("B6", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_blank";

// Setting URL, tool tip and alt text of hyperlink
link2.ImageURL = "../Images/Aspose.Grid.gif";
link2.ScreenTip = "Open Aspose.Grid Docs in new window";
link2.AltText = "Open Aspose.Grid Docs in new window";

// Resize the rows to display image nicely
sheet.Cells.SetRowHeight(4, 40);
sheet.Cells.SetRowHeight(5, 40);

Cell Командные гиперссылки

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

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

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

На рабочий лист добавлена гиперссылка команды ячейки.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B8", "");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];

// Setting the cell command, tool tip and image URL for the hyperlink
link1.Command = "Click";
link1.ScreenTip = "Click Here";
link1.ImageURL = "../Images/button.jpg";

// Resize the row to display image nicely
sheet.Cells.SetRowHeight(7, 30);

Обработка событий командных гиперссылок Cell

Разработчикам необходимо создать обработчик событий для события CellCommand элемента управления GridWeb, чтобы выполнять определенные задачи при щелчке гиперссылки на конкретную команду ячейки. Обработчик событий CellCommand предоставляет объект типа CellEventArgs, который предлагает свойство Argument. Используйте свойство Argument, чтобы определить конкретную гиперссылку, сравнив ее значение CellCommand.

В приведенном ниже примере создается обработчик событий для гиперссылки команды ячейки, созданной в приведенном выше коде. CellCommand гиперссылки был установлен на Click. Итак, в обработчике события сначала проверьте его, а затем добавьте код, который отображает сообщение в ячейке A6.

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

Вывод: текст добавляется в ячейку A6 при нажатии на гиперссылку

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Event Handler for CellCommand event
protected void GridWeb1_CellCommand(object sender, Aspose.Cells.GridWeb.CellEventArgs e)
{
    // Checking the CellCommand of the hyperlink
    if (e.Argument.Equals("Click"))
    {
        // Accessing the reference of the worksheet that is currently active
        GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

        // Adding value to "C8" cell
        sheet.Cells["C8"].PutValue("Cell Command Hyperlink Clicked");

        // Resize the column to display message nicely
        sheet.Cells.SetColumnWidth(2, 250);
    }
}

Доступ к гиперссылкам

Чтобы получить доступ к существующей гиперссылке:

1. Получите доступ к ячейке, которая его содержит.
2. Получить ссылку на ячейку.
3. Передайте ссылку в метод GetHyperlink коллекции Hyperlinks, чтобы получить доступ к гиперссылке.
4. Измените свойства гиперссылки.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accessing a specific cell that contains hyperlink
GridCell cell = sheet.Cells["B1"];

// Accessing the hyperlink from the specific cell
GridHyperlink link = sheet.Hyperlinks.GetHyperlink(cell);

if (link != null)
{
    // Modifying the text and URL of hyperlink
    link.TextToDisplay = "Aspose.Blogs";
    link.Address = "http://www.aspose.com/Community/Blogs";
} 

Удаление гиперссылок

Чтобы удалить гиперссылку:

1. Доступ к активному рабочему листу.
2. Удалите гиперссылку с помощью метода Remove коллекции Hyperlinks.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
            
// Removing hyperlink from the specific cell         
sheet.Hyperlinks.Remove(new Data.GridCellArea() {StartRow = 0, EndRow = 0, StartColumn = 1, EndColumn = 1});