addRange(range: PP.Ui.TabSheetRange, startCoord: PP.Ui.TabSheetCoord, modifyActive: Boolean, areaType: PP.Ui.TabSheetSelection.AreaType, noRerender: Boolean, fireEvent: Boolean);
range. Определяет диапазон выделения в таблице;
startCoord. Определяет начальную координату выделения;
modifyActive. Признак дополнительного выделения (если равен значению true, то новое выделение будет добавлено к существующему, если false, то старое выделение будет сброшено);
areaType. Определяет тип области выделения;
fireEvent. Определяет, генерировать ли событие выделения. Если параметр равен значению true, то данное событие будет сгенерировано, иначе - не будет;
noRerender. Определяет, нужно ли перерисовывать таблицу. Если параметр равен значению true, то таблица будет перерисована, иначе - не будет.
Метод addRange создает новую область выделения по заданному диапазону ячеек.
Для выполнения примера необходимо наличие на html-странице компонента TabSheet с наименованием «tabSheet» (см. «Пример создания компонента TabSheet»). Выделим диапазон ячеек B1-C2 и добавим кнопку для снятия выделенных областей в таблице:
// Получим объект выделения
var objSelection = tabSheet.getSelection();
// Получим диапазон ячеек по заданным координатам
var range = tabSheet.getRange(1, 2, 2, 1);
// Зададим начальные координаты выделения
var startCoord = tabSheet.coord(1, 2);
// Создадим новую область выделения по заданному диапазону ячеек
objSelection.addRange(range, startCoord, false);
// Добавим кнопку, очищающую выделение в таблице
var clearButton = new PP.Ui.Button({
ParentNode: document.body,
Id: "clearButton",
ResourceKey: "clearButton",
Content: "Снять выделения",
Click: function btnOnClick() {
objSelection.clear();
}
});
В результате выполнения примера был выделен диапазон ячеек B1-C2, а также добавлена кнопка для снятия всех выделенных областей в таблице:
После нажатия на данную кнопку выделение в таблице будет снято:
См. также: