# GetCurrentSelections

GetCurrentSelections() retorna as seleções atuais no documento.

Se as opções forem utilizadas, você terá que especificar record\_sep. Para especificar uma nova linha, defina record\_sep para chr(13)&chr(10).

Se todos exceto dois, ou todos exceto um, dos valores forem selecionados, o formato 'NOT x,y' ou 'NOT y' será utilizado, respectivamente. Se você selecionou todos os valores e a contagem de todos os valores for maior que max\_values, o texto ALL será retornado.

Sintaxe:

GetCurrentSelections ([record\_sep [,tag\_sep [,value\_sep [,max\_values]]]])

Tipo de dados de retorno: caractere

Argumentos:

* record\_sep: separador a ser colocado entre registros de campo. O padrão é <CR><LF> que significa uma nova linha.
* tag\_sep: separador a ser colocado entre o rótulo do nome do campo e os valores de campo. O padrão é ': '.
* value\_sep: O separador a ser colocado entre valores de campo. O padrão é ', '.
* max\_values: O número máximo de valores de campo que serão listados individualmente. Quando um grande número de valores é selecionado, será usado o formato “x valores de y”. O padrão é 6.

## Exemplos

O exemplo a seguir usa dois campos carregados em diferentes listas, um para First name e outro para Initials.

Exemplo 1: John está selecionado em First name

`GetCurrentSelections ()`

retorna 'First name: John'.

Exemplo 2: John e Peter estão selecionados em First name.

`GetCurrentSelections ()`

retorna 'First name: John, Peter'.

Exemplo 3: John está selecionado em First name e JA está selecionado em Initials.

`GetCurrentSelections ()`

retorna 'First name: John; Peter e Initials: JA'.

Exemplo 4: John está selecionado em First name e JA está selecionado em Initials.

`GetCurrentSelections ( 
 chr(13)&chr(10) , ' = ' )`

retorna 'First name = John e Initials = JA'.

Exemplo 5: todos os nomes, exceto Sue, selecionados em First name e nenhuma seleção em Initials.

`=GetCurrentSelections(chr(13)&chr(10),'=',',',3)`

retorna 'First name=NOT Sue'.

Dados usados no exemplo:

`Names:` `LOAD * inline [` `"First name"|"Last name"|Initials|"Has cellphone"` `John|Anderson|JA|Yes` `Sue|Brown|SB|Yes` `Mark|Carr|MC |No` `Peter|Devonshire|PD|No` `Jane|Elliot|JE|Yes` `Peter|Franc|PF|Yes ] (delimiter is '|');`