Célula - com escopo, global

Célula - Célula (extensão de linhas numéricas, extensão de colunas numéricas)

Instancia um novo objeto de célula. Cria uma célula que usa uma quantidade personalizada de espaços de célula na tabela.

Nota:

Se você fornecer um número negativo para qualquer um dos parâmetros, o valor será definido como 1.

Tabela 1. Parâmetros
Nome	Tipo	Descrição
período de linhas	Número	Número de linhas que esta célula deve ocupar. Padrão: 0
colspan	Número	Número de colunas que esta célula deve ocupar. Padrão: 0

O exemplo a seguir mostra como criar um objeto de célula abrangendo uma única linha e uma única coluna.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

Célula – addImage (imagem imagem)

Adiciona uma imagem a uma célula de tabela.

Tabela 2. Parâmetros
Nome	Tipo	Descrição
imagem	Imagem	Imagem a ser adicionada a uma célula de tabela.

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

O exemplo a seguir mostra como instanciar um anexo de imagem existente e adicioná-lo a uma célula em uma tabela. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var image = new Image("<attachment_sys_id>");

cell.addImage(image);

Célula – addParagraph(Parágrafo)

Adiciona texto a uma célula de tabela.

Tabela 4. Parâmetros
Nome	Tipo	Descrição
parágrafo	Parágrafo	Texto a ser adicionado a uma célula da tabela.

Tabela 5. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como instanciar objetos de parágrafo e adicionar as células de conteúdo em uma tabela. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);
var para = new sn_pdfgeneratorutils.Paragraph("Paragraph text.");
cell.addParagraph(para);

Célula – addStyle(Estilo de estilo)

Aplica um estilo predefinido às células da tabela.

Tabela 6. Parâmetros
Nome	Tipo	Descrição
estilo	Estilo	Estilo a ser aplicado a este elemento.

Tabela 7. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como aplicar um estilo a uma célula da tabela. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);
var style = new sn_pdfgeneratorutils.Style();
style.setBold();
     
cell.addStyle(style);

Célula – addTable(Tabela tabela)

Adiciona uma tabela a uma célula.

Tabela 8. Parâmetros
Nome	Tipo	Descrição
tabela	Tabela	Tabela a ser adicionada a uma célula.

Tabela 9. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como instanciar um objeto de tabela e adicioná-lo a uma célula. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var columnWidths = [100, 50, 50];

var table = new Table(columnWidths, false);

cell.addTable(table);

Célula – getColumn()

Obtém o número da coluna na qual a célula está localizada.

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

Tabela 11. Retorna
Tipo	Descrição
Número	Número da posição da coluna de uma célula.

O exemplo a seguir mostra como obter o número de uma posição de coluna para uma célula.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var columnWidths = [100, 50, 50];

var table = new sn_pdfgeneratorutils.Table(true, columnWidths, false);

table.addCell(cell);

var colNum = cell.getColumn();

gs.info("The column position for cell is " + colNum);

Saída:

The column position for cell is 1

Célula – getRow()

Obtém o número de linhas nas quais a célula está localizada.

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

Tabela 13. Retorna
Tipo	Descrição
Número	Número da posição da linha de uma célula.

O exemplo a seguir mostra como obter o número de uma posição de linha para uma célula.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var rowWidths = [100, 50, 50];

var table = new sn_pdfgeneratorutils.Table(true, rowWidths, false);

table.addCell(cell);

var rowNum = cell.getRow();

gs.info("The row position for cell is " + rowNum);

Saída:

The row position for cell is 4927

Célula – setBackGgroundColor(cor da cor)

Especifica uma cor de fundo para a célula.

Tabela 14. Parâmetros
Nome	Tipo	Descrição
cor	Cor	Cor de fundo.

Tabela 15. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir a cor de fundo da célula. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

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

cell.setBackGroundColor(color);

Célula – setBorder(largura do número)

Define uma borda para todas as quatro bordas de uma célula.

Tabela 16. Parâmetros
Nome	Tipo	Descrição
largura	Número	Largura da borda da célula em pontos.

Tabela 17. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula de um ponto para todas as quatro bordas de uma célula. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorder(width);

Célula – setBorderBottom(largura do número)

Define uma borda para o limite inferior de uma célula.

Tabela 18. Parâmetros
Nome	Tipo	Descrição
largura	Número	Largura da borda da célula em pontos.

Tabela 19. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorder(width);

Célula – setBorderLeft(largura do número)

Define uma borda para o limite esquerdo de uma célula.

Tabela 20. Parâmetros
Nome	Tipo	Descrição
largura	Número	Largura da borda da célula em pontos.

Tabela 21. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula do lado esquerdo. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setLeftBorder(width);

Célula – setBorderRight(largura do número)

Define uma borda para o limite direito de uma célula.

Tabela 22. Parâmetros
Nome	Tipo	Descrição
largura	Número	Largura da borda da célula em pontos.

Tabela 23. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula do lado direito. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setRightBorder(width);

Célula – setBorderTop(largura do número)

Define uma borda para o limite superior de uma célula.

Tabela 24. Parâmetros
Nome	Tipo	Descrição
largura	Número	Largura da borda da célula em pontos.

Tabela 25. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula superior. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorderTop(width);

Célula – setColoredBorder(Cor, largura do número)

Define uma borda colorida para todas as quatro bordas de uma célula.

Tabela 26. Parâmetros
Nome	Tipo	Descrição
cor	Cor	Cor da borda da célula.
largura	Número	Largura da borda da célula em pontos.

Tabela 27. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula colorida. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

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

cell.setColoredBorder(borderColor, width);

Célula – setColoredBorderBottom(Cor, largura do número)

Define uma borda colorida para o limite inferior de uma célula.

Tabela 28. Parâmetros
Nome	Tipo	Descrição
cor	Cor	Cor da borda da célula.
largura	Número	Largura da borda da célula em pontos.

Tabela 29. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda inferior de célula colorida. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

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

cell.setColoredBorderBottom(borderColor, width);

Célula – setColoredBorderLeft(Cor, largura do número)

Define uma borda colorida para o limite esquerdo de uma célula.

Tabela 30. Parâmetros
Nome	Tipo	Descrição
cor	Cor	Cor da borda da célula.
largura	Número	Largura da borda da célula em pontos.

Tabela 31. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda esquerda de célula colorida. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

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

cell.setColoredBorderLeft(borderColor, width);

Célula – setColoredBorderRight(Cor, largura do número)

Define uma borda colorida para o limite direito de uma célula.

Tabela 32. Parâmetros
Nome	Tipo	Descrição
cor	Cor	Cor da borda da célula.
largura	Número	Largura da borda da célula em pontos.

Tabela 33. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula direita colorida. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

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

cell.setColoredBorderRight(borderColor, width);

Célula – setColoredBorderTop(Cor, largura do número)

Define uma borda colorida para o limite superior de uma célula.

Tabela 34. Parâmetros
Nome	Tipo	Descrição
cor	Cor	Cor da borda da célula.
largura	Número	Largura da borda da célula em pontos.

Tabela 35. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma borda de célula superior colorida. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

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

cell.setColoredBorderTop(borderColor, width);

Célula – setHeight(Altura do número)

Define a altura de uma célula.

Tabela 36. Parâmetros
Nome	Tipo	Descrição
valor	Número	Altura da célula em pontos.

Tabela 37. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma altura de célula de 10 pontos. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 10;

cell.setHeight(height);

Célula – setHorizontalAlignment(cadeia de caracteres Alinhamento)

Define o alinhamento horizontal desta célula.

Tabela 38. Parâmetros
Nome	Tipo	Descrição
alinhamento	Cadeia de caracteres	Configuração de alinhamento horizontal. Valores válidos: center: alinha o conteúdo ao centro. left: alinha o conteúdo à esquerda. à direita: alinha o conteúdo à direita.

Tabela 39. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o alinhamento horizontal em uma célula. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "center";

cell.setHorizontalAlignment(alignment);

Célula – setMaxHeight(Number value)

Define a altura máxima de uma célula.

Tabela 40. Parâmetros
Nome	Tipo	Descrição
valor	Número	Altura máxima da célula em pontos.

Tabela 41. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma altura máxima de célula de 409 pontos. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 409;

cell.setMaxHeight(height);

Célula – setMaxWidth(valor flutuante)

Define a largura máxima de uma célula.

Tabela 42. Parâmetros
Nome	Tipo	Descrição
valor	Número	Largura máxima da célula em pontos.

Tabela 43. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma largura máxima de célula de 1530 pontos. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1530;

cell.setMaxWidth(width);

Célula – setMinHeight(Number value)

Define a altura mínima de uma célula.

Tabela 44. Parâmetros
Nome	Tipo	Descrição
valor	Número	Altura mínima da célula em pontos.

Tabela 45. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma altura mínima de célula de 12,75 pontos. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 12.75;

cell.setMinHeight(height);

Célula – setMinWidth(Number value)

Define a largura mínima de uma célula.

Tabela 46. Parâmetros
Nome	Tipo	Descrição
valor	Número	Largura mínima da célula em pontos.

Tabela 47. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir uma largura mínima de célula de 50,58 pontos. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 50.58;

cell.setMinWidth(width);

Célula – setOpacity(Opacidade de número)

Define a opacidade do conteúdo, das bordas e do plano de fundo da célula.

Nota:

Esta configuração afeta todos os elementos secundários da célula.

Tabela 48. Parâmetros
Nome	Tipo	Descrição
opacidade	Número	Valor decimal flutuante de 0 a 1, no qual 0 é transparente e 1 é totalmente opaco. Padrão: 0

Tabela 49. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir a opacidade de uma célula.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var opacity = 0.5;

cell.setOpacity(opacity);

Célula – setPading (preenchimento de número)

Define o preenchimento de todos os quatro lados de uma célula com a mesma largura.

Consulte também:

Tabela 50. Parâmetros
Nome	Tipo	Descrição
preenchimento	Número	Largura de preenchimento em pontos como um valor decimal.

Tabela 51. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir a célula inferior como um ponto. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPadding(padding);

Célula – setPadingBottom(Preenchimento de número)

Define o valor da largura do preenchimento inferior de uma célula.

Consulte também:

Tabela 52. Parâmetros
Nome	Tipo	Descrição
preenchimento	Número	Largura de preenchimento em pontos como um valor decimal.

Tabela 53. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o preenchimento da célula inferior como um ponto. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingBottom(padding);

Célula – setPadingLeft(Preenchimento de número)

Define o valor da largura do preenchimento esquerdo de uma célula.

Consulte também:

Tabela 54. Parâmetros
Nome	Tipo	Descrição
preenchimento	Número	Largura de preenchimento em pontos como um valor decimal.

Tabela 55. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o preenchimento da célula esquerda como um ponto. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingLeft(padding);

Célula – setPadingRight(preenchimento de número)

Define o valor da largura de preenchimento à direita de uma célula.

Consulte também:

Tabela 56. Parâmetros
Nome	Tipo	Descrição
preenchimento	Número	Largura de preenchimento em pontos como um valor decimal.

Tabela 57. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o preenchimento da célula à direita para um ponto. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingRight(padding);

Célula – setPadingTop(Preenchimento de número)

Define o valor da largura de preenchimento superior de uma célula.

Consulte também:

Tabela 58. Parâmetros
Nome	Tipo	Descrição
preenchimento	Número	Largura de preenchimento em pontos como um valor decimal.

Tabela 59. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o preenchimento da célula superior como um ponto. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingTop(padding);

Célula – setTextAlignment(cadeia de caracteres Alinhamento)

Define o alinhamento do texto desta célula.

Tabela 60. 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. text-justified: modifica o espaço entre os 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 61. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o texto da célula para o alinhamento à esquerda.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "text-left";

cell.setTextAlignment(alignment);

Célula – setVerticalAlignment(cadeia de caracteres alinhamento)

Define o alinhamento vertical desta célula.

Tabela 62. Parâmetros
Nome	Tipo	Descrição
alinhamento	Cadeia de caracteres	Configuração de alinhamento vertical. Valores válidos: inferior: alinha o conteúdo na parte inferior. mid: alinha o conteúdo ao centro. top: alinha o conteúdo com a parte superior.

Tabela 63. Retorna
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o alinhamento vertical em uma célula. Para obter um exemplo de uso de documento, consulte Document API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "mid";

cell.setVerticalAlignment(alignment);