Procedimiento GML SORT

Sintaxis
CALL "GML::SORT"

Propósito:
Ordena los datos del grid principal basados en los datos contenidos en una columna específica.

Nota:
La variable GML_TPL.ROW_C% es usada para indicar cual columna se usará como índice para ordenar. Después de ordenar los datos, el grid sé redibuja, y el número de la columna usada en el procedimiento SORT es retenido en GML.S_STAT%[GML.SET%]. Un valor positivo indica que el ordenamiento fue en orden ascendente, mientras que un valor negativo indica un orden descendente. Cuando el procedimiento RESET es ejecutado, el valor en la variable GML.S_STAT%[GML.SET%] es fijado a 0.

Ejemplo:

2400 GML.SET%=1
2410 CALL "GML::TPL_PREP"
2420 GML_TPL.COL_N%=3
2430 CALL "GML::SORT"

Opción:
Los valores en la variable GML_TPL.OPTION% son aditivos.

Si GML_TPL.OPTION% es fijado a 1, el valor en GML_TPL.REL$[sort column] será usado como la columna de índice para el ordenamiento.

Si GML_TPL.OPTION% es fijado a 2, el ordenamiento será en orden descendente (orden inverso).

Fijando GML_TPL.OPTION% a 3 usará la GML_TPL.REL$[sort column], con el ordenamiento en orden descendente.

GML_TPL.OPTION% fijado a 4 actualizará los encabezados de columna después de que el procedimiento SORT es ejecutado. Esta opción es útil cuando la plantilla GML_TPL$ usada para ejecutar el procedimiento SORT, además contiene cambios en las variables GML_TPL$ afectando imágenes agregadas o removidas en los encabezados de columna.

GML_TPL.ARG% es usado para especificar el uso de la función CVS (para conversión de texto) cuando se están construyendo los indices para el ordenamiento. Los valores GML_TPL.ARG% son los mismos que son usados con la función CVS.

Si una máscara es provista en la variable GML_TPL.MASK$[sort column] y la máscara contiene cero y un punto decimal (opcional) la columna será ordenada como un numérico usando esa máscara.

Nota Adicional:
Si hay un problema cuando se ejecuta el procedimiento SORT, la variable GML.FLAG% contendrá un -18. En adición la variable GML_TPL.FLAG% contendrá el número de error de VPRO/5, y la GML_TPL.ROW_N% contendrá el número de fila que causa el error.

Si el procedimiento SORT es ejecutado mientras una celda está en modo edit un GML.FLAG% con valor de -19 será regresado (el procedimiento SORT no se ejecutará).