DimSelectionSet.addItemByDim

Синтаксис

addItemByDim(dim: PP.Mb.DimSource);

Параметры

dim. Измерение, являющееся объектом метабазы.

Описание

Метод addItemByDim добавляет измерение в коллекцию, являющуюся объектом метабазы.

Комментарии

Метод возвращает объект типа PP.Mb.DimSelection.

Пример

Для выполнения примера необходимо наличие на html-странице экземпляра класса DimSelectionSet с наименованием «dimSelSet» (см. страницу «Конструктор DimSelectionSet»). Очистим коллекцию измерений, а затем назад добавим в неё измерение с ключом 106:

// Получим измерение с ключом 106
var dim;
var item = dimSelSet.getItem(106);
if (item != null) {
    dim = item.getDimension();
};
console.log("Количество измерений до их удаления из коллекции: " + dimSelSet.getItems().length);
// Удалим все отметки из коллекции
dimSelSet.clearItems();
console.log("Количество измерений после их удаления из коллекции: " + dimSelSet.getItems().length);
// Добавим новое измерение в коллекцию
dimSelSet.addItemByDim(dim);
// Получим информацию о всех измерениях в коллекции
for (var i in dimSelSet.getItems()) {
    var dimSelection = dimSelSet.getItems()[i];
    var key = dimSelection.getDimension().getKey();
    var name = dimSelection.getDimension().getName();
    console.log("Ключ добавленного измерения: " + key + ", наименование: " + name);
};

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

Количество измерений до их удаления из коллекции: 5
Количество измерений после их удаления из коллекции: 0
Ключ добавленного измерения: 106, наименование: Календарь

См. также:

DimSelectionSet