Procedimiento GML SET_OUT_MASK

Sintaxis
CALL "GML::SET_OUT_MASK"

Propósito:
Fija la máscara de despliegue usada para desplegar datos en las columnas del grid.

Nota:
Una máscara, en el mismo formato utilizada en la función VPRO/5 STR( ), es localizada dentro de la variable GML_TPL.MASK%[c]. Si la manipulación del string de datos es requerida al aplicar la máscara, entonces la correspondiente variable GML_TPL.STYLE%[c] debe ser cargada con el mismo valor que se usaría con la función CVS para la conversión de texto (strings).

Si un error es encontrado con la máscara cuando se redibuja el grid, entonces los datos para la celda serán desplegados sin el uso de la máscara.

Cuando una máscara contiene un carácter 0 (decimal 48) el dato en la celda del grid es convertido a numérico antes de aplicar la máscara y entonces la manipulación del string es realizada si la variable GML_TPL.STYLE%[c] contiene un valor más grande que 0.

Fijando la variable GML_TPL.COL_N% a -1 da instrucciones al GML para aplicar la máscara y el valor contenido en las variables GML_TPL.MASK$[1] y GML_TPL.STYLE%[1] a todas las columnas en el grid. Fijando una variable GML_TPL.MASK%[c] a nulo ("") removerá una máscara existente.

Este procedimiento es válido solo cuando se aplica al grid principal.
(GML_TPL.MEMBER%=1).

Ejemplo:
La máscara de despliegue de la columna 5 en el set grid 2 es fijado a "###,###0,00" y el correspondiente valor para convertir texto es fijado a 1 (tira espacios).

2400 GML.SET%=2
2410 CALL "GML::TPL_PREP"
2420 GML_TPL.MASK$[5]= "###,##0,00"
2430 GML_TPL.STYLE%[5]=1
2440 CALL "GML::SET_OUT_MASK"

Opción:
Fijando GML_TPL.OPTION% a 1 antes de ejecutar el procedimiento SET_OUT_MASK redibujará el grid con el valor de máscara actualizado.