Ligne : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Crée un objet Ligne à l’aide de méthodes permettant de 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, Nombre 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 la coordonnée X de la page sur laquelle placer la ligne.
    yPos Numéro Zone de la coordonnée 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.

    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");