在文字函數中使用 Current/Cur 關鍵字

您可使用 current 關鍵字搭配特定的文字函數，讓公式更具動態性、更實用且較為簡潔。current 關鍵字可取代文字函數中所需的參數。硬式編碼的參數會產生相同的結果，而 current 關鍵字則可產生動態的值。例如，當您對多頁面方格中的頁面參數使用 current 時，便會產生每一頁面的值。

您可使用任一類型的 current 關鍵字；current 或 cur。Current 關鍵字不須區分大小寫。

註：

只有在使用以下文字函數時，文字物件才支援 current 關鍵字：MemberName、MemberAlias 與 MemberDescription，其中 current 指定頁面維度參數。然而，必須定義適用的方格名稱、列與欄，且不可使用 current 關鍵字。

範例 1：

在 GetCell 函數中，許多參數皆與目前輸入函數的儲存格相關 (或可能相關)。因此，current 關鍵字可以套用至此函數。GetCell 函數使用下列語法：

<<GetCell ("GridName", Row, Column, Page)>>

在下列範例中，GetCell 的硬式編碼參數會傳回多個頁面之相同的方格 1、儲存格 1A、頁面 1 的儲存格值：

<<GetCell ("Grid1", 1, A, 1)>>

下一個範例則使用 current 關鍵字搭配 GetCell 函數。輸入函數的儲存格會針對每一頁面顯示不同的值。請注意，current 關鍵字也可套用至方格名稱。如果方格名稱變更，文字公式仍可正確執行。

<<GetCell ("current", 1, current, current)>>

範例 2

在將儲存格展開的網格中使用 current 關鍵字時，結果會與所展開的儲存格相關。

下列範例將 GetCell 函數用於展開的儲存格 (欄 A 展開至欄 Qtr1、Qtr2、Qtr3 且列 1 展開至列「東部」與「西部」)。文字列 1 對「欄」參數使用 current 關鍵字；文字列 2 則對「欄」參數使用硬式編碼的值。

名稱	描述
.	Qtr1、Qtr2、Qtr3
東部、西部	#
文字列 1	`<<GetCell(cur, 1, cur, cur)>>`
文字列 2	`<<GetCell(current, 1, A, 1)>>`

結果顯示在下列表格中。

名稱	第 1 季度	第 2 季度	第 3 季度
東部	5,120	4,502	7,304
西部	3,405	2,300	4,462
文字列 1	5,120	4,502	7,304
文字列 2	5,120	5,120	5,120

文字列 1 對「欄」參數使用 current 關鍵字，這使得每一個展開的儲存格 (Qtr1、Qtr2、Qtr3)，其目前的欄都得以進行更新。同樣地，由於 current 關鍵字用於「頁面」參數，因此文字列 1 當中的值，會更新與目前方格頁面相關的每一頁面。
「文字列 2」對「欄」參數 (A) 使用硬式編碼值，這會使每一季的值都同為 5,120。對「欄」參數的硬式編碼參照會傳回欄與列左上角的同一個值。

表格 -11 支援目前關鍵字的文字函數

文字函數範例

