Поделиться через


Метод Shape.AddRows (Visio)

Добавляет указанное количество строк в раздел Таблицы фигур в указанной позиции.

Синтаксис

выражение. AddRows( _Section_ , _Row_ , _RowTag_ , _RowCount_ )

Выражение Переменная, представляющая объект Shape .

Параметры

Имя Обязательный или необязательный Тип данных Описание
Section Обязательный Integer Раздел, в который добавляются строки.
Row Обязательный Integer Позиция, в которой добавляются строки.
RowTag Обязательный Integer Тип добавляемых строк.
RowCount Обязательный Integer Количество добавляемых строк.

Возвращаемое значение

Целое число

Замечания

Если раздел ShapeSheet не существует, метод AddRows создает раздел с пустыми строками. Новые ячейки в новых строках инициализируются с помощью формул по умолчанию, если применимо. В противном случае программа должна включать инструкции для задания формул для новых ячеек. Если не удается добавить строку, возникает ошибка.

Библиотека типов Visio объявляет константы для RowTag в VisRowIndices.

Константы строк, объявленные библиотекой типов Visio, служат базовыми позициями, с которых начинаются строки раздела. Добавьте смещения в эти константы, чтобы указать первую строку и за ее пределами, например visRowFirst +0, visRowFirst +1 и т. д. Чтобы добавить строки в конце раздела, передайте константу visRowLast для аргумента Row . Возвращаемое значение — фактический индекс строки.

Аргумент RowTag указывает тип добавляемых строк. Передайте visTagDefault (0) в качестве аргумента RowTag , чтобы создать тип строки раздела по умолчанию. Явные теги полезны при добавлении строк в разделы Geometry, Точки подключения и Элементы управления. Описание допустимых типов строк для этих разделов см. в свойстве RowType . Передача недопустимого типа строки приводит к ошибке.

При попытке добавить строки в раздел символа, табуляции или абзаца возникает ошибка.

Метод AddRows не может добавлять именованные строки. Чтобы добавить именованные строки, используйте метод AddNamedRow .

При добавлении строк в раздел с именуемыми строками (например, в разделе Точки подключения или Элементы управления) аргумент Row игнорируется. По умолчанию именованные строки именуются в порядке добавления, например Row_1, Row_2 и т. д. Однако на порядок именования влияют все существующие строки или ранее удаленные строки.

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.