WidgetNumber

Este widget es utilizado para la impresión de valores numéricos en el informe.

Para utilizar este widget debemos indicar en el atributo type el valor number.

Algunas consideraciones:

• Por defecto, el atributo align se establece en right.
• Los valores numéricos se imprimen utilizando los separadores de miles y decimal definidos en las constantes de Facturascripts.
• Podemos utilizar los atributos de estilo del WidgetLabel.
• Podemos utilizar las distintas posibilidades de fieldname para valores variables (campos, array, método).

Atributos específicos

Podemos personalizar la impresión del valor mediante los siguientes atributos opcionales:

• currency: Es el nombre de campo que contiene el código de la divisa del importe. Si se informa se añadirá el icono de la divisa al valor numérico.
• decimal: Indica el número de decimales que deseamos imprimir. Por defecto los configurados en Facturascripts.
• negative: Si se informa se puede indicar un color que se utilizará cuando el valor numérico sea inferior a cero.
• printempty: Permite indicar si en caso de estár vacío o ser valor cero deseamos imprimir el cero o una cadena vacía. Así, si printempty tiene un valor true siempre imprime el valor numérico incluido el cero. Por el contrario si printempty tiene un valor false sólo se imprimirá el valor si no es cero. En caso de ser cero se imprimirá una cadena vacía. Por defecto true.
• licon, ricon: (Left / Right Icon). Permite informar un icono/carácter que se añadirá al valor numérico a la izquierda o a la derecha según el atributo utilizado.

Ejemplos:

Impresión de un valor numérico directamente de un campo del modelo y sin decimales.

<column posx="515" width="40">
        <widget type="number" fieldname="numItems" decimal="0" />
</column>

Impresión de un valor numérico de un array en la primera posición con dos decimales y con el icono de la moneda indicada por el campo coddivisa.

<column posx="515" width="40">
        <widget type="number" fieldname="totalByDay[0]" decimal="2" currency="coddivisa" />
</column>

Impresión de un valor numérico devuelto por el método total().

<column posx="320" width="62">
        <widget type="number" fieldname="total()" />
</column>

Impresión de un valor numérico directamente de un campo del modelo y con formato de 2 decimales, con el icono '%' a la derecha y pintado en rojo cuando es negativo.

<column posx="515" width="45">
        <widget type="number" fieldname="percentage" decimal="2" negative="red" ricon="%" />
</column>