É 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 |
|
Linha de Texto 2 |
|
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 |
---|---|
<<DataSource("GridName.Axis[ID]",InfoType)>> Parâmetros, onde aplicável:
|
<<DataSource(current, "App")>> Nota: Será utilizado o nome da grade atual. |
<<GetCell("GridName",Row,Col,Page)>> Parâmetros, onde aplicável:
|
<<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:
|
<<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 |
<<CalcStatus("GridName",Row,Col,Page)>>
Nota: Os parâmetros que permitem a palavra-chave |
<<CellText("GridName", Row, Column, Page)>>
<<CellText("GridName", Row, Column, Page, MemberOverride)>> |
<<GridDimension("GridName","Axis",index)>>
Nota: Os parâmetros que permitem a palavra-chave |
<<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 |
|
<<ListOfCellDocuments("GridName",FileName)>>
Nota: Os parâmetros que permitem a palavra-chave |
|
<<GridDimension("GridName","Axis",Index)>> Parâmetros, onde aplicável:
|
<<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:
|
<<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. |