Annotation retorna as informações solicitadas sobre uma anotação dentro de um objeto de grade. É possível definir quais informações retornar.
Sintaxe:
<<Annotation("GridName", Row, Col, Page, Attributes, Reference, Attachments)>>
<<Annotation("GridName", Row, Col, Page)>>
<<Annotation("GridName", Row, Col, Page, Attributes, Reference)>>
<<Annotation("GridName", Row, Col, Page, Attributes, Attachments)>>
<Annotation("GridName", AllRows, AllCols, Page, Attributes, Attachments)>>
onde:
GridName é o nome da grade que contém as anotações. A palavra-chave "current" tem suporte quando Attribute é usado em uma célula de texto da grade ou em um cabeçalho personalizado.
Row é o número da linha na grade. A palavra-chave "current" tem suporte quando Attribute é usado em uma célula de texto da grade ou em um cabeçalho personalizado.
Nota:
Para selecionar todas as linhas, row pode ser substituído pela palavra-chave AllRows.
Col é a referência da coluna (letra) na grade. A palavra-chave "current" tem suporte quando Attribute é usado em uma célula de texto da grade ou em um cabeçalho personalizado.
Nota:
Para selecionar todas as colunas, Col pode ser substituído pela palavra-chave AllCols.
Page é um valor numérico que representa o índice de combinações de membro em todas as dimensões de página da grade. A primeira combinação de dimensão de página em uma grade tem um índice de 1, a segunda combinação de dimensão de página tem um índice de 2 e assim por diante.
Attributes identifica as informações a serem retornadas da anotação. Elas podem incluir a palavra-chave All (valor padrão) ou uma combinação de uma ou mais das seguintes palavras-chave: Title & Description & Author & Date & Category. As palavras-chave Attribute podem ser dispostas em qualquer ordem de saída. Cada atributo deve ser separado por um caractere de união (&).
Reference é uma palavra-chave que marca quais anotações serão retornadas, em que:
All (padrão) retorna a anotação inicial e todas as respostas.
Top <n> retorna a anotação inicial e as primeiras <n> respostas.
Bottom <n> retorna a anotação inicial e as últimas <n> respostas. A anotação inicial é sempre mostrada e o número <n> não inclui a anotação inicial.
BottomOnly <n> retorna as últimas <n> respostas. A anotação inicial mostrada para 4 ou menos <n> respostas; anotação inicial com 5 ou mais <n> respostas não é mostrada.
First retorna apenas a anotação inicial.
Replies retorna todas as respostas. A anotação inicial não é mostrada.
Attachments é um valor booliano (true/false) que indica se anexos associados à anotação devem ser impressos com o relatório, em que:
True significa que os anexos serão impressos no fim do relatório.
False significa que nenhum anexo será impresso.
Exemplos:
<<Annotation("Grid1", cur, A, cur, All, All, true)>>
<<Annotation("Grid1", cur, A, cur, Title & Description & Author & Date & Category, Top 10, true)>>
<<Annotation("Grid10", 284, AB, cur, Title & Description & Date & Category, Bottom 10, false)>>
<<Annotation("Grid1", cur, A, cur, Title & Description & Author, BottomOnly 4, false)>>
<<Annotation("Grid Name", 1, A, 1, All)>>
<<Annotation("Grid Name","AllRows", "AllCols", 1, All)>>
<<Annotation("Grid Name", 1, A, 1, All, First)>>
<<Annotation("Grid Name", 1, cur, cur, All, Replies)>>
<<Annotation("Grid Name", 1, cur, cur)>>
<<Annotation("Grid Name",1, cur, cur, Desc, Replies)>>
<<Annotation(cur, cur, A, cur, Desc)>>
<<Annotation(cur, 3, ABC, cur, title & Desc, true)>>
<<Annotation("folder1\folder2\Grid2", 3,A,cur, Title & Description, true)>>
<<Annotation(current, 294, AB, cur, Title & Description, Top 19)>>
<<Annotation(current, 39, AB, cur, Title & Description & Author, Bottom 40)>>
Comportamento de Anotações em Caixas de Texto
O comportamento das anotações em linhas de texto da grade e em caixas de texto ao usar a palavra-chave "cur" é diferente.
Para linhas de texto, você pode usar a palavra-chave "cur".
Por exemplo, <<Annotation("Grid1", 1, A, cur, All, All, true)>>
Para caixas de texto, a palavra-chave "cur" não retorna nada. Como resultado, você digitaria <<Annotation("Grid1", 1, A, 1, All, All, true)>>