Descrição
dbSetOrder [AS] - Seleciona a ordem ativa da área de trabalho. Esta ordem é responsável sequência lógica dos registros da tabela corrente.
|
Sintaxe
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
01
|
nOrdem
|
Numérico
|
Indica o número da posição da ordem na lista de ordens ativas
|
|
|
|
Retorno
| Retorno |
Tipo |
Descrição |
| xRet |
Indefinido
|
Retorna a informação da ordem requisitada pelo usuário (tipo numérico, se for número de ordens no índice, tipo caracter, se for nome do arquivo de índice. Caso não exista a ordem corrente ou a posição da ordem é inválida, o retorno será nulo ("")
|
Exemplo
#INCLUDE "TOTVS.CH"
User Function dbSetOrder()
dbSelectArea("SA1")
SA1->( dbSetOrder( 2 ) )
Return( Nil )
Resultado
Informações adicionais
|
Caso seja setada a ordem 0 (zero), a tabela corrente, na área de trabalho, será posicionada na ordem natural, ou seja, a ordem na qual os registros foram acrescentados. Porém, os indexadores são mantidos abertos
No entanto, é importante salientar que, quando alterada a ordem atual de uma determinada tabela, o registro atual não é desposicionado.
|
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