addItem(source: PP.Rds.Dictionary, settings: Object, setActive: Boolean, replace: Boolean);
source. Загружаемый справочник НСИ;
settings. Настройки для элементов управления справочника. Если не заданы, то используются настройки по умолчанию;
setActive. Признак того, будет ли добавленный справочник активным. Если параметр равен значению true, то справочник будет активным, иначе - неактивным (по умолчанию);
replace. Признак замены справочника, имеющего такой же ключ. Если параметр равен значению true, то справочник НСИ с таким же ключом будет заменён на указанный, иначе - не будет (по умолчанию).
Метод addItem добавляет вкладку с указанным справочником НСИ, либо обновляет справочник с таким же ключом на существующей вкладке.
Метод возвращает значение true в случае добавления новой вкладки; замещённый объект типа PP.Rds.Dictionary в случае обновления справочника НСИ; значение false, если ничего не сделано.
Для выполнения примера необходимо наличие на странице компонента DictionaryBox с наименованием «dictionaryBox» (см. «Пример создания компонента DictionaryBox» ). Очистим все открытые справочники НСИ, а затем добавим в область данных контейнера справочник с ключом 8096. Также обработаем событие ActiveTabChanged и скроем панель истории значений атрибутов, если она отображается, и наоборот - покажем её, если она скрыта:
// Получим справочник НСИ
var source = dictionaryBox.getSource()[0];
// Получим сервис для работы со справочником
var service = source.getPPService();
// Получим область данных справочника
var dataArea = dictionaryBox.getDataArea();
// Очистим все открытые справочники
dataArea.clear();
// Обработаем событие ActiveTabChanged
dataArea.ActiveTabChanged.add(function (sender, args) {
console.log("Текущим стал другой справочник НСИ");
});
// Зададим ключ справочника
var key = 8096;
// Откроем справочник НСИ с ключом 8096
var dimenstionsSource = service.openRds(key, null);
// Добавим открытый справочник в область данных
dataArea.addItem(dimenstionsSource, null, true, true, false);
// Уберём панель с историей значений атрибутов
if (dataArea.getIsHistoryCollapsed(key)) {
dataArea.expandHistory(key);
} else {
dataArea.collapseHistory(key);
};
В результате выполнения примера все загруженные справочники НСИ были очищены и добавлен справочник с ключом 8096. Панель истории значений атрибута скрыта:
В консоли браузера были выведены ключ и идентификатор открытого справочника НСИ, а также в следствие срабатывания обработчика события ActiveTabChanged уведомление об изменении текущего справочника НСИ:
Ключ открытого справочника: 8096
Идентификатор открытого справочника: UNITS_SYSTEMS
Текущим стал другой справочник НСИ
См. также: