Excel) (Names.Add 方法

會定義某儲存格範圍的新名稱。

語法

運算式。新增 (Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)

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

參數

名稱 必要/選用 資料類型 描述
Name 選用 Variant 指定如果未指定 NameLocal 參數,要用來做為名稱的英文文字。 名稱不能包含空格,也不可格式化為儲存格參照。
RefersTo 選用 Variant 如果未指定 RefersToLocal、 RefersToR1C1 和 RefersToR1C1Local 參數,使用 A1 樣式標記法,描述名稱所指的意義。

附註:如果參照不存在,則不會傳回 任何內容 。
Visible 選用 Variant True 指定名稱是定義為可見。 False 則指定名稱是定義為隱藏。 隱藏名稱不會出現在 [定義名稱]、[貼上名稱] 或 [到] 對話方塊中。 預設值為 True。
MacroType 選用 Variant 根據下列其中一個值而決定的巨集類型:
  • 1 - 使用者定義的函數 (Function 程序)

  • 2 - 巨集 (Sub 程序)

  • 3 或省略 - 無 (名稱不參照使用者定義的函數或巨集)

ShortcutKey 選用 Variant 指定巨集快速鍵。 必須是單一字母,例如 "z" 或 "Z"。 只適用於指令巨集。
類別 選用 Variant 如果 MacroType 引數為 1 或 2,則為巨集或函數的類別。 在 [函數精靈] 中會使用到此類別。 如果要參照現有的類別,可以使用數字 (從 1 開始) 或名稱 (使用英文)。 如果指定的類別不存在,Excel 會建立新的類別。
NameLocal 選用 Variant 指定如果未指定 Name 參數,要用來做為名稱的當地語系化文字。 名稱不能包含空格,也不可格式化為儲存格參照。
RefersToLocal 選用 Variant 如果沒有指定 RefersTo、RefersToR1C1 和 RefersToR1C1Local 參數,就會使用當地語系化的文字,以 A1 樣式的標記法描述名稱所參照的對象。
CategoryLocal 選用 Variant 如果沒有指定 Category 參數,就會指定可用來識別自訂函數類別的當地語系化文字。
RefersToR1C1 選用 Variant 如果沒有指定 RefersTo、RefersToLocal 和 RefersToR1C1Local 參數,就會使用英文以 R1C1 樣式的標記法描述名稱所參照的對象。
RefersToR1C1Local 選用 Variant 如果沒有指定 RefersTo、RefersToLocal 和 RefersToR1C1 參數,就會使用當地語系化的文字,以 R1C1 樣式的標記法描述名稱所參照的對象。

傳回值

代表新名稱的 Name 物件。

範例

這個範例會為現用活頁簿中 Sheet1 上的 A1:D3 範圍定義新的名稱。

注意事項

如果 Sheet1 不存在,則會傳回 Nothing。

Sub MakeRange() 
 
    ActiveWorkbook.Names.Add _ 
        Name:="tempRange", _ 
        RefersTo:="=Sheet1!$A$1:$D$3" 
 
End Sub

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。