文字函數	範例
<<DataSource("GridName.Axis[ID]",InfoType)>> 其中適用的參數： `GridName`：所有儲存格皆支援 `InfoType`：不適用	<<DataSource(current, "App")>> 註：已使用目前的方格名稱。
<<GetCell("GridName",Row,Col,Page)>> 其中適用的參數： `GridName`：所有儲存格皆支援 `Row`：所有儲存格皆支援 `Col`：所有儲存格皆支援 `Page`：所有儲存格皆支援	<<GetCell(cur, 1, cur, current)>> <<GetCell(cur, 1(3), cur, current)>> 註：此時會顯示來自列 1 第 3 列 (展開後) 的值。 <<GetCell(cur, cur, A, current)>> <<GetCell(cur, cur, A(B), current)>> 註：並會顯示來自欄 A 第 2 欄 (展開後) 的值。
請在資料列或欄標題中使用下列項目： <<MemberName("DimName")>> 請在非資料列或欄標題中使用下列項目： <<MemberName("GridName",Row/Col/Page,"DimName")>> 在適用的情況下使用下列參數： `DimName`：僅限於標題儲存格	<<MemberName(current)>> <<MemberName("current", Row/Col/Page, "current")>> 註：會傳回對應於標題儲存格所在維度之資料列、欄或頁面的成員名稱。此參數可與 `<<MemberDimension>>` 函數搭配使用，以建立自訂的方格標題。
<<CalcStatus("GridName",Row,Col,Page)>> 註：允許 `current` 關鍵字的參數以粗體強調標示。	<<CellText("GridName", Row, Column, Page)>> <<CellText("GridName", Row, Column, Page, MemberOverride)>>
<<GridDimension("GridName","Axis",index)>> 註：允許 `current` 關鍵字的參數以粗體強調標示。	<<MemberAlias("DimName")>> <<MemberAlias("GridName", "DimName")>> <<MemberAlias("GridName", Row\|Col\|Page, "DimName")>> <<MemberDesc("DimName")>> <<MemberDesc("GridName", "DimName")>> <<MemberDesc("GridName", Row\|Col\|Page, "DimName")>> <<MemberName("DimName")>> <<MemberName("GridName", "DimName")>> <<MemberName("GridName", Row\|Col\|Page, "DimName")>> <<MemberQualifiedName("DimName")>> <<MemberQualifiedName("GridName", "DimName")>> <<MemberQualifiedName("GridName", Row\|Col\|Page, "DimName")>> <<MemberProperty(DimensionName, Property)>> <<MemberProperty("GridName", DimensionName, Property)>> <<MemberProperty("GridName", Row\|Col\|Page, DimensionName, Property)>>
<<ProcessManagementStatus("GridName",Row,Column,Page)>> 註：允許 `current` 關鍵字的參數以粗體強調標示。
<<ListOfCellDocuments("GridName",FileName)>> 註：允許 `current` 關鍵字的參數以粗體強調標示。
<<GridDimension("GridName","Axis",Index)>> 其中適用的參數： `GridName`：所有儲存格皆支援 `Axis`：僅限於標題儲存格 `Index`：僅限於標題儲存格	<<GridDimension(cur,"Page",1)>> <<GridDimension(cur,cur,cur)>> 註：此時會顯示對應於標題儲存格的維度名稱。
<<GetHeading("GridName",Page,Ref,Offset)>> <<GetHeading("GridName",Page,Ref,"Delim")>> 其中適用的參數： `GridName`：所有儲存格皆支援 `Page`：所有儲存格皆支援 `Ref`：所有儲存格皆支援，但不應用於標題儲存格* `Offset`：僅限於標題儲存格 `Delim`：不適用	<<GetHeading(cur, cur, A, " - ")>> <<GetHeading(cur, cur, 1, " - ")>> 註：在以上範例中，會顯示目前頁面中欄 A 與列 1 的所有標題。 <<GetHeading(cur, cur, A, cur)>> 註：若為對應於標題儲存格與公式所在位置的維度，則會顯示欄 A 的標題。 <<GetHeading(cur, cur, cur, " - ")>> 註：如果配合列文字儲存格使用，則結果會是目前欄中的所有標題，並以「-」隔開。此參數可讓使用者在手動分頁之後重複欄標題。
*限制對參數 "reference" 使用 `current` 關鍵字。當 `current` 關鍵字輸入為列或欄中的「自訂標題」時，便無法用於 `GetHeading` 函數，因為此時已建立循環參照。在方格標題區域之外的文字列或欄中，作為該列或欄其中一部分的儲存格內，您可使用 `current` 關鍵字作為第三個參數。例如，如果您在文字列 3 的儲存格 A3 中新增下列公式：`<<GetHeading(cur,cur,cur,1)>>`，則傳回的結果為欄 A 的第一個標題。您可在標題儲存格內使用 GetHeading 函數。但是 `reference` 參數不應使用 `current` 關鍵字。例如，當您在欄 B 的標題儲存格中輸入 `<<GetHeading(cur, cur, A, cur)>>` 時，則會傳回欄 A 的標題。

<<DataSource("GridName.Axis[ID]",InfoType)>>

其中適用的參數：

GridName：所有儲存格皆支援
InfoType：不適用

<<DataSource(current, "App")>>

註：

已使用目前的方格名稱。

<<GetCell("GridName",Row,Col,Page)>>

其中適用的參數：

GridName：所有儲存格皆支援
Row：所有儲存格皆支援
Col：所有儲存格皆支援
Page：所有儲存格皆支援

<<GetCell(cur, 1, cur, current)>>

<<GetCell(cur, 1(3), cur, current)>>

註：

此時會顯示來自列 1 第 3 列 (展開後) 的值。

<<GetCell(cur, cur, A, current)>>

<<GetCell(cur, cur, A(B), current)>>

註：

並會顯示來自欄 A 第 2 欄 (展開後) 的值。

請在資料列或欄標題中使用下列項目：

<<MemberName("DimName")>>

請在非資料列或欄標題中使用下列項目：

<<MemberName("GridName",Row/Col/Page,"DimName")>>

在適用的情況下使用下列參數：

DimName：僅限於標題儲存格

<<MemberName(current)>>

<<MemberName("current", Row/Col/Page, "current")>>

註：

會傳回對應於標題儲存格所在維度之資料列、欄或頁面的成員名稱。此參數可與 <<MemberDimension>> 函數搭配使用，以建立自訂的方格標題。

<<CalcStatus("GridName",Row,Col,Page)>>

註：

允許 current 關鍵字的參數以粗體強調標示。

<<CellText("GridName", Row, Column, Page)>>

<<CellText("GridName", Row, Column, Page, MemberOverride)>>

<<GridDimension("GridName","Axis",index)>>

註：

允許 current 關鍵字的參數以粗體強調標示。

<<MemberAlias("DimName")>>

<<MemberAlias("GridName", "DimName")>> <<MemberAlias("GridName", Row|Col|Page, "DimName")>>

<<MemberDesc("DimName")>>

<<MemberDesc("GridName", "DimName")>>

<<MemberDesc("GridName", Row|Col|Page, "DimName")>>

<<MemberName("DimName")>>

<<MemberName("GridName", "DimName")>>

<<MemberName("GridName", Row|Col|Page, "DimName")>>

<<MemberQualifiedName("DimName")>>

<<MemberQualifiedName("GridName", "DimName")>>

<<MemberQualifiedName("GridName", Row|Col|Page, "DimName")>>

<<MemberProperty(DimensionName, Property)>>

<<MemberProperty("GridName", DimensionName, Property)>>

<<MemberProperty("GridName", Row|Col|Page, DimensionName, Property)>>

<<ProcessManagementStatus("GridName",Row,Column,Page)>>

註：

允許 current 關鍵字的參數以粗體強調標示。

<<ListOfCellDocuments("GridName",FileName)>>

註：

允許 current 關鍵字的參數以粗體強調標示。

<<GridDimension("GridName","Axis",Index)>>

其中適用的參數：

GridName：所有儲存格皆支援
Axis：僅限於標題儲存格
Index：僅限於標題儲存格

<<GridDimension(cur,"Page",1)>>

<<GridDimension(cur,cur,cur)>>

註：

此時會顯示對應於標題儲存格的維度名稱。

<<GetHeading("GridName",Page,Ref,Offset)>>

<<GetHeading("GridName",Page,Ref,"Delim")>>

其中適用的參數：

GridName：所有儲存格皆支援
Page：所有儲存格皆支援
Ref：所有儲存格皆支援，但不應用於標題儲存格*
Offset：僅限於標題儲存格
Delim：不適用

<<GetHeading(cur, cur, A, " - ")>>

<<GetHeading(cur, cur, 1, " - ")>>

註：

在以上範例中，會顯示目前頁面中欄 A 與列 1 的所有標題。

<<GetHeading(cur, cur, A, cur)>>

註：

若為對應於標題儲存格與公式所在位置的維度，則會顯示欄 A 的標題。

<<GetHeading(cur, cur, cur, " - ")>>

註：

如果配合列文字儲存格使用，則結果會是目前欄中的所有標題，並以「-」隔開。此參數可讓使用者在手動分頁之後重複欄標題。

*限制對參數 "reference" 使用 current 關鍵字。當 current 關鍵字輸入為列或欄中的「自訂標題」時，便無法用於 GetHeading 函數，因為此時已建立循環參照。在方格標題區域之外的文字列或欄中，作為該列或欄其中一部分的儲存格內，您可使用 current 關鍵字作為第三個參數。例如，如果您在文字列 3 的儲存格 A3 中新增下列公式：<<GetHeading(cur,cur,cur,1)>>，則傳回的結果為欄 A 的第一個標題。您可在標題儲存格內使用 GetHeading 函數。但是 reference 參數不應使用 current 關鍵字。例如，當您在欄 B 的標題儲存格中輸入 <<GetHeading(cur, cur, A, cur)>> 時，則會傳回欄 A 的標題。