---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 色 - スコープ対象、グローバル

# 色 - スコープ対象、グローバル {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

PDF 内の要素に適用できる色属性を定義するために使用される Color オブジェクトを作成します。セル、テーブル、行など。

この API は ServiceNow PDF 生成ユーティリティプラグイン (com.snc.apppdfgenerator) の一部であり、 `sn_pdfgeneratorutils` 名前空間内で提供されます。このプラグインはデフォルトでアクティブ化されています。

この API は、PDF を生成するために [ドキュメント API](https://servicenow-prod.fluidtopics.net/7tzXFAmYeA9VuU2eCM9cJQ#DocumentBothAPI "ドキュメント API は、PDF を初期化し、コンテンツを追加し、PDF を閉じるためのメソッドを提供します。コンテンツを追加した後、ドキュメントをターゲットレコードに添付できます。") で使用されるコンポーネントです。

## 色:色 (アレイ色) {#ariaid-title2}

RGB 値を持つ新しい Color オブジェクトをインスタンス化します。
色は次のシナリオに適用できます。
{#Color-Color_A__table_twm_hjk_34b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| colors | アレイ | 0 〜 1 の 10 進数値を使用して RGB 値を示す 3 つの数字。たとえば、\[ `0.1, 0.9, 0.5]` では、最初の位置の値は赤、2 番目の位置の値は緑、3 番目の位置の値は青です。また、\[ `0, 0, 0]` は黒一色、\[ `0.5, 0.5, 0.5]` はグレー一色、\[ `1, 1, 1]` は白一色です。 |
[表 : 1. パラメーター]

{#Color-Color_A__table_twm_hjk_34b}  
次の例は、 Color オブジェクトの作成方法を示しています。

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

## Color -- equals(色の色) {#ariaid-title3}

2 つの異なる色オブジェクトの値が一致するかどうかを示します。
{#Color-equals_O__table_vv5_52h_44b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 色 | 色 | 一致をチェックする色オブジェクト。 |
[表 : 2. パラメーター]

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

| タイプ | 説明 |
|-|-|
| ブーリアン | 2 つの色オブジェクトの値が一致するかどうかを示すフラグ。 有効な値： * true:色が一致します。 * false:色が一致しません。 {#Color-equals_O__ul_grr_53x_r4b} |
[表 : 3. 返される内容]

{#Color-equals_O__table_wv5_52h_44b}  
次の例は、2 つの色オブジェクトを作成し、色が一致するかどうかを判断する方法を示しています。

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

## 色 -- getGrayColor(Number grayScale) {#ariaid-title4}

黒、グレー、または白のカラーオブジェクトを返します。
{#Color-getGrayColor_N__table_vv5_52h_44b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| グレースケール | 数値 | 0 〜 1 の範囲の 10 進数値。0 は黒、1 は白です。 |
[表 : 4. パラメーター]

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

| タイプ | 説明 |
|-|-|
| オブジェクト | 指定されたグレースケール値を反映する色オブジェクト。 |
[表 : 5. 返される内容]

{#Color-getGrayColor_N__table_wv5_52h_44b}  
次の例は、50% のグレースケールのカラーオブジェクトを作成する方法を示しています。

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

## 色:setColorValue(アレイの色) {#ariaid-title5}

指定された値で色を作成し、既存の色の値を変更できるようにします。各値は 0 〜 1 の範囲でなければなりません。
{#Color-setColorValue_A__table_vv5_52h_44b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| colors | アレイ | 0 〜 1 の 10 進数値を使用して RGB 値を示す 3 つの数字。たとえば、\[ `0.1, 0.9, 0.5]` では、最初の位置の値は赤、2 番目の位置の値は緑、3 番目の位置の値は青です。また、\[ `0, 0, 0]` は黒一色、\[ `0.5, 0.5, 0.5]` はグレー一色、\[ `1, 1, 1]` は白一色です。 |
[表 : 6. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 7. 返される内容]

{#Color-setColorValue_A__table_wv5_52h_44b}  
次の例は、既存の色の値を変更する方法を示しています。

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

## Color -- setOpacity(数値の不透明度) {#ariaid-title6}

色の不透明度のレベルを設定します。
{#Color-setOpacity_N__table_vv5_52h_44b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 色 | 色 | 0 から 1 までの浮動小数点以下桁数の値。0 は完全に透明、1 は完全に不透明です。 |
[表 : 8. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 9. 返される内容]

{#Color-setOpacity_N__table_wv5_52h_44b}  
次の例は、カラーオブジェクトを作成し、その不透明度を 50% に設定する方法を示しています。

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