---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Farbe : Bereichsbezogen, Global

# Farbe : Bereichsbezogen, Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

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](https://www.servicenow.com/docs/CveG5U0vsM3q8bxY3KrZQg#DocumentBothAPI "Die Dokumenten -API bietet Methoden zum Initialisieren einer PDF-Datei, zum Hinzufügen von Inhalten und zum Schließen der PDF-Datei. Nach dem Hinzufügen von Inhalt kann das Dokument an einen Zieldatensatz angehängt werden.") zum Generieren einer PDF-Datei verwendet wird.

## Farbe: Farbe (Array-Farben) {#ariaid-title2}

Instanziiert ein neues Farbobjekt mit RGB-Werten.
Farbe kann auf die folgenden Szenarien angewendet werden:
{#Color-Color_A__table_twm_hjk_34b__entry__3}

| 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 : 1. Parameter]

{#Color-Color_A__table_twm_hjk_34b}  
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) {#ariaid-title3}

Gibt an, ob die Werte von zwei verschiedenen Farbobjekten übereinstimmen.
{#Color-equals_O__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Farbe | Farbe | Farbobjekt, um auf Übereinstimmung zu überprüfen. |
[Tabelle : 2. Parameter]

{#Color-equals_O__table_vv5_52h_44b} {#Color-equals_O__table_wv5_52h_44b__entry__2}

| 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. {#Color-equals_O__ul_grr_53x_r4b} |
[Tabelle : 3. Ergebnisse]

{#Color-equals_O__table_wv5_52h_44b}  
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) {#ariaid-title4}

Gibt ein Objekt in der Farbe Schwarz, Grau oder Weiß zurück.
{#Color-getGrayColor_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| graustufen | Nummer | Dezimalwert im Bereich von 0 bis 1, wobei 0 schwarz und 1 weiß ist. |
[Tabelle : 4. Parameter]

{#Color-getGrayColor_N__table_vv5_52h_44b} {#Color-getGrayColor_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Farbobjekt, das den angegebenen Graustufenwert widerspiegelt. |
[Tabelle : 5. Ergebnisse]

{#Color-getGrayColor_N__table_wv5_52h_44b}  
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) {#ariaid-title5}

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.
{#Color-setColorValue_A__table_vv5_52h_44b__entry__3}

| 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 : 6. Parameter]

{#Color-setColorValue_A__table_vv5_52h_44b} {#Color-setColorValue_A__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Ergebnisse]

{#Color-setColorValue_A__table_wv5_52h_44b}  
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) {#ariaid-title6}

Legt den Grad der Farbdeckkraft fest.
{#Color-setOpacity_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Farbe | Farbe | Gleitender Dezimalwert von 0 bis 1, wobei 0 vollständig transparent und 1 vollständig deckend ist. |
[Tabelle : 8. Parameter]

{#Color-setOpacity_N__table_vv5_52h_44b} {#Color-setOpacity_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Ergebnisse]

{#Color-setOpacity_N__table_wv5_52h_44b}  
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);