WidgetLabel
Este widget es el más utilizado puesto que es el encargado de representar en el informe cualquier dato alfabético. Existen distintas posibilidades a la hora de utilizarlo dependiendo de si queremos un texto fijo o variable.
Para utilizar este widget debemos indicar en el atributo type el valor label.
Estilo del texto
Podemos aplicar distintos atributos para personalizar el estilo con el que se imprimirá el texto.
- align: Establece la alineación horizontal del texto dentro del tamaño de la columna. ( left | center | right | full ). Por defecto left.
- bold: Establece la impresión del texto en negrita. ( true | false ). Por defecto false.
- italic: Establece la impresión del texto en itálica o cursiva. ( true | false ). Por defecto false.
- size: Establece el tamaño de la fuente de texto. ( valor numérico ). Por defecto 10.
- underline: Establece el subrayado simple en el texto. ( true | false ). Por defecto false.
- bgcolor: Establece un color para el fondo del texto. Este fondo se aplicará a todo el espacio reservado de la columna. ( sistema de colores por nombre o por valor RGB). Por defecto false.
Texto fijo
Cuando queremos imprimir un texto fijo debemos indicar en el atributo value el valor del texto a imprimir. Podemos utilizar el sistema de traducción de Facturascripts para que el texto sea traducido al idioma del usuario antes de imprimirlo, aplicando el atributo translate con un valor a true.
Ejemplos:
<column posx="80" posy="115" width="170">
<widget type="label" value="name" translate="true" bold="true" size="12" />
</column>
<column posx="270" posy="115" width="65">
<widget type="label" value="previous" translate="true" bold="true" align="right" size="12" />
</column>
Texto variable
Para imprimir un texto obtenido de los datos, normalmente en la banda de detalle, debemos indicar un valor al atributo fieldname correspondiente al nombre del campo que contiene el valor.
<column posx="20" width="50">
<widget type="label" fieldname="code" bold="true" />
</column>
<column posx="80" width="170">
<widget type="label" fieldname="name" italic="true" />
</column>
También es posible obtener los datos de estructuras definidas en el registro de datos:
- array: debemos utilizar los corchetes '[]' para el posicionamiento dentro del array.
- método: debemos utilizar los paréntesis '()' sin poder indicar parámetros.
<column posx="270" width="65">
<widget type="label" fieldname="dayOfWeek[0]" />
</column>
<column posx="250" width="62">
<widget type="label" fieldname="getDescription()" />
</column>