GET HIGHLIGHTED RECORDS

4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 2004


GET HIGHLIGHTED RECORDS ({tabla; }nomConjunto)

ParámetroTipoDescripción
tablaTablaTabla de la cual leer los registros seleccionados
Si se omite, tabla del formulario actual
nomConjuntoCadenaConjunto en el cual guardar los registros seleccionados

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")

Ver también

HIGHLIGHT RECORDS.

Variables y conjuntos sistema

Si el comando se ejecuta correctamente, la variable sistema OK toma el valor 1. De lo contrario, toma el valor 0.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente