4D v14.3GET QUERY DESTINATION |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
GET QUERY DESTINATION
|
GET QUERY DESTINATION ( destinoTipo ; destinoObjeto ; destinoPont ) | ||||||||
Parâmetro | Tipo | Descrição | ||||||
destinoTipo | Inteiro longo |
![]() |
0=seleção atual, 1=conjunto, 2=seleção temporal, 3=variável | |||||
destinoObjeto | cadeia |
![]() |
Nome do conjunto ou Nome da seleção temporal ou Cadeia vazia | |||||
destinoPont | Ponteiro |
![]() |
Ponteiro à variável local se destinoTipo=3 | |||||
O comando GET QUERY DESTINATION devolve o destino atual dos resultados das pesquisas para o processo em curso. Por defeito, os resultados das pesquisas modificam a seleção atual, mas pode modificar este funcionamento com a ajuda do comando SET QUERY DESTINATION.
No parâmetro destinoTipo, 4D devolve um valor indicando o destino atual das pesquisas e no parâmetro destinoObjeto devolve o nome do destino (se aplicado). Pode comparar o valor do parâmetro destinoTipo com as constantes do tema Destinos de pesquisa:
Constante | Tipo | Valor |
Into current selection | Inteiro longo | 0 |
Into named selection | Inteiro longo | 2 |
Into set | Inteiro longo | 1 |
Into variable | Inteiro longo | 3 |
O valor devolvido no parâmetro destinoObjeto depende do valor do parâmetro destinoTipo:
Parâmetro destinoTipo | Parâmetro destinoObjeto |
0 (seleção atual) | destinoObjeto é una cadeia vazia |
1 (conjunto) | destinoObjeto contém o nome do conjunto |
2 (seleção temporal) | destinoObjeto contém o nome da seleção |
3 (variável) | destinoObjeto é uma cadeia vazia (utilizar o parâmetro destinoPont) |
Queremos modificar temporariamente o destino de pesquisa e restabelecer os parâmetros prévios:
GET QUERY DESTINATION($vType;$vName;$ptr)
//recuperação dos parâmetros atuais
SET QUERY DESTINATION(Into set;"$temp")
//modificação temporal do destino
QUERY(...) //pesquisa
SET QUERY DESTINATION($vType;$vName;$ptr)
//restauração dos parâmetros
Produto: 4D
Tema: Pesquisas
Número
1155
Criado por: 4D v13
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)