ksCreateIterator - Cоздать итератор для перемещения по объектам документа |
Scroll |
Аналог данного метода при использовании API экспортных функций - CreateIterator.
Синтаксис Automation:
BOOL ksCreateIterator (long tipSearch,
long parent);
Входные параметры:
tipSearch |
- тип объекта, |
parent |
- указатель на объект (для движения по группе, внутри макроэлемента, по слою). |
Возвращаемое значение:
TRUE |
- в случае успешного завершения, |
FALSE |
- в случае неудачи. |
Примечание:
1. Для перемещения по документам, видам, группам, слоям parent = 0.
2. Передвижение по объектам документа ("навигация") производится в соответствии с условиями, заданными в специальном блоке параметров. Он содержит тип объектов tipSearch, определяющий режим перемещения (например, по видам, по слоям, по всем объектам, по объектам заданного типа) и указатель комплексного объекта (макроэлемента, контура, группы) при перемещении по составляющим его объектам. Итератор "привязан" к конкретному режиму графического редактора (например, документу, виду), поэтому невозможно использовать один и тот же итератор для навигации в разных видах, штампах и т.п. Итератор сохраняет свое действие до окончания сеанса работы с библиотекой. При переходе внутри библиотечной функции под управление КОМПАС-ГРАФИК после возврата значение всех итераторов будет "сброшено".
3. Итератор работает с атрибутами активного документа.
Подразделы:
(отсутствуют)