---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Farbe -- Umfang, Global

# Farbe -- Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](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 anwenden können, z. B. Zellen, Tabellen und Linien.

Diese API ist Teil von ServiceNowPDF-Generierungsdienstprogramme-Plugin (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](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")Dient zum Generieren einer PDF.

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

Instanziiert eine neue Farbe Objekt mit RGB-Werten.
Farbe kann auf die folgenden Szenarien angewendet werden:
{#Color-Color_A__table_twm_hjk_34b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Farben | 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 : 1. Parameter]

{#Color-Color_A__table_twm_hjk_34b}  
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) {#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 | Farbebungsobjekt, das auf eine Übereinstimmung überprüft werden soll. |
[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. * Falsch: Die Farben stimmen nicht überein. {#Color-equals_O__ul_grr_53x_r4b} |
[Tabelle : 3. Rückgaben]

{#Color-equals_O__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie Sie zwei Farbsobjekte 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) {#ariaid-title4}

Gibt ein schwarzes, graues oder weißes Farbsobjekt 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 | Farbebungsobjekt, das den angegebenen Graustufenwert widerspiegelt. |
[Tabelle : 5. Rückgaben]

{#Color-getGrayColor_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie ein Farbebjekt mit 50 %-Graustufen erstellt wird.

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

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Rückgaben]

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

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

| Name | Typ | Beschreibung |
|-|-|-|
| Farbe | Farbe | Floating-Dezimalwert von 0 bis 1, wobei 0 vollständig transparent und 1 vollständig undurchsichtig 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. Rückgaben]

{#Color-setOpacity_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie ein Farbebungsobjekt erstellt und seine Opazität auf 50 Prozent festgelegt wird.

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


