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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Изображение гиперссылки

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

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

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

Setting the image hyperlink’s AltText fills a similar function as setting an tag in HTML. The text is displayed only if the hyperlinked image is not displayed. (For example, if the image isn’t at the specified location.) If the image of the second hyperlink is not found, the output of the code snippet below would look as follows.

Изображение по URL-адресу не найдено

Гиперссылки ячейки команд

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

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

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

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

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

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

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

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

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

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

Для доступа к существующей гиперссылке:

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

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

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

1. Получите доступ к активному листу.
2. Удалите гиперссылку, используя метод Remove коллекции Hyperlinks.