Linha - Escopo, global

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

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

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

    Linha - 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, número pageNo, número xPos, número yPos, número largura do número, largura de linha do número)

    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 colocar a linha.
    Pos Número Área da coordenada Y da página na qual colocar a linha.
    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");