Метод Masters.GetNames (Visio)

Статья
04/07/2023

Возвращает имена всех элементов в коллекции.

Синтаксис

expression. GetNames (localeSpecificNameArray())

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
localeSpecificNameArray()	Обязательный	String	Параметр Out. Массив, получающий имена членов указанного объекта.

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

Отсутствует

Примечания

Если метод GetNames успешно выполняется, localeSpecificNameArray() возвращает одномерный массив из n строк, индексируемых от 0 до n - 1, где n равно свойству Count объекта. localeSpecificNameArray() — это параметр out, выделенный методом GetNames , который передает владение вызывающей стороне. В конечном итоге вызывающий объект должен выполнить процедуру SafeArrayDe в возвращаемом массиве. Обратите внимание, что процедура SafeArrayDestroy имеет побочный эффект освобождения строк, на которые ссылаются записи массива. (Microsoft Visual Basic и Microsoft Visual Basic для приложений (VBA) позаботится об этом за вас.)

Примечание.

Начиная с Microsoft Visio 2000, вы можете использовать локальные и универсальные имена для ссылки на фигуры Visio, образцы, документы, страницы, строки, надстройки, ячейки, гиперссылки, стили, шрифты, основные сочетания клавиш, объекты пользовательского интерфейса и слои. Например, когда пользователь присваивает имя фигуре, пользователь указывает локальное имя. Начиная с Microsoft Office Visio 2003 электронная таблица shapesheet отображает только универсальные имена в формулах и значениях ячеек. (В предыдущих версиях универсальные имена не отображались в пользовательском интерфейсе.)

Как разработчик, вы можете использовать универсальные имена в программе, если вы не хотите изменять имя каждый раз, когда решение локализуется. Используйте метод GetNames , чтобы получить локальные имена нескольких объектов. Используйте метод GetNamesU , чтобы получить универсальное имя нескольких объектов.

Пример

В следующем макросе VBA показано, как использовать метод GetNames для получения имен всех главных объектов в коллекции Master активного документа и вывода их в окне Интерпретация.

 
Public Sub GetNames_Example() 
 
 Dim strMasterNames() As String 
 Dim intLowerBound As Integer 
 Dim intUpperBound As Integer 
 
 ActiveDocument.Masters.GetNames strMasterNames 
 intLowerBound = LBound(strMasterNames) 
 intUpperBound = UBound(strMasterNames) 
 Debug.Print ActiveDocument; " Lower bound:"; intLowerBound; "Upper bound:"; intUpperBound 
 
 While intLowerBound <= intUpperBound 
 
 Debug.Print strMasterNames (intLowerBound) 
 intLowerBound = intLowerBound + 1 
 
 Wend 
 
End Sub

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

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

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