GridView.HyperlinkMouseDown

Синтаксис

HyperlinkMouseDown: function(sender, args, timeout);

Параметры

sender. Источник события;

args. Информация о событии. Доступные аргументы: rowIndex - индекс строки ячейки, в которой находится нажатая гиперссылка, colIndex - индекс столбца таблицы данной ячейки, hyperlink - объект гиперссылки со свойствами Action, ActionType, Color, Enable, Target, Text, Underline , event - событие нажатия курсора мыши на гиперссылку;

timeout. Промежуток времени в миллисекундах, через который вызовется событие.

Описание

Событие HyperlinkMouseDown наступает при нажатии на гиперссылку в таблице.

Пример

Для выполнения примера необходимо наличие на html-странице компонента ExpressBox с наименованием «expressBox» (см. «Пример создания компонента ExpressBox») и с загруженной таблицей в рабочей области экспресс-отчета. До выполнения примера таблица экспресс-отчета выглядит так, как показано на странице описания класса GridView.

Создадим гиперссылку, отобразим её в ячейках таблицы и обработаем событие нажатия на них HyperlinkMouseDown:

// Получим таблицу экспресс-отчёта
var gridView = expressBox.getDataView().getGridView();
// Получим таблицу
var tabSheet = gridView.getTabSheet();
// Получим ячейку с координатой (1, 1)
var cell = tabSheet.getCell(new PP.Ui.TabSheetCoord(1, 1));
// Получим стиль ячеек
var style = cell.getStyle();
// Зададим цвет, доступность, стиль, текст, адрес гиперссылки
style.Hyperlink.Color = "#1A3DC1";
style.Hyperlink.Enable = true;
style.Hyperlink.Underline = true;
style.Hyperlink.Text = "Prognoz";
style.Hyperlink.Action = "http://prognoz.ru"
// Отобразим гиперссылки в ячейке
tabSheet.showHyperlinksOnRange(PP.Ui.TabSheetHyperLinkShowType.All,
    tabSheet.getRange(0, 0, 5, 5));
// Перерисуем таблицу
tabSheet.resetRange(tabSheet.getRange(0, 0, 5, 5));
// Обработаем событие HyperlinkMouseDown
tabSheet.HyperlinkMouseDown.add(function (sender, eventArgs) {
    // Выведем информацию о гиперссылке     
    coords = (eventArgs.rowIndex, eventArgs.colIndex);        
    console.log("Координата ячейки с гиперссылкой: (" + eventArgs.rowIndex + "," +
        eventArgs.colIndex + ")");        
    var hyperlink = eventArgs.hyperlink;        
    console.log("Текст: " + hyperlink.Text);        
    console.log("Цвет: " + hyperlink.Color);        
    console.log("Адрес: " + hyperlink.Action);        
    console.log("Режим отображения ссылок: " + tabSheet.getHyperLinkOnRangeShowType(coords));
});

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

При нажатии на гиперссылку в ячейке таблицы будут выведены координаты этой ячейки, цвет, текст и адрес гиперссылки, режим отображения данных ячейки в виде гиперссылки:

Координата ячейки с гиперссылки: (1,1)

Текст: Prognoz

Цвет: #1A3DC1

Адрес: http://prognoz.ru

Режим отображения ссылок: All

См. также:

GridView