GET QUERY DESTINATION
GET QUERY DESTINATION ( destinoTipo ; destinoObjeto ; destinoPunt )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| destinoTipo | Entero largo | 🡘 | 0=selección actual, 1=conjunto, 2=selección temporal, 3=variable |
| destinoObjeto | Cadena | 🡘 | Nombre del conjunto o Nombre de la selección temporal o Cadena vacía |
| destinoPunt | Puntero | 🡘 | Puntero a la variable local si destinoTipo=3 |
Descripción
El comando GET QUERY DESTINATION devuelve el destino actual de los resultados de las búsquedas para el proceso en curso. Por defecto, los resultados de las búsquedas modifican la selección actual, pero puede modificar este funcionamiento con la ayuda del comando SET QUERY DESTINATION.
En el parámetro destinoTipo, 4D devuelve un valor indicando el destino actual de las búsquedas y en el parámetro destinoObjeto devuelve el nombre del destino (si aplica). Puede comparar el valor del parámetro destinoTipo con las constantes del tema Destinos de búsqueda:
| Constante | Tipo | Valor |
|---|---|---|
| Into current selection | Entero largo | 0 |
| Into named selection | Entero largo | 2 |
| Into set | Entero largo | 1 |
| Into variable | Entero largo | 3 |
El valor devuelto en el parámetro destinoObjeto depende del valor del parámetro destinoTipo:
| Parámetro destinoTipo | Parámetro destinoObjeto |
|---|---|
| 0 (selección actual) | destinoObjeto es una cadena vacía |
| 1 (conjunto) | destinoObjeto contiene el nombre del conjunto |
| 2 (selección temporal) | destinoObjeto contiene el nombre de la selección |
| 3 (variable) | destinoObjeto es una cadena vacía (utilizar el parámetro destinoPunt) |
Cuando el destino de las búsquedas es una variable local (destinoTipo devuelve 3), 4D devuelve en el parámetro destinoPunt un puntero a esta variable.
Ejemplo
Queremos modificar temporalmente el destino de búsqueda y restablecer los parámetros previos:
GET QUERY DESTINATION($vType;$vName;$ptr)
//recuperación de los parámetros actuales
SET QUERY DESTINATION(Into set;"$temp")
//modificación temporal del destino
QUERY(...) //búsqueda
SET QUERY DESTINATION($vType;$vName;$ptr)
//restablecimiento de los parámetros