Escopo - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura
  • Cria um estilo para definir propriedades como tamanho da fonte, borda e alinhamento. Você pode aplicar o mesmo estilo a vários objetos simultaneamente.

    Esta API faz parte do ServiceNow Plug-in Utilitários de geração de PDF (com.snc.apppdfgenerator) e é fornecido em sn_pdfgeneratorutils namespace. O plug-in é ativado por padrão.

    Esta API é um componente usado com API de documento Para gerar um PDF.

    Você pode aplicar estilos personalizados aos seguintes elementos de API:

    Style - Estilo ()

    Instancia um novo Estilo objeto.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum(a)

    Os exemplos a seguir mostram como criar um Estilo objeto que você pode adicionar a Célula , Parágrafo ou Tabela elemento.

    var style = new sn_pdfgeneratorutils.Style();

    Estilo – setBackgroundColor(Cor da cor)

    Especifica uma cor de fundo de um elemento.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    cor Cor Cor de fundo.
    Tabela 3. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir a cor de fundo do elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var color = new sn_pdfgeneratorutils.Color([1, 0.9, 0.9]); // provided as array of RGB float values
    
    style.setBackGroundColor(color);

    Estilo – setBold()

    Define um estilo como fonte em negrito.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 5. Retorna
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir um estilo como fonte em negrito.

    var style = new sn_pdfgeneratorutils.Style();
    style.setBold();

    Estilo – setBorder(largura numérica)

    Define a borda de estilo em todos os quatro lados de um elemento.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    Tabela 7. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorder(width);

    Estilo – setBorderBottom(largura numérica)

    Define a borda de estilo para a parte inferior de um elemento.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    Tabela 9. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo para a parte inferior de um elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderBottom(width);

    Estilo – setBorderLeft(largura numérica)

    Define a borda de estilo no lado esquerdo de um elemento.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    Tabela 11. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo no lado esquerdo de um elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderLeft(width);

    Estilo – setBorderRight(largura numérica)

    Define a borda de estilo no lado direito de um elemento.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    Tabela 13. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo no lado direito de um elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderRight(width);

    Estilo – setBorderTop(largura numérica)

    Define a borda de estilo para a parte superior de um elemento.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    Tabela 15. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo para a parte superior de um elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderTop(width);

    Estilo – setColoredOrder(Largura numérica, Cor)

    Define borda de estilo com cor em todos os quatro lados de um elemento.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    cor Cor Cor da borda de estilo.
    Tabela 17. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo com cor. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorder(width, borderColor);

    Estilo – setColoredBorderBottom(Largura numérica, Cor)

    Define a borda de estilo com cor para o lado inferior de um elemento.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    cor Cor Cor da borda de estilo.
    Tabela 19. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo para a parte inferior de um elemento.Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderBottom(width, borderColor);

    Estilo – setColoredBorderLeft(Largura numérica, Cor)

    Define a borda de estilo com cor no lado esquerdo de um elemento.

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    cor Cor Cor da borda de estilo.
    Tabela 21. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderLeft(width, borderColor);

    Estilo – setColoredBorderRight(Largura numérica, Cor)

    Define a borda de estilo com cor no lado direito de um elemento.

    Tabela 22. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    cor Cor Cor da borda de estilo.
    Tabela 23. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo com cor. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderRight(width, borderColor);

    Estilo – setColoredBorderTop(Largura numérica, Cor)

    Define a borda de estilo com cor para o lado superior de um elemento.

    Tabela 24. Parâmetros
    Nome Tipo Descrição
    largura Número Largura da borda de estilo em pontos.
    cor Cor Cor da borda de estilo.
    Tabela 25. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma borda de estilo. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderTop(width, borderColor);

    Estilo – setFontColor(cor da cor)

    Define uma cor de fonte.

    Tabela 26. Parâmetros
    Nome Tipo Descrição
    cor Cor Cor da fonte.
    Tabela 27. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma cor de fonte. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var fontColor = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);
    
    style.setFontColor(fontColor);

    Estilo – setFontSize(Number fontSize)

    Define um tamanho de fonte de estilo.

    Tabela 28. Parâmetros
    Nome Tipo Descrição
    FontSize Número Tamanho da fonte em pontos.
    Tabela 29. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir um tamanho de fonte.

    var style = new sn_pdfgeneratorutils.Style();
    
    style.setFontSize(12);

    SetHorizontalAlignment(alinhamento de cadeia de caracteres)

    Define o alinhamento horizontal de um estilo.

    Tabela 30. Parâmetros
    Nome Tipo Descrição
    alinhamento Cadeia de caracteres Configuração de alinhamento horizontal.
    Valores válidos:
    • Centro: Alinha o conteúdo ao centro.
    • À esquerda: Alinha o conteúdo à esquerda.
    • À direita: Alinha o conteúdo à direita.
    Tabela 31. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o alinhamento horizontal em um elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var alignment = "Center";
    
    style.setHorizontalAlignment(alignment);
    

    Estilo – setItalic()

    Define um estilo como fonte itálico.

    Tabela 32. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 33. Retorna
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir um estilo de elemento como uma fonte itálico.

    var style = new sn_pdfgeneratorutils.Style();
    style.setItalic();

    Estilo – setPadding (preenchimento numérico)

    Define o preenchimento de todos os quatro lados de um elemento com a mesma largura.

    Tabela 34. Parâmetros
    Nome Tipo Descrição
    preenchimento Número Largura de preenchimento em pontos como um valor decimal.
    Tabela 35. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o estilo inferior como 2,5 pontos. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPadding(padding);

    Estilo – setPaddingBottom(preenchimento numérico)

    Define o valor da largura de preenchimento inferior de um elemento.

    Tabela 36. Parâmetros
    Nome Tipo Descrição
    preenchimento Número Largura de preenchimento em pontos como um valor decimal.
    Tabela 37. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o preenchimento do elemento inferior como 2,5 pontos. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingBottom(padding);

    Estilo – setPaddingLeft(preenchimento numérico)

    Define o valor da largura de preenchimento esquerdo de um elemento.

    Tabela 38. Parâmetros
    Nome Tipo Descrição
    preenchimento Número Largura de preenchimento em pontos como um valor decimal.
    Tabela 39. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o preenchimento de elemento esquerdo como 2,5 pontos. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingLeft(padding);

    Estilo – setPaddingRight(preenchimento numérico)

    Define o valor da largura de preenchimento direita de um estilo.

    Tabela 40. Parâmetros
    Nome Tipo Descrição
    preenchimento Número Largura de preenchimento em pontos como um valor decimal.
    Tabela 41. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o preenchimento de elemento direito como 2,5 pontos. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingRight(padding);

    Estilo – setPaddingTop(preenchimento numérico)

    Define o valor da largura de preenchimento superior de um elemento.

    Tabela 42. Parâmetros
    Nome Tipo Descrição
    preenchimento Número Largura de preenchimento em pontos como um valor decimal.
    Tabela 43. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o preenchimento de elemento superior como 2,5 pontos. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingTop(padding);

    Estilo – setTextAlignment(alinhamento de cadeia de caracteres)

    Define o alinhamento do texto para um estilo.

    Tabela 44. Parâmetros
    Nome Tipo Descrição
    alinhamento Cadeia de caracteres Posição de alinhamento do texto.
    Valores válidos:
    • Text-center: Alinha o texto ao centro.
    • Texto justificado: Modifica o espaço entre caracteres para preencher completamente o texto entre os lados esquerdo e direito. A linha final é alinhada à esquerda.
    • Text-justified-all: Justifica o alinhamento do texto, incluindo a linha final.
    • Text-left: Alinha o texto à esquerda.
    • Text-right: Alinha o texto à direita.
    Tabela 45. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o texto do elemento para centralizar o alinhamento.

    var style = new sn_pdfgeneratorutils.Style();
    
    String alignment = "text-center";
    
    style.setTextAlignment(alignment);

    SetVerticalAlignment(alinhamento de cadeia de caracteres)

    Define o alinhamento vertical deste elemento.

    Tabela 46. Parâmetros
    Nome Tipo Descrição
    alinhamento Cadeia de caracteres Configuração de alinhamento vertical.
    Valores válidos:
    • Inferior: Alinha o conteúdo à parte inferior.
    • Mid: Alinha o conteúdo ao centro.
    • Superior: Alinha o conteúdo à parte superior.
    Tabela 47. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o alinhamento vertical em um elemento. Para obter um exemplo de uso de documento, consulte Documento API.

    var style = new sn_pdfgeneratorutils.Style();
    
    var alignment = "Mid";
    
    style.setVerticalAlignment(alignment);