Couleur : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Crée un objet Couleur utilisé pour définir des attributs de couleur que vous pouvez appliquer aux éléments d’un fichier PDF ; telles que des cellules, des tables et des lignes.

    Cette API fait partie du module d’extension ServiceNow PDF Generation Utilities (com.snc.apppdfgenerator) et est fournie dans l’espace de noms sn_pdfgeneratorutils . Le module d’extension est activé par défaut.

    Cette API est un composant utilisé avec l’API Document pour générer un PDF.

    Couleur : couleur(tableau de couleurs)

    Instancier un nouvel objet couleur avec des valeurs RVB.

    La couleur peut être appliquée aux scénarios suivants :

    Tableau 1. Paramètres
    Nom Type Description
    Colors (Couleurs Tableau Trois nombres indiquant les valeurs RVB à l’aide d’une valeur décimale comprise entre 0 et 1. Par exemple, dans [0,1, 0,9, 0,5], la valeur de la première position est rouge, la deuxième est verte et la troisième est bleue. De plus, [0, 0, 0] est noir uni, [0,5, 0,5, 0,5] est gris uni et [1, 1, 1] est blanc uni.

    L’exemple suivant montre comment créer un objet Couleur .

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

    Couleur – égal à (Couleur couleur)

    Indique si les valeurs de deux objets de couleur différente correspondent.

    Tableau 2. Paramètres
    Nom Type Description
    couleur Couleur Objet couleur pour vérifier la correspondance.
    Tableau 3. Renvoie
    Type Description
    Booléen

    Marqueur indiquant si les valeurs de deux objets de couleur correspondent.

    Valeurs valides :
    • vrai : les couleurs correspondent.
    • faux : les couleurs ne correspondent pas.

    L’exemple suivant montre comment créer deux objets de couleur et déterminer si les couleurs correspondent.

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

    Couleur : getGrayColor(Number grayScale)

    Renvoie un objet de couleur noire, grise ou blanche.

    Tableau 4. Paramètres
    Nom Type Description
    niveaux de gris Numéro Valeur décimale comprise entre 0 et 1, dans laquelle 0 est noir et 1 est blanc.
    Tableau 5. Renvoie
    Type Description
    Objet Objet de couleur reflétant la valeur de niveaux de gris fournie.

    L’exemple suivant montre comment créer un objet couleur en niveaux de gris de 50 %.

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

    Couleur – setColorValue(Array colors)

    Crée une couleur avec des valeurs données et vous permet de modifier les valeurs d’une couleur existante. Chacune des valeurs doit être comprise entre 0 et 1.

    Tableau 6. Paramètres
    Nom Type Description
    Colors (Couleurs Tableau Trois nombres indiquant les valeurs RVB à l’aide d’une valeur décimale comprise entre 0 et 1. Par exemple, dans [0,1, 0,9, 0,5], la valeur de la première position est rouge, la deuxième est verte et la troisième est bleue. De plus, [0, 0, 0] est noir uni, [0,5, 0,5, 0,5] est gris uni et [1, 1, 1] est blanc uni.
    Tableau 7. Renvoie
    Type Description
    Néant

    L’exemple suivant montre comment modifier les valeurs d’une couleur existante.

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

    Couleur : setOpacity(Opacité du numéro)

    Définit le niveau d’opacité de la couleur.

    Tableau 8. Paramètres
    Nom Type Description
    couleur Couleur Valeur décimale flottante de 0 à 1, dans laquelle 0 est entièrement transparent et 1 est entièrement opaque.
    Tableau 9. Renvoie
    Type Description
    Néant

    L’exemple suivant montre comment créer un objet couleur et définir son opacité sur 50 %.

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