Linha - com escopo, global

Cria um objeto de linha usando métodos para desenhar uma linha em um PDF.

Esta API faz parte do plug-in ServiceNow PDF Generator Utilities (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(a)

Os exemplos a seguir mostram como criar um objeto de linha.

var line = new sn_pdfgeneratorutils.Line();

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

Insere uma linha em uma página do documento.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Documento	Documento	Nome do objeto de 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. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como criar uma linha na margem inferior de uma página do 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");

Linha – setColor(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 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");