Visio) (Masters.GetNames 方法

會傳回集合中所有項目的名稱。

語法

運算式。GetNames (localeSpecificNameArray () )

運算式 代表 Masters 物件的變數。

參數

名稱 必要/選用 資料類型 描述
localeSpecificNameArray () 必要 字串 輸出參數。 會接收指示的物件成員名稱的陣列。

傳回值

無

註解

如果 GetNames 方法成功, localeSpecificNameArray () 會傳回 n 個字串的一維陣列,索引為 0 到 n - 1,其中 n 等於物件的 Count 屬性。 localeSpecificNameArray () 是由 GetNames 方法配置的 out 參數,可將擁有權傳回給呼叫端。 呼叫端最終應該會在傳回的陣列上執行 SafeArrayDestroy 程序。 請注意, SafeArrayDestroy 程序的副作用是釋放陣列項目所參考的字串。 (Microsoft Visual Basic 和 Microsoft Visual Basic for Applications (VBA) 為您處理此問題。)

注意事項

從 Microsoft Visio 2000 開始,您可以使用本機和通用名稱來參照 Visio 圖形、母片、文件、頁面、列、附加元件、儲存格、超連結、樣式、字型、主片快速鍵、UI 物件和圖層。 例如,當使用者命名圖形時,使用者是在指定本機名稱。 從 Microsoft Office Visio 2003 開始,ShapeSheet 試算表僅顯示儲存格公式和值中的通用名稱。 (在舊版中,通用名稱在使用者介面中是看不見的。)

身為開發人員,如果您不希望每次將方案本土化時就要變更名稱,可以在程式中使用通用名稱。 使用 GetNames 方法可取得一個以上物件的本機名稱。 使用 GetNamesU 方法則可取得一個以上物件的通用名稱。

範例

下列 VBA 巨集示範如何使用 GetNames 方法取得使用中文件的 Masters 集合中所有 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 支援與意見反應。