addRange(range: PP.Ui.TabSheetRange, startCoord: PP.Ui.TabSheetCoord, modifyActive: Boolean, areaType: PP.Ui.TabSheetSelectionAreaType, 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, а также добавлена кнопка для снятия всех выделенных областей в таблице:
После нажатия на данную кнопку выделение в таблице будет снято:
См. также: