Linie: Scoped, Global

Erstellt ein Linienobjekt mit Methoden, um eine Linie in einer PDF-Datei zu zeichnen.

Diese API ist Teil des Plugins ServiceNow PDF Generation Utilities (com.snc.apppdfgenerator) und wird im Namespace sn_pdfgeneratorutils bereitgestellt. Das Plugin ist standardmäßig aktiviert.

Diese API ist eine Komponente, die mit der Dokument-API zum Generieren einer PDF-Datei verwendet wird.

Line – Line()

Instantiiert ein neues Line- Objekt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Die folgenden Beispiele zeigen, wie ein Linienobjekt erstellt wird.

var line = new sn_pdfgeneratorutils.Line();

Line – zeichnenLine(Dokumentdokument, Nummer pageNo, Nummer xPos, Nummer yPos, Nummer width, Nummer lineWidth)

Platziert eine Linie auf einer Dokumentseite.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Dokument	Dokument	Name des Dokumentobjekts.
Seitennr	Nummer	Seitenzahl, auf der Sie die Linie platzieren möchten.
xPos	Nummer	X-Koordinatenbereich der Seite, in dem die Linie platziert werden soll.
yPos	Nummer	Y-Koordinatenbereich der Seite, in dem die Linie platziert werden soll.
width	Nummer	Breitenbereich der Seite, in dem Sie die Linie zeichnen möchten. Werte werden in Punkten angegeben.
Zeilenbreite	Nummer	Optional. Wert der Linienstärke in Punkten. Standard: 1

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie eine Linie am unteren Rand einer Dokumentseite erstellt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

Line – setColor(Color color)

Legt die Farbe einer Linie fest.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Linienfarbe.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie eine Linie erstellen und ihre Farbe in einem Dokument festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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