Farbe – Umfang, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Erstellt ein Farbobjekt, das zum Definieren von Farbattributen verwendet wird, die Sie auf Elemente in einer PDF-Datei anwenden können, z. B. Zellen, Tabellen und Linien.

    Diese API ist Teil von ServiceNow Plugin „PDF-Generierungsdienstprogramme“ (com.snc.apppdfgenerator) und wird in bereitgestellt sn_pdfgeneratorutils Namespace. Das Plugin ist standardmäßig aktiviert.

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

    Farbe: Farbe (Array-Farben)

    Instanziiert eine neue Farbe Objekt 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] , Der Wert der ersten Position ist rot, die zweite ist grün und die dritte ist blau. Außerdem [0, 0, 0] Ist schwarz, [0,5, 0,5, 0,5] Ist grau, und [1, 1, 1] Ist durchgehend weiß.

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

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

    Farbe – gleich(Farbfarbe)

    Gibt an, ob die Werte von zwei Objekten mit verschiedenen Farben übereinstimmen.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Farbe Farbe Farbebungsobjekt zur Überprüfung auf Übereinstimmung.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die Werte von zwei Farbobjekten übereinstimmen.

    Gültige Werte:
    • Wahr: Die Farben stimmen überein.
    • Falsch: Die Farben stimmen nicht überein.

    Das folgende Beispiel zeigt, wie Sie zwei Farbobjekte erstellen und bestimmen, 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(Zahl Graustufen)

    Gibt ein schwarzes, graues oder weißes Farbsobjekt zurück.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Graustufen Anzahl Dezimalwert im Bereich von 0 bis 1, wobei 0 schwarz und 1 weiß ist.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Objekt Farbebungsobjekt, das den angegebenen Graustufenwert widerspiegelt.

    Das folgende Beispiel zeigt, wie ein Farbebungsobjekt mit 50 % Graustufen erstellt wird.

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

    Farbe: SetColorValue (Array-Farben)

    Erstellt Farbe mit angegebenen Werten und ermöglicht Ihnen das Ändern der Werte einer vorhandenen Farbe. 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] , Der Wert der ersten Position ist rot, die zweite ist grün und die dritte ist blau. Außerdem [0, 0, 0] Ist schwarz, [0,5, 0,5, 0,5] Ist grau, und [1, 1, 1] Ist durchgehend weiß.
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die Werte einer vorhandenen Farbe geändert werden.

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

    Farbe – setOpazität (Zahlendeckkraft)

    Legt den Grad der Farbdeckkraft fest.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Farbe Farbe Fließender Dezimalwert von 0 bis 1, wobei 0 vollständig transparent und 1 vollständig undurchsichtig ist.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Farbobjekt erstellt und seine Opazität auf 50 Prozent festgelegt wird.

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