OptionButton.GroupName Property (Outlook Forms Script)OptionButton.GroupName Property (Outlook Forms Script)

Возвращает или задает строку , определяющую группу взаимно исключающих элементов управления OptionButton .Returns or sets a String that identifies a group of mutually exclusive OptionButton controls. Для чтения и записи.Read/write.

СинтаксисSyntax

Expression. GroupNameexpression.GroupName

Expression (выражение ) Переменная, представляющая объект OptionButton .expression A variable that represents an OptionButton object.

ПримечанияRemarks

Используйте один и тот же параметр GroupName для всех кнопок в группе.Use the same GroupName for all buttons in the group. Параметр по умолчанию — пустая строка.The default setting is an empty string.

Чтобы создать группу взаимно исключающих элементов управления OptionButton , можно поместить кнопки в рамку в форме или использовать свойство GroupName .To create a group of mutually exclusive OptionButton controls, you can put the buttons in a Frame on your form, or you can use the GroupName property. Вариант с использованием свойства GroupName более эффективен по следующим причинам:GroupName is more efficient for the following reasons:

  • вам не нужно включать элемент Frame для каждой группы.You do not have to include a Frame for each group. За счет отсутствия элемента Frame уменьшается количество элементов управления в форме, что, в свою очередь, увеличивает производительность и уменьшает размер формы;By not using a Frame, you reduce the number of controls on the form, and in turn, improve performance and reduce the size of the form.

  • У вас больше гибкость дизайна.You have more design flexibility. Если вы используете фрейм для создания группы, все кнопки должны находиться внутри рамки.If you use a Frame to create the group, all the buttons must be inside the Frame. Если требуется несколько групп, для каждой группы должен быть один кадр .If you want more than one group, you must have one Frame for each group. Тем не менее, если для создания группы используется GroupName , группа может включать переключатели в любом месте формы.However, if you use GroupName to create the group, the group can include option buttons anywhere on the form. Если требуется несколько групп, укажите уникальное имя для каждой группы; Вы по-прежнему можете разместить отдельные элементы управления в любом месте формы.If you want more than one group, specify a unique name for each group; you can still place the individual controls anywhere on the form.

  • вы можете создавать кнопки с прозрачным фоном, что может улучшить внешний вид формы.You can create buttons with transparent backgrounds, which can improve the visual appearance of your form. Элемент Frame не относится к прозрачным элементам управления.The Frame is not a transparent control.

Независимо от того, какой метод используется для создания группы кнопок, нажатие одной кнопки в группе задает для всех остальных кнопок в одной группе значение false.Regardless of which method you use to create the group of buttons, clicking one button in a group sets all other buttons in the same group to False. Все переключатели с одинаковым параметром GroupName в пределах одного контейнера являются взаимоисключающими.All option buttons with the same GroupName within a single container are mutually exclusive. Вы можете использовать одно имя группы в двух контейнерах, однако это приведет к созданию двух групп (по одной в каждом контейнере), вместо одной группы, которая включает оба контейнера.You can use the same group name in two containers, but doing so creates two groups (one in each container) rather than one group that includes both containers.

Например, предположим, что форма содержит несколько переключателей и многостраничный режим, который также включает переключатели.For example, assume your form includes some option buttons and a MultiPage that also includes option buttons. Кнопки выбора в элементе MultiPage относятся к одной группе, а кнопки выбора в форме — к другой.The option buttons on the MultiPage are one group and the buttons on the form are another group. Эти две группы не связаны между собой.The two groups do not affect each other. При изменении параметра кнопки в элементе MultiPage кнопки в форме не изменяются.Changing the setting of a button on the MultiPage does not affect the buttons on the form.

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

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.