Russian (Русский) - Change language

Объектная модель

Ниже описаны особенности используемой объектной модели.

Работа с коллекциями

Все коллекции в используемой объектной модели поддерживают следующие методы:

Название Тип Доступ Описание
Count int Read only Число элементов коллекции.
Item( index : int ) ItemInterface Read only Получение элемента коллекции с заданным индексом. Нумерация начинается с нуля.

Замечание. К методам коллекции можно обращаться без метода Item, используя вместо этого круглые или квадратные скобки в зависимости от выбранного языка скрипта. В языках JScript, VBScript и Visual Basic.Net используются круглые скобки, в языке C#.Net допустимо использование только квадратных скобок, язык JScript.Net допускает использование как круглых, так и квадратных скобок. Например,

Items( 1 ).Text = "Hello" или Items[ 1 ].Text = "Hello"
    

Все коллекции могут использоваться в конструкциях типа for each.

Работа с повторяющимися полями и таблицами

Все поля документа, кроме таблиц, могут быть повторяющимися.

В структуре документа повторяющие поля представлены специальным полем-прототипом, имеющим ненулевую коллекцию Items.

Поле-прототип не имеет дочерних элементов и у него нет значения. Оно служит только для хранения множества повторений этого поля. Дочерние поля и/или значение поля присущи лишь повторениям поля, доступным через метод Items объекта IField.

Таблицы всегда имеют коллекцию Rows (Items является ее синонимом). В этой коллекции содержатся строки таблицы, ячейки которых можно получить через метод Children строк объекта IField.

Формирование путей к полям

Методы Field, HasField и IndexedItemValue объекта IDocument используют в качестве параметра пути к полям на форме. Эти пути строятся по следующему принципу (в форме Бэкуса-Наура):

<Путь> ::= <Компонент_пути> | <Путь> "\" <Компонент_пути>

<Компонент_пути > ::= <Имя_поля> | <Имя_поля> "["<Номер повторения поля>"]"

, где Имя_поля – имена полей документов, как они заданы в определении документа, а Номер_повторения_поля – номер повторения повторяющегося поля (для таблиц это номер строки), начиная с нуля.

Путь может быть полным или относительным. Полные пути строятся, начиная с имени раздела документа, относительные – начиная с имени дочернего элемента в группе.

Например, обращение к третьей строке колонки "Total" в таблице "Table", расположенной в разделе "Section", записывается следующим образом:

"Section\Table[2]\Total"
    

Метод FullName объекта IField позволяет построить такое полное имя.

10.11.2020 12:08:08


Please leave your feedback about this article