Linha - com escopo, global

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • Cria um objeto de linha usando métodos para desenhar uma linha em um PDF.

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

    Esta API é um componente usado com a API de documentos para gerar um PDF.

    Linha - Linha ()

    Instancia um novo objeto de Linha.

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

    Os exemplos a seguir mostram como criar um objeto Linha.

    var line = new sn_pdfgeneratorutils.Line();

    Line – pullLine(Document document, Number pageNo, Number xPos, Number yPos, Number Width, Number lineWidth)

    Insere uma linha em uma página de 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 da linha Número Opcional. Valor da espessura da linha em pontos.

    Padrão: 1

    Tabela 3. Retorna
    Tipo Descrição
    Nenhum

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

    Line – setColor(Color color)

    Define a cor de uma linha.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    cor Cor Cor da linha.
    Tabela 5. Retorna
    Tipo Descrição
    Nenhum

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