xlfGetName
適用対象: Excel 2013 | Office 2013 | Visual Studio
[名前の管理] ダイアログ ボックスの [参照範囲] 列に表示される名前の定義を返します。このダイアログ ボックスは、[数式] タブの [定義された名前] セクションで [名前の管理] をクリックすると表示されます。定義に参照が含まれている場合、参照は R1C1 形式の参照として示されます。 xlfGetName を使用して、名前で定義されている値を確認します。 定義に対応する名前を取得するには、xlfGetDef を使用します。
Excel12(xlfGetName, LPXLOPER12 pxRes, 2, LPXLOPER12 pxNameText, LPXLOPER12 pxInfoType);
パラメーター
pxNameText (xltypeStr)
シートに定義されている名前を指定できます。作業中のブックで定義されている名前への外部参照 。 "!Sales"または、特定の開いているブックで定義されている名前への外部参照 (例: "[Book1]SHEET1!Sales")。 また pxNameTextは非表示にできます。
pxInfoType (xltypeBool)
名前について返される情報の種類を指定します。 FALSE または省略すると、定義が返されます。 TRUE の場合、名前がシートに対してのみ定義されていると TRUE を返し、名前がブック全体に対して定義されていると FALSE を返します。
プロパティ値/戻り値
pxRes (xltypeStr、xltypeBool、または xltypeErr)
pxInfoType に渡される値に応じて、指定した名前 (xltypeStr)、または TRUE または FALSE (xltypeBool) の定義を返します。
注釈
名前を含むブックを保護するために、[シートの保護] ダイアログ ボックスで チェック [ロックされたセルとロックされたセルの内容を保護する] ボックスが選択されている場合、xlfGetName はエラー値を#N/A返します。 [シートの保護] ダイアログ ボックスを表示するには、[校閲] タブの [変更] セクションにある [シートの保護] をクリックします。
次の表に、指定した pxNameText 引数を指定した xlfGetDef の呼び出しによって返される値の 3 つの例を示します。
| Excel における定義 | pxNameText | 戻り値 |
|---|---|---|
| シートで名前 [Sales] が数値 523 として定義されています。 | "Sales" |
"=523" |
| アクティブなシートで名前 [Profit] が、数式 =Sales-Costs として定義されています。 | "!Profit" |
"=Sales-Costs" |
| アクティブ シートで名前 [Database] が、範囲 A1:F500 として定義されています。 | "!Database" |
"=R1C1:R500C6" |