Ligne : Définie, Global

Crée un objet Ligne à l’aide de méthodes pour tracer une ligne dans un PDF.

Cette API fait partie du module d’extension ServiceNow PDF Generation Utilities (com.snc.apppdfgenerator) et est fournie dans l’espace de noms sn_pdfgeneratorutils . Le module d’extension est activé par défaut.

Cette API est un composant utilisé avec l’API Document pour générer un PDF.

Ligne : Line()

Instancie un nouvel objet Ligne .

Tableau 1. Paramètres

Nom	Type	Description
Néant

Les exemples suivants montrent comment créer un objet Ligne .

var line = new sn_pdfgeneratorutils.Line();

Ligne – drawLine(Document document, Numéro pageNo, Numéro xPos, Numéro yPos, Largeur du numéro, Numéro lineWidth)

Place une ligne sur une page de document.

Tableau 2. Paramètres

Nom	Type	Description
Document	Document	Nom de l’objet du document.
pageNo	Numéro	Numéro de page sur lequel vous souhaitez placer la ligne.
xPos	Numéro	Zone de coordonnées X de la page sur laquelle placer la ligne.
yPos	Numéro	Zone de coordonnées Y de la page sur laquelle placer la ligne.
largeur	Numéro	Zone de largeur de la page dans laquelle vous souhaitez tracer la ligne. Les valeurs sont exprimées en points.
Largeur de ligne	Numéro	Facultatif. Valeur de l’épaisseur de ligne en points. Valeur par défaut : 1

Tableau 3. Renvoie

Type	Description
Néant

L’exemple suivant montre comment créer une ligne dans la marge inférieure d’une page de document. Pour obtenir un exemple d’utilisation de document, consultez API de document .

var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var num = 1;
var xpos = 100;
var ypos = 100;
var width = 450;
var linewidth = 2.5;

document.addNewPage();

var line = new sn_pdfgeneratorutils.Line();

line.drawLine(document, num, xpos, ypos, width, linewidth);

document.saveAsAttachment("incident", "<sys_id>", "line.pdf");

Ligne – setColor(Couleur couleur)

Définit la couleur d’une ligne.

Tableau 4. Paramètres

Nom	Type	Description
couleur	Couleur	Couleur de la ligne.

Tableau 5. Renvoie

Type	Description
Néant

L’exemple suivant montre comment créer une ligne et définir sa couleur dans un document. Pour obtenir un exemple d’utilisation de document, consultez API de document .

var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var num = 1;
var xpos = 100;
var ypos = 100;
var width = 450;
var linewidth = 2.5;

var color = new sn_pdfgeneratorutils.Color([0.5,0.5,0.8]);   //given as array of RGB values;

document.addNewPage();

var line = new sn_pdfgeneratorutils.Line();

line.setColor(color);

line.drawLine(document, num, xpos, ypos, width, linewidth);

document.saveAsAttachment("incident", "<sys_id>", "lineWithColor.pdf");