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
Os exemplos a seguir usam dois campos carregados em diferentes listas: um para First name e um 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 '|');