Farbe : Bereichsbezogen, Global

Erstellt ein Farbobjekt, das zum Definieren von Farbattributen verwendet wird, die Sie auf Elemente in einer PDF-Datei anwenden können; wie Zellen, Tabellen und Zeilen.

Diese API ist Teil des Plugins ServiceNow PDF Generierung 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.

Farbe: Farbe (Array-Farben)

Instanziiert ein neues Farbobjekt mit RGB-Werten.

Farbe kann auf die folgenden Szenarien angewendet werden:

Tabelle : 1. Parameter

Name	Typ	Beschreibung
colors	Array	Drei Zahlen, die RGB-Werte mit einem Dezimalwert von 0 bis 1 angeben. Beispiel: In [0.1, 0.9, 0.5]ist der Wert der ersten Position rot, der zweite grün und der dritte blau. [0, 0, 0] ist durchgehend schwarz, [0.5, 0.5, 0.5] ist durchgehend grau und [1, 1, 1] ist durchgehend weiß.

Das folgende Beispiel zeigt, wie ein Objekt vom Typ Farbe erstellt wird.

var color = new sn_pdfgeneratorutils.Color([0.1, 0.9, 0.5]); //given as object containing RGB values

Farbe – ist gleich (Farbfarbe)

Gibt an, ob die Werte von zwei verschiedenen Farbobjekten übereinstimmen.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Farbobjekt, um auf Übereinstimmung zu überprüfen.

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Werte von zwei Farbobjekten übereinstimmen. Gültige Werte: wahr: Die Farben stimmen überein. false: Die Farben stimmen nicht überein.

Das folgende Beispiel zeigt, wie Sie zwei Farbobjekte erstellen und feststellen, ob die Farben übereinstimmen.

var color1 = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);  // given as an array of RGB values
var color2 = new sn_pdfgeneratorutils.Color([0.8,0.5,0.5]);         // given as an array of RGB values
var isequal = color1.equals(color2);

Farbe – getGrayColor(Number grauScale)

Gibt ein Objekt in der Farbe Schwarz, Grau oder Weiß zurück.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
graustufen	Nummer	Dezimalwert im Bereich von 0 bis 1, wobei 0 schwarz und 1 weiß ist.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Objekt	Farbobjekt, das den angegebenen Graustufenwert widerspiegelt.

Das folgende Beispiel zeigt, wie Sie ein Farbobjekt erstellen, das zu 50 % aus Graustufen besteht.

var grayColor = new sn_pdfgeneratorutils.Color.getGrayColor(0.5);

Farbe – setColorValue(Array-Farben)

Erstellt eine Farbe mit den angegebenen Werten und ermöglicht Ihnen, die Werte einer vorhandenen Farbe zu ändern. Jeder der Werte muss zwischen 0 und 1 liegen.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
colors	Array	Drei Zahlen, die RGB-Werte mit einem Dezimalwert von 0 bis 1 angeben. Beispiel: In [0.1, 0.9, 0.5]ist der Wert der ersten Position rot, der zweite grün und der dritte blau. [0, 0, 0] ist durchgehend schwarz, [0.5, 0.5, 0.5] ist durchgehend grau und [1, 1, 1] ist durchgehend weiß.

Tabelle : 7. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie die Werte einer vorhandenen Farbe ändern.

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

Farbe – setOpacity(Number opacity)

Legt den Grad der Farbdeckkraft fest.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Gleitender Dezimalwert von 0 bis 1, wobei 0 vollständig transparent und 1 vollständig deckend ist.

Tabelle : 9. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie ein Farbobjekt erstellen und seine Deckkraft auf 50 Prozent festlegen.

var color = new Color([1,0.5,0.5]);
color.setOpacity(0.5);