---
title: "MoveIterator - Переместить итератор (позиционироваться на объекте)"
type: guide
api: [api7]
tags: [guide, api7, moveiterator]
sources:
  - moveiterator.html
---

*API экспортных функций > Функции работы с графическим документом  > Навигация по графическому документу  > Функции навигации *

Пример...
Аналог данной функции при использовании Automation - метод ksIterator::ksMoveIterator
Синтаксис:
```
reference MoveIterator (reference iterator,
unsigned char type);
Входной параметр:
iterator    - указатель на итератор,
type    - направление перемещения итератора: F - первый объект, N - следующий объект.
Возвращаемое значение:
указатель на объект    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
Функция перемещает текущий указатель итератора (блока параметров навигации) iterator на очередной объект модели. Режим позиционирования (тип объектов, участвующих в поиске) определяется при создании итератора.
При позиционировании на именованную группу она автоматически становится текущей (рабочей). К ней будут относиться операции добавления и исключения объектов (при исключении всех объектов из именованной группы она автоматически удаляется).