Escopo - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • Cria um objeto Linha usando métodos para desenhar uma linha em um PDF.

    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.

    Line - Linha ()

    Instancia um novo Linha objeto.

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

    Os exemplos a seguir mostram como criar um Linha objeto.

    var line = new sn_pdfgeneratorutils.Line();

    DrawLine(documento do documento, número pageNo, número xPos, número yPos, número largura, largura de linha numérica)

    Coloca uma linha em uma página do documento.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Documento Documento Nome do objeto do documento.
    pageNo Número Número da página na qual você deseja colocar a linha.
    XPos Número Área da coordenada X da página na qual a linha será colocada.
    YPos Número Área da coordenada Y da página na qual a linha será colocada.
    largura Número Área de largura da página na qual você deseja desenhar a linha. Os valores estão em pontos.
    Largura de linha Número Opcional. Valor da espessura da linha em pontos.

    Padrão: 1

    Tabela 3. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como criar uma linha na margem inferior de uma página de documento. Para obter um exemplo de uso de documento, consulte Documento API.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
    
    var num = 1;
    var xpos = 100;
    var ypos = 100;
    var width = 450;
    var linewidth = 2.5;
    
    document.addNewPage();
    
    var line = new sn_pdfgeneratorutils.Line();
    
    line.drawLine(document, num, xpos, ypos, width, linewidth);
    
    document.saveAsAttachment("incident", "<sys_id>", "line.pdf");

    Linha – setColor (cor da cor)

    Define a cor de uma linha.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    cor Cor Cor da linha.
    Tabela 5. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como criar uma linha e definir sua cor em um documento. Para obter um exemplo de uso de documento, consulte Documento API.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
    
    var num = 1;
    var xpos = 100;
    var ypos = 100;
    var width = 450;
    var linewidth = 2.5;
    
    var color = new sn_pdfgeneratorutils.Color([0.5,0.5,0.8]);   //given as array of RGB values;
    
    document.addNewPage();
    
    var line = new sn_pdfgeneratorutils.Line();
    
    line.setColor(color);
    
    line.drawLine(document, num, xpos, ypos, width, linewidth);
    
    document.saveAsAttachment("incident", "<sys_id>", "lineWithColor.pdf");