drawArray() Outil pour dessiner des tableaux

<< Click to Display Table of Contents >>

Navigation:  Impression de tableaux >

drawArray() Outil pour dessiner des tableaux

vpxPrint offre une interface simple pour dessiner des arrière-plans et des tableaux dans une page.

 

La fonction drawArray() peut être utilisée pour dessiner un tableau avec des lignes et des colonnes, des signets et des textes.

Elle fonctionne avec un modèle.

Vous pouvez utiliser drawArray() pour peindre n'importe quel arrière-plan.

 

1.Définir un modèle de tableau :

 

Un modèle est un tableau de lignes avec chr(10) (~n) comme délimiteur.

MonTemplate =

 "+-----------------------------------+~n"

+ "|                                   |~n"

+ "+-----------------------------------+".

Ce tableau utilise des lignes et des colonnes standard

standard, tels que définis dans les <CPI> et <LPI>.

 

 ... définit une boîte de 3 lignes commençant à la colonne 1 :

 

 

 

 

MonModele =

 "+--------+--------------------------+~n"

+ "|        |                          |~n"

+ "+--------+------+----------+--------+~n"

+ "                |          |        |~n"

+ "                +----------+--------+".

 

 

 

 ... définit une boîte de 5 lignes commençant à la colonne 1 :

array

 

 

Chaque saut de ligne (~n) fait passer le curseur à la ligne suivante. La valeur de la hauteur de ligne est donnée par la  balise <LPI> et la largeur du caractère '-' par la  balise<CPI >.

 

Les caractères utilisés par drawArray() sont les suivants :

 

 

+

Décrit une collision de lignes (verticales et horizontales) ou un coin : supérieur gauche, supérieur droit, inférieur gauche ou inférieur droit.        

-

Ligne horizontale

|

Ligne verticale

#

Définit un signet        

~t

Une tabulation (chr(9) ou "~t") peut être placée sur chaque ligne pour définir les attributs de la ligne. Ces attributs sont appliqués à la ligne avant de la dessiner. La largeur de spécification des caractères de titre individuels peut être spécifiée ici.

Espace

Un caractère espace est interprété comme un décalage de colonne. Chaque caractère espace espace le curseur d'une colonne vers la droite. Cela peut poser un problème lors de l'utilisation de textes pour des étiquettes, car vous pouvez vouloir utiliser des polices proportionnelles et les espaces doivent être évalués comme un caractère d'espacement standard dans la police sélectionnée. Dans ce cas, vous devez échapper au caractère espace avec un '\' (voir ci-dessous).

Texte

Il est possible d'écrire n'importe quel texte. Si le texte contient des caractères réservés tels que + - | # ou un espace, vous pouvez y échapper avec le caractère '\'. Le texte peut contenir des attributs vpxPrint comme <B> ou </I> etc...

 

 

Chaque ligne du tableau peut avoir ses propres attributs vpxPrint.

Si un titre ou des attributs spécifiques doivent être spécifiés, le format de la ligne peut être le suivant :

"<B><I>~t| Nom | Pays |~n".

Dans ce cas, le "Nom" et le "Pays" sont affichés en caractères gras et soulignés.

Les attributs sont mis en place dès leur réception et s'appliquent tant qu'aucune autre balise n'est spécifiée.

 

 

Appel de drawArray() :

 

Comme défini dans le fichier xPrint.i, la procédure drawArray a la syntaxe suivante :

 

PROCEDURE drawArray EXTERNAL "xPrint.dll" :

DEF INPUT PARAMETER recLength AS LONG.

DEF INPUT PARAMETER inputFormat AS CHAR.

DEF INPUT PARAMETER vpxPrintvalue AS MEMPTR.

DEF INPUT PARAMETER starting# AS LONG.

DEF INPUT PARAMETER incr# AS LONG.

END.

 

Où :

 

         

reclength

Nombre d'octets de la zone de réception. Cette zone doit être suffisamment grande pour contenir la codification vpxPrint. La valeur "reclength" indique la taille de cette zone.

inputFormat

Le modèle,

vpxPrintValeur

Zone où drawArray() renvoie le code vpxPrint. La longueur de cette zone doit être spécifiée dans le paramètre "reclength".

starting# (numéro de départ)

Le numéro du signet de départ. Chaque # dans le modèle génère un signet. Le premier signet commence avec cette valeur.

incr#

Incrémentation du signet. Chaque signet suivant le premier.

 

En retour, la  zone vpxPrintValeur contient la séquence à envoyer à vpxPrint pour dessiner le tableau.

 

Exemple 1 :

La procédure :

DEF VAR M                AS MEMPTR NO-UNDO.

DEF VAR myArray        AS CHAR NO-UNDO.

DEF VAR myLENGTH        AS INT NO-UNDO.

 

Mon tableau = "......

         ....

         ".

 

