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


Свойство IRibbonControl.Tag (Office)

Используется для хранения произвольных строк и их получения во время выполнения. Только для чтения.

Синтаксис

expression. Тег

Выражение Выражение, возвращающее объект IRibbonControl .

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

Строка

Замечания

Обычно можно различать элементы управления в XML-файле настройки пользовательского интерфейса ленты с помощью свойства Id . Однако существуют ограничения на то, что могут содержать идентификаторы (не буквенно-цифровые символы, и все они должны быть уникальными). Свойство Tag не имеет этих ограничений, поэтому его можно использовать в следующих ситуациях, когда идентификатор не работает:

  • Если необходимо сохранить специальную строку с элементом управления, например имя файла. Например: tag="C:\path\file.xlsm".

  • Если вы хотите, чтобы процедуры обратного вызова обрабатывали несколько элементов управления одинаково, но вы не хотите поддерживать список всех их идентификаторов (которые должны быть уникальными). Например, можно использовать кнопки на разных вкладках на ленте с тегом "синий", а затем просто выбрать свойство Tag вместо свойства ID при выполнении некоторых общих действий.

Пример

В XML-коде, используемом для настройки пользовательского интерфейса ленты, можно задать тег следующим образом. При вызове действия MyFunction можно прочитать свойство Tag , которое будет равно "some string".

<button id="mybutton" tag="some string" onAction="MyFunction"/>

См. также

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

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