GET HIGHLIGHTED RECORDS
GET HIGHLIGHTED RECORDS ( {tabla ;} nomConjunto )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| tabla | Table | → | Tabla de la cual leer los registros seleccionados Si se omite, tabla del formulario actual |
| nomConjunto | Text | → | Conjunto en el cual guardar los registros seleccionados |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando GET HIGHLIGHTED RECORDS guarda en el conjunto designado por el parámetro nomConjunto los registros seleccionados (es decir, los registros seleccionados por el usuario en el formulario listado) de la tabla pasada como parámetro. Si el parámetro tabla se omite, se utiliza la tabla del formulario o del subformulario actual.
En modo Diseño o durante la ejecución de los comandos DISPLAY SELECTION / MODIFY SELECTION, este comando puede remplazarse llamando el conjunto sistema UserSet mantenido automáticamente por 4D. Sin embargo, como este comando permite designar la tabla de la cual recuperar los registros seleccionados, el comando GET HIGHLIGHTED RECORDS también puede administrar las selecciones de registros en subformularios. En este caso, las selecciones de subformularios pueden provenir de diferentes tablas. Para mayor información sobre el conjunto UserSet, consulte la sección Conjuntos.
El comando GET HIGHLIGHTED RECORDS también puede llamarse fuera del contexto de un formulario; sin embargo, el conjunto devuelto está vacío.
El conjunto designado por nomConjunto puede ser local/cliente, proceso o interproceso.
Nota: en formularios incluidos, el comando GET HIGHLIGHTED RECORDS devuelve un conjunto vacío si el subformulario no tiene la propiedad de selección Multilíneas. En este caso, para conocer la línea seleccionada, debe utilizar el comando Selected record number.
Ejemplo
Este método indica cuántos registros están seleccionados en el subformulario que muestra los registros de la tabla [CDs]:
GET HIGHLIGHTED RECORDS([CDs];"$highlight")
ALERT(String(Records in set("$highlight"))"+"registros seleccionados.")
CLEAR SET("$highlight")
Variables y conjuntos del sistema
Si el comando se ejecuta correctamente, la variable sistema OK toma el valor 1. De lo contrario, toma el valor 0.