Метод Add (Microsoft Forms)
Добавляет или вставляет вкладку или страницу в TabStrip или MultiPage или добавляет элемент управления с помощью программного идентификатора (ProgID) на страницу или форму.
Синтаксис
Для MultiPage, TabStrip:
Задатьобъект Object = . Add( [ Name [, Caption [, index ]]] )
Для других элементов управления:
ЗадайтеобъектControl = . Add(ProgID [, Name [, Visible ]] )
Синтаксис метода Add состоит из следующих частей:
| Part | Описание |
|---|---|
| object | Обязательно. Допустимое имя объекта. |
| Имя | Необязательный параметр. Задает имя добавляемого объекта. Если имя не указано, система создает имя по умолчанию на основании правил для приложения, в котором используется форма. |
| Caption | Необязательный параметр. Задает подпись, отображаемую на вкладке или элементе управления. Если подпись не указана, система создает подпись по умолчанию на основании правил для приложения, в котором используется форма. |
| index | Необязательный параметр. Обозначает положение на странице или вкладку в коллекции Pages или Tabs. Если индекс не указан, система добавляет страницу или вкладку в конец коллекции Pages или Tabs и назначает подходящее значение индекса. |
| ProgID | Обязательно. Программный идентификатор. Текстовая строка без пробелов, идентифицирующая класс объектов. Стандартный синтаксис progID — <Vendor>.< Компонент>.< Версия>. ProgID сопоставляется с идентификатором класса (CLSID). |
| Visible | Необязательный параметр. Значение true , если объект виден (по умолчанию). Значение false , если объект скрыт. |
Settings
Значения ProgID для отдельных элементов управления:
| Управление | Значение ProgID |
|---|---|
| Флажок | Forms.CheckBox.1 |
| ComboBox | Forms.ComboBox.1 |
| CommandButton | Forms.CommandButton.1 |
| Frame | Forms.Frame.1 |
| Image | Forms.Image.1 |
| Label | Forms.Label.1 |
| ListBox | Forms.ListBox.1 |
| MultiPage | Forms.MultiPage.1 |
| OptionButton | Forms.OptionButton.1 |
| ScrollBar | Forms.ScrollBar.1 |
| SpinButton | Forms.SpinButton.1 |
| TabStrip | Forms.TabStrip.1 |
| TextBox | Forms.TextBox.1 |
| ToggleButton | Forms.ToggleButton.1 |
Замечания
Для элемента управления MultiPage метод Add возвращает объект Page. Для TabStrip он возвращает объект Tab. Значение индекса для первого элемента Page или Tabколлекции равно 0, значение для второго элемента Page или Tab равно 1 и так далее.
Для коллекции Controls объекта метод Add возвращает элемент управления, соответствующий указанному ProgID. После добавления этого элемента управления возникает событие AddControl.
Элемент управления можно добавить в коллекцию Элементов управления пользовательской формы во время разработки, но для этого необходимо использовать свойство Designer библиотеки расширяемости Microsoft Visual Basic для приложений. Свойство Designer возвращает объект UserForm .
Следующий синтаксис возвращает свойство Text заданного элемента управления:
userform1.thebox.text
Если вы добавляете элемент управления во время выполнения, для ссылки на его свойства вам следует использовать восклицательный синтаксис. Например, чтобы возвратить свойство Text элемента управления, добавленного во время выполнения, используйте следующий синтаксис:
userform1!thebox.text
Примечание.
Вы можете изменить свойство Name элемента управления во время выполнения только в том случае, если вы добавили этот элемент управления во время выполнения с помощью метода Add.
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.