myLength = 32000.                // longueur de la zone de sortie

 

SET-SIZE(M) = myLength.

 

RUN drawArray( myLength, myArray, M, 10, 10).

 

MyBackground = GET-STRING(M, 1).

 

SET-SIZE(M) = 0.

 

IF myBackground = "" THEN

         ERREUR... la zone n'est pas assez grande...

 

... génère un arrière-plan avec le modèle spécifié. Les signets du modèle sont numérotés de 10 en 10.

 

Exemple 2 :

FUNCTION myBackGround RETURNS CHARACTER( /* parameter-definitions */ ) :

/*------------------------------------------------------------------------------

 Purpose:  

   Notes:  

------------------------------------------------------------------------------*/

DEF VAR M AS MEMPTR.

DEF VAR iBackground AS CHAR.

DEF VAR iFormat AS CHAR.

iFormat =     '                                             +-------------------------------+~n'

           + '                                             |#                              |~n'

                                 /* Defines the bookmark #10 */

           + '                                  Address... |                               |~n'

           + '                                             |                               |~n'

           + '                                             |                               |~n'

           + '                                             |                               |~n'

           + '                                             |                              #|~n'  

/* Defines the bookmark #20 */

           + '                                             +-------------------------------+~n'

           + '~n'

           + '~n'

+ '<FArial><P14><B><U>~t'        /* Attributes values for the labels. Note the ~t character */

           + '       References:~n'

+ '<P12></U></B>~t'                /* rest previous attributes                */

           + '      +------------------------------------------------------------------------+~n'

           + '      |#                                                                       |~n'

/* defines the bookmark #30 */

           + '      |                                                                        |~n'                

           + '      |                                                                       #|~n'

/* defines the bookmark #40 */

           + '      +------------------------------------------------------------------------+~n'

           + '~n'

           + '+------------+---------------------------------+---------+--------+------------+~n'

+ '<B><I>~t'

           + '|Item\ num    |Description                      |     Unit|    Qty |   Sub\ Total|~n'

+ '</B></I>~t'                /* Attributes values for the labels. Note the ~t character */

           + '+------------+---------------------------------+---------+--------+------------+~n'

           + '|#           |#                               #|      #  |      # |        #   |~n'

                               /* defines the bookmark #50,60,70,80,90,100 */

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '|            |                                 |         |        |            |~n'

           + '+------------+---------------------------------+------------------+------------+~n'

           + '                                                                  |        #   |~n'

/* defines the bookmark #110 */

           + '                                                                  +------------+~n'

           + '                                                                                ~n'

           + '             +----------------------------------+~n'

           + '             |TOTAL with 19.6% TAX          #   |~n' /* #120 */

           + '             +----------------------------------+~n'

   .

 

SET-SIZE(M) = 8192.

 

RUN drawArray(8192, iFormat, M, 10, 10).

 

iBackground = GET-STRING(M, 1).

SET-SIZE(M) = 0.

 

DEF VAR F AS CHAR NO-UNDO.

DEF VAR A   AS CHAR NO-UNDO.

 

F = SEARCH("4gl.bmp").                  /* logo path */

IF F <> ? THEN

   FILE-INFO:FILE-NAME = F.

 

A =

   "<R1><C1><#1>"

   + "<AT=+40,+40><IMAGE#1=" + FILE-INFO:FULL-PATHNAME + ">"

   + "<R1><C50><B><P20><FTahoma>My Company~n~n"

   + "<C50>my Adress<FArial><P12>"

 

   + "<R10><C1>" + iBackGround

   + "<=#20><R+1><C+1><FRAME#10>"            /* frame for address */

   + "<=#40><R+1><C+1><FRAME#30>"           /* frame for reference */

   + "<R60><C1><FROM><C80><LINE>~n"

   + "<#400><R+5><C80><FRAME#400><USE#400>"

   + "<P8><I>All rights are reserved etc... All rights are reserved etc...All rights are reserved etc... All rights are reserved etc... All rights are reserved etc..."

   + "All rights are reserved etc... All rights are reserved etc... All rights are reserved etc... All rights are reserved etc..."

   + "All rights are reserved etc... All rights are reserved etc... All rights are reserved etc... All rights are reserved etc..."

   + "All rights are reserved etc... All rights are reserved etc... All rights are reserved etc... All rights are reserved etc..."

   + "All rights are reserved etc... All rights are reserved etc... All rights are reserved etc... All rights are reserved etc..."

   + "All rights are reserved etc... All rights are reserved etc...All rights are reserved etc...All rights are reserved etc...All rights are reserved etc...<P12></I></USE>"

   .

 

 RETURN A.   /* Function return value. */

 

END FUNCTION.

 

 

Notes techniques :

- Notez que chaque ligne du modèle utilise un signet horizontal commençant par #800. On peut les utiliser pour se positionner sur les colonnes du tableau (800, 801, 802, etc.).