GetCurrentSelections

GetCurrentSelections() devuelve las selecciones actuales del documento.

Si queremos utilizar opciones, es necesario especificar record_sep. Para especificar una nueva línea configure record_sep en chr(13)&chr(10).

Si se seleccionan todos menos uno o dos valores, se empleará el formato "NOT x,y" o "NOT y" respectivamente. Si selecciona todos los valores y el recuento de todos los valores es mayor que max_values, devolverá el texto ALL.

Sintaxis:  

GetCurrentSelections ([record_sep [,tag_sep [,value_sep [,max_values]]]])

Tipo de datos que devuelve: cadena

Argumentos:  

• record_sep: separador que se colocará entre los registros de campo. Por defecto es <CR><LF>, que significa una nueva línea.
• tag_sep: separador que se colocará entre la etiqueta del nombre del campo y los valores del campo. El valor predeterminado es ': '.
• value_sep: Es el separador que se ha de colocar entre valores de campo. Por defecto es ', '.
• max_values: Es el número máximo de valores de campo que se han de listar de manera individual. Cuando se seleccione un número mayor de valores se utilizará el formato 'valores x de y' en su lugar. El valor por defecto es 6.

Ejemplos

El ejemplo a continuación utiliza dos campos cargados en distintos cuadros de lista, uno para el nombre First name y otro para Initials.

Ejemplo 1: John está seleccionado en First name

GetCurrentSelections ()

devuelve 'First name: John'.

Ejemplo 2: John y Peter están seleccionados en First name.

GetCurrentSelections ()

devuelve 'First name: John, Peter'.

Ejemplo 3: John está seleccionado en First name y JA está seleccionado en Initials.

GetCurrentSelections ()

devuelve 'First name: John; Peter y Initials: JA'.

Ejemplo 4: John está seleccionado en First name y JA está seleccionado en Initials.

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

devuelve 'First name = John y Initials = JA'.

Ejemplo 5: todos los nombres excepto Sue están seleccionados en First name y no hay selecciones en Initials.

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

devuelve 'First name=NOT Sue'.

Datos utilizados en el ejemplo:

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