Como usar a palavra-chave Current/Cur em uma Função de Texto

É possível usar a palavra-chave current com determinadas funções de texto para tornar as fórmulas mais dinâmicas, mais úteis e menos redundantes. A palavra-chave current pode substituir parâmetros requeridos em funções de texto. Parâmetros inseridos no código produzem os mesmos resultados, enquanto a palavra-chave current pode produzir valores dinâmicos. Por exemplo, quando você usa current para o parâmetro Page em uma grade de várias páginas, ele produz o valor de cada página.

Você pode utilizar qualquer forma da palavra-chave current: current ou cur. Palavras-chave Current não fazem distinção entre maiúsculas e minúsculas.

Nota:

A palavra-chave current só é suportada em um objeto de texto quando as seguintes funções de texto são usadas: MemberName, MemberAlias e MemberDescription, onde current especifica o parâmetro da dimensão Page. No entanto, o nome da Grade, a Linha e a Coluna devem ser definidos, quando aplicável, e não podem ter a palavra-chave current.

Exemplo 1:

Na função GetCell, vários dos parâmetros são ou podem ser relativos à célula atual na qual a função é inserida. Portanto, a palavra-chave current pode ser prontamente aplicada a esta função. A função GetCell utiliza a seguinte sintaxe:

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

No exemplo a seguir, os parâmetros inseridos em código para a função GetCell retornam o mesmo valor de célula de Grid1, cell1A, page1 em todas as diversas páginas:

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

O próximo exemplo usa a palavra-chave current com a função GetCell. A célula em que a função é inserida exibe valores diferentes para cada página. Observe que a palavra-chave current também é aplicada ao nome de grade. Se o nome de grade for alterado, a fórmula do texto ainda estará correta.

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

Exemplo 2

Quando você utiliza a palavra-chave current em uma célula que se expande, os resultados são relativos à célula expandida.

O exemplo seguinte usa funções GetCell em uma célula expandida (Coluna A se expande para colunas Qtr1, Qtr2, Qtr3 e linha 1 se expande para linhas Leste e Oeste). A Linha de Texto 1 usa a palavra-chave current para o parâmetro Column; a Linha de Texto 2 usa um valor inserido no código para o parâmetro Column.

Nome	Descrição
.	Qtr1, Qtr2, Qtr3
Leste, Oeste	#
Linha de Texto 1	`<<GetCell(cur, 1, cur, cur)>>`
Linha de Texto 2	`<<GetCell(current, 1, A, 1)>>`

Os resultados são exibidos na tabela a seguir.

Nome	Trimestre 1	Trimestre 2	Trimestre 3
Leste	5.120	4.502	7.304
Oeste	3.405	2,300	4.462
Linha de Texto 1	5.120	4.502	7.304
Linha de Texto 2	5.120	5.120	5.120

A Linha de Texto 1 usa a palavra-chave current para o parâmetro Column, que resulta na atualização da coluna atual de cada célula expandida (Qtr1, Qtr2, Qtr3). Além disso, como a palavra-chave current é usada para o parâmetro Page, os valores na Linha de Texto 1 atualizam cada página relativa à página atual da grade.
A Linha de Texto 2 usa um valor inserido no código para o parâmetro Column (A), que resulta no mesmo valor de 5.120 para todos os trimestres. Uma referência inserida no código a um parâmetro Column retorna o mesmo valor superior à esquerda da coluna e da linha.

Tabela -11 Funções de Texto que oferecem suporte à Palavra-chave Current

Função de Texto Exemplo

Função de Texto	Exemplo
<<DataSource("GridName.Axis[ID]",InfoType)>> Parâmetros, onde aplicável: `GridName`: tem suporte em todas as células. `InfoType`: não aplicável	<<DataSource(current, "App")>> Nota: Será utilizado o nome da grade atual.
<<GetCell("GridName",Row,Col,Page)>> Parâmetros, onde aplicável: `GridName`: tem suporte em todas as células. `Row`: tem suporte em todas as células `Col`: tem suporte em todas as células `Page`: tem suporte em todas as células	<<GetCell(cur, 1, cur, current)>> <<GetCell(cur, 1(3), cur, current)>> Nota: É exibido o valor da terceira linha (expandida) da linha 1. <<GetCell(cur, cur, A, current)>> <<GetCell(cur, cur, A(B), current)>> Nota: Será exibido o valor da segunda coluna (expandida) da coluna A.
Use o seguinte em uma linha de dados ou em um cabeçalho da coluna: <<MemberName("DimName")>> Use o seguinte em uma linha ou cabeçalho de coluna que não seja de dados: <<MemberName("GridName",Row/Col/Page,"DimName")>> Use o seguinte parâmetro onde aplicável: `DimName`: Apenas células de cabeçalho	<<MemberName(current)>> <<MemberName("current", Row/Col/Page, "current")>> Nota: Retorna o nome do membro da linha, coluna ou página de dados correspondente à dimensão em que a célula de cabeçalho está localizada. Isso pode ser usado com a função `<<MemberDimension>>` para criar cabeçalhos personalizados para uma grade.
<<CalcStatus("GridName",Row,Col,Page)>> Nota: Os parâmetros que permitem a palavra-chave `current` estão realçados em negrito.	<<CellText("GridName", Row, Column, Page)>> <<CellText("GridName", Row, Column, Page, MemberOverride)>>
<<GridDimension("GridName","Axis",index)>> Nota: Os parâmetros que permitem a palavra-chave `current` estão realçados em negrito.	<<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)>> Nota: Os parâmetros que permitem a palavra-chave `current` estão realçados em negrito.
<<ListOfCellDocuments("GridName",FileName)>> Nota: Os parâmetros que permitem a palavra-chave `current` estão realçados em negrito.
<<GridDimension("GridName","Axis",Index)>> Parâmetros, onde aplicável: `GridName`: tem suporte em todas as células. `Axis`: Apenas células de cabeçalho `Index`: Apenas células de cabeçalho	<<GridDimension(cur,"Page",1)>> <<GridDimension(cur,cur,cur)>> Nota: É exibido o nome da dimensão correspondente à célula do cabeçalho.
<<GetHeading("GridName",Page,Ref,Offset)>> <<GetHeading("GridName",Page,Ref,"Delim")>> Parâmetros, onde aplicável: `GridName`: tem suporte em todas as células. `Page`: tem suporte em todas as células `Ref`: tem suporte em todas as células, mas não deve ser usado em células de cabeçalho* `Offset`: Apenas células de cabeçalho `Delim`: não aplicável	<<GetHeading(cur, cur, A, " - ")>> <<GetHeading(cur, cur, 1, " - ")>> Nota: Nos exemplos acima, todos os cabeçalhos da coluna A e linha 1 são exibidos para a página atual. <<GetHeading(cur, cur, A, cur)>> Nota: O cabeçalho da coluna A é exibido para a dimensão que corresponde a onde a célula do cabeçalho com a fórmula está localizada. <<GetHeading(cur, cur, cur, " - ")>> Nota: Se utilizado em uma célula de texto de linha, o resultado é todos os cabeçalhos na coluna atual separados por um " – ". Isso permite que usuários repitam cabeçalhos de coluna após uma quebra de página manual.
*O uso da palavra-chave `current` para o parâmetro "reference" é limitado. A palavra-chave `current` não poderá ser usada na função `GetHeading` quando for inserida como um "cabeçalho personalizado" em uma linha ou coluna, pois uma referência circular é criada. Você pode usar a palavra-chave `current` como o terceiro parâmetro em uma célula que faça parte de uma linha ou coluna de texto que não se encontra na área de cabeçalho da grade. Por exemplo, se você adicionar a fórmula seguinte à célula A3, em que a linha 3 é uma linha de texto: `<<GetHeading(cur,cur,cur,1)>>`, o resultado será o primeiro cabeçalho da coluna A. Você pode usar a função GetHeading dentro de uma célula de cabeçalho. No entanto, o parâmetro `reference` não deverá usar a palavra-chave `current`. Por exemplo, quando você insere `<<GetHeading(cur, cur, A, cur)>>` na célula de cabeçalho da coluna B, o cabeçalho da coluna A é retornado.

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

Parâmetros, onde aplicável:

GridName: tem suporte em todas as células.
InfoType: não aplicável

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

Nota:

Será utilizado o nome da grade atual.

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

Parâmetros, onde aplicável:

GridName: tem suporte em todas as células.
Row: tem suporte em todas as células
Col: tem suporte em todas as células
Page: tem suporte em todas as células

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

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

Nota:

É exibido o valor da terceira linha (expandida) da linha 1.

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

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

Nota:

Será exibido o valor da segunda coluna (expandida) da coluna A.

Use o seguinte em uma linha de dados ou em um cabeçalho da coluna:

<<MemberName("DimName")>>

Use o seguinte em uma linha ou cabeçalho de coluna que não seja de dados:

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

Use o seguinte parâmetro onde aplicável:

DimName: Apenas células de cabeçalho

<<MemberName(current)>>

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

Nota:

Retorna o nome do membro da linha, coluna ou página de dados correspondente à dimensão em que a célula de cabeçalho está localizada. Isso pode ser usado com a função <<MemberDimension>> para criar cabeçalhos personalizados para uma grade.

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

Nota:

Os parâmetros que permitem a palavra-chave current estão realçados em negrito.

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

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

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

Nota:

Os parâmetros que permitem a palavra-chave current estão realçados em negrito.

<<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)>>

Nota:

Os parâmetros que permitem a palavra-chave current estão realçados em negrito.

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

Nota:

Os parâmetros que permitem a palavra-chave current estão realçados em negrito.

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

Parâmetros, onde aplicável:

GridName: tem suporte em todas as células.
Axis: Apenas células de cabeçalho
Index: Apenas células de cabeçalho

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

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

Nota:

É exibido o nome da dimensão correspondente à célula do cabeçalho.

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

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

Parâmetros, onde aplicável:

GridName: tem suporte em todas as células.
Page: tem suporte em todas as células
Ref: tem suporte em todas as células, mas não deve ser usado em células de cabeçalho*
Offset: Apenas células de cabeçalho
Delim: não aplicável

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

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

Nota:

Nos exemplos acima, todos os cabeçalhos da coluna A e linha 1 são exibidos para a página atual.

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

Nota:

O cabeçalho da coluna A é exibido para a dimensão que corresponde a onde a célula do cabeçalho com a fórmula está localizada.

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

Nota:

Se utilizado em uma célula de texto de linha, o resultado é todos os cabeçalhos na coluna atual separados por um " – ". Isso permite que usuários repitam cabeçalhos de coluna após uma quebra de página manual.

*O uso da palavra-chave current para o parâmetro "reference" é limitado. A palavra-chave current não poderá ser usada na função GetHeading quando for inserida como um "cabeçalho personalizado" em uma linha ou coluna, pois uma referência circular é criada. Você pode usar a palavra-chave current como o terceiro parâmetro em uma célula que faça parte de uma linha ou coluna de texto que não se encontra na área de cabeçalho da grade. Por exemplo, se você adicionar a fórmula seguinte à célula A3, em que a linha 3 é uma linha de texto: <<GetHeading(cur,cur,cur,1)>>, o resultado será o primeiro cabeçalho da coluna A. Você pode usar a função GetHeading dentro de uma célula de cabeçalho. No entanto, o parâmetro reference não deverá usar a palavra-chave current. Por exemplo, quando você insere <<GetHeading(cur, cur, A, cur)>> na célula de cabeçalho da coluna B, o cabeçalho da coluna A é retornado.