Возвращает карту идентификаторов элементов в виде ключей и состояний отметки флажками в виде значений.
Краткое описание
shape.getItemsCheckState([int whichItems]);
Параметр
| Параметр | Описание |
| shape | Имя объекта |
| whichItems | Определяет тип возвращаемых элементов. Доступны следующие опции: TREE_LEAVES => Возвращаются только конечные элементы (по умолчанию) TREE_NODES => Возвращаются только узлы Параметры так же могут объединяться => (TREE_LEAVES | TREE_NODES) |
Описание
Функция getItemsCheckState возвращает карту идентификаторов элементов в виде ключей и состояния отметки флажками в виде значений. Значения могут быть следующими:
- 0 => Элемент не отмечен
- 1 => Элемент отмечен
- 2 => Элемент не отмечен, однако отмечен один или несколько дочерних узлов
- 3 => Элемент отмечен, однако один или несколько дочерних узлов не отмечены
ПРИМЕР
На примере ниже в родительский узел «WHOLE NAME» иерархического списка «TREE1» добавляются несколько элементов. После этого для всех элементов устанавливается состояние «отмечаемый флажком». С помощью функции «checkState» все узлы и конечные элементы копируются в карту распределения, которая затем выводится в средство просмотра журналов.
| main() { //Добавить три столбца TREE1.addColumn(«SURNAME»); TREE1.addColumn(«FIRST NAME»); TREE1.addColumn(«ADDRESS»); //Добавить элемент «WHOLE NAME» TREE1.appendItemNC(«»,»WHOLE NAME»,»WHOLE_NAME»); //Добавить три конечных элемента в список «WHOLE NAME» TREE1.appendItemNC(«WHOLE NAME»,»MUELLER»,»Mueller»); TREE1.appendItemNC(«WHOLE NAME»,»SCHMIDT»,»Schmidt»); TREE1.appendItemNC(«WHOLE NAME»,»KAUFMANN»,»Kaufmann»); //Задать текст для столбца узла конечных элементов «NAME» TREE1.setText(«MUELLER»,1,»Maria»); TREE1.setText(«SCHMIDT»,1,»Anna»); TREE1.setText(«KAUFMANN»,1,»Jan»); //Задать текст для столбца узла конечных элементов «ADDRESS» TREE1.setText(«MUELLER»,2,»Hauptstr. 1″); TREE1.setText(«SCHMIDT»,2,»Wienerstr. 10″); TREE1.setText(«KAUFMANN»,2,»Nebenstr. 100″); // Установить опцию отметки флажком для элементов TREE1.setCheckable(«WHOLE NAME»,true); TREE1.setCheckable(«MUELLER»,true); TREE1.setCheckable(«SCHMIDT»,true); TREE1.setCheckable(«KAUFMANN»,true); } … checkState() { DebugN(TREE1.getItemsCheckState(TREE_LEAVES|TREE_NODES)); // Создание карты всех узлов и конечных элементов дерева TREE1 и вывод карты в средство просмотра журналов. } |
Связь с другими элементами
Иерархический список
См. также
«autoCheckParent», «getCheckedItems», «getCheckState», «isCheckable», «isChecked», «setChecked», «setCheckable», «setAllChecked», «getUncheckedItems»