removeItems(isDispose: Boolean);
isDispose. Определяет, удалять ли элементы полностью. Допустимые значения:
true. Элементы панели инструментов будут полностью удалены (по умолчанию);
false. Элементы панели инструментов будут скрыты.
Метод removeItems удаляет все дочерние элементы панели инструментов.
Для выполнения примера необходимо наличие на html-странице ссылок на файлы сценария PP.js и файл стилей PP.css, в теге <body> html-страницы элемента <div> с идентификатором «toolBar». В событии onload тега <body> необходимо указать вызов функции createToolBar(). Добавим на страницу панель инструментов с двумя группами кнопок и реализуем обработчик события StateChanged:
var toolBar;
function createToolBar() {
// Создаем контейнер
toolBar = new PP.Ui.ToolBar({
// Устанавливаем родительский элемент
ParentNode: "toolBar",
// Устанавливаем размеры
Width: 250,
// Устанавливаем видимость кнопки меню со скрытыми кнопками
ShowOverflowButton: true,
// Убираем отступ между элементами группы
IsSplitGroups: false,
// Обработчик события изменения состояния элемента панели инструментов
StateChanged: function (sender, args) {
console.log("Изменилось состояние элемента с содержимым: " + args.Item.getContent());
}
});
// Добавляем две группы кнопок
toolBar.beginUpdate();
for (var i = 0; i < 3; i++) {
toolBar.addItem(new PP.Ui.ToolBarButton({ Content: "Кнопка " + (i+1), GroupName: "Группа1" }));
}
for (var i = 4; i < 7; i++) {
toolBar.addItem(new PP.Ui.ToolBarButton({ Content: "Кнопка " + (i+1), GroupName: "Группа2" }));
}
toolBar.endUpdate();
}
В результате мы получим панель инструментов с двумя группами кнопок. Также панель инструментов будет содержать кнопку меню со скрытыми элементами. Вторая группа кнопок будет полностью скрыта:
При нажатии на кнопку в консоль будет выводиться сообщение об изменение состояния элемента панели инструментов:
Изменилось состояние кнопки с содержимым: Кнопка 1
Удаляем третью кнопку из первой группы:
// Получаем третью кнопку из первой группы и удаляем ее из группы
var button = toolBar._Groups["Группа1"].pop();
// Обновляем первую группу кнопок
toolBar.refreshGroup("Группа1");
В результате третья кнопка не будет принадлежать первой группе:
Вставляем третью кнопку во вторую группу:
// Вставляем третью кнопку во вторую группу toolBar._Groups["Группа2"].push(button); // Обновляем все группы toolBar.refreshGroups();
В результате третья кнопка будет принадлежать ко второй группе.
Устанавливаем отступ между элементами групп:
toolBar.setIsSplitGroups(true); // Обновляем видимость элементов toolBar.refreshItemsVisibility();
В результате все элементы будут разделены между собой:
Удаляем все элементы панели инструментов:
// Удаляем все элементы панели инструментов toolBar.removeItems();
В результате панель управления не будет содержать элементов.
См. также: