Master.GetNames 方法 (Visio)

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

語法

運算式。GetNames (localeSpecificNameArray () )

表達 代表 Masters 物件的變數。

參數

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

傳回值

無

註解

如果GetNames方法成功，localeSpecificNameArray () 會傳回從 0 到n - 1 索引的n字串一維陣列，其中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 支援與意見反應。