Zelle: Bereichsbezogen, Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 11 Minuten Lesedauer

    • Erstellt ein Zellenobjekt als Zelle in einer Tabelle. Sie können diese API verwenden, um die Zelle zu formatieren und zusätzliche Blöcke wie Absätze und Bilder hinzuzufügen.

    Diese API ist Teil des Plugins ServiceNow PDF Generation Utilities (com.snc.apppdfgenerator) und wird im Namespace sn_pdfgeneratorutils bereitgestellt. Das Plugin ist standardmäßig aktiviert.

    Diese API ist eine Komponente, die mit der Dokument-API zum Generieren einer PDF-Datei verwendet wird.

    Zelle: Zelle (Number rowspan, Nummer colspan)

    Instantiiert ein neues Zellenobjekt. Erstellt eine Zelle, die eine benutzerdefinierte Anzahl von Zellenbereichen in der Tabelle einnimmt.

    Hinweis:
    Wenn Sie für einen der Parameter eine negative Zahl angeben, wird der Wert auf 1 festgelegt.
    Tabelle : 1. Parameter
    Name Typ Beschreibung
    rowspan Nummer Anzahl der Zeilen, die diese Zelle belegen soll.

    Standard: 0
    Spalte Nummer Anzahl der Spalten, die diese Zelle belegen soll.

    Standard: 0

    Das folgende Beispiel zeigt, wie ein Zellenobjekt erstellt wird, das sich über eine einzelne Zeile und eine einzelne Spalte erstreckt.

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

    Zelle – addImage(Image image)

    Fügt ein Bild zu einer Tabellenzelle hinzu.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Bild Bild Bild, das einer Tabellenzelle hinzugefügt werden soll.
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein vorhandener Bildanhang instanziiert und einer Zelle in einer Tabelle hinzugefügt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

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

cell.addImage(image);

    Zelle – addParagraph(Paragraph paragraph)

    Fügt Text zu einer Tabellenzelle hinzu.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Absatz Absatz Text, der einer Tabellenzelle hinzugefügt werden soll.
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Absatzobjekte instanziiert und die Inhaltszellen in einer Tabelle hinzugefügt werden. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

    Zelle – addStyle(Style Style)

    Wendet einen vordefinierten Stil auf Tabellenzellen an.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    -Stil Stil Auf dieses Element anzuwendender Stil.
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Stil auf eine Tabellenzelle angewendet wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

    Zelle – addTable(Table table)

    Fügt einer Zelle eine Tabelle hinzu.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Tabelle Tabelle Tabelle, die einer Zelle hinzugefügt werden soll.
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Tabellenobjekt instanziiert und einer Zelle hinzugefügt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var columnWidths = [100, 50, 50];

var table = new Table(columnWidths, false);

cell.addTable(table);

    Zelle – getColumn()

    Ruft die Nummer der Spalte ab, in der sich die Zelle befindet.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Nummer Nummer der Spaltenposition für eine Zelle.

    Das folgende Beispiel zeigt, wie die Nummer einer Spaltenposition für eine Zelle abgerufen wird.

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

    Ausgabe:

    The column position for cell is 1

    Zelle – getRow()

    Ruft die Anzahl der Zeilen ab, in denen sich die Zelle befindet.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Nummer Nummer der Zeilenposition für eine Zelle.

    Das folgende Beispiel zeigt, wie die Nummer einer Zeilenposition für eine Zelle abgerufen wird.

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

    Ausgabe:

    The row position for cell is 4927

    Zelle – setBackGrundColor(Farbe color)

    Gibt eine Hintergrundfarbe für die Zelle an.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Farbe Farbe Hintergrundfarbe.
    Tabelle : 15. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die Hintergrundfarbe der Zelle festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter 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);

    Zelle – setBorder(Number width)

    Legt einen Rahmen für alle vier Kanten einer Zelle fest.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 17. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Zellenrahmen eines Punktes auf alle vier Ränder einer Zelle festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 1.0;

cell.setBorder(width);

    Zelle – setBorderBottom(Number width)

    Legt einen Rahmen für die untere Grenze einer Zelle fest.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 19. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Zellenrahmen festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 1.0;

cell.setBorder(width);

    Zelle – setBorderLeft(Number width)

    Legt einen Rahmen für die linke Grenze einer Zelle fest.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 21. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen linken Zellenrahmen festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 1.0;

cell.setLeftBorder(width);

    Zelle – setBorderRight(Number width)

    Legt einen Rahmen für die rechte Grenze einer Zelle fest.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 23. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Zellenrahmen auf der rechten Seite festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 1.0;

cell.setRightBorder(width);

    Zelle – setBorderTop(Number width)

    Legt einen Rahmen für die Obergrenze einer Zelle fest.

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 25. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein oberer Zellenrahmen festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 1.0;

cell.setBorderTop(width);

    Zelle – setColoredBorder(Farbe color, Number width)

    Legt einen farbigen Rahmen für alle vier Kanten einer Zelle fest.

    Tabelle : 26. Parameter
    Name Typ Beschreibung
    Farbe Farbe Zellenrahmenfarbe.
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 27. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen farbigen Zellenrahmen festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter 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);

    Zelle – setColoredBorderBottom(Color color, Number width)

    Legt einen farbigen Rahmen für die untere Grenze einer Zelle fest.

    Tabelle : 28. Parameter
    Name Typ Beschreibung
    Farbe Farbe Zellenrahmenfarbe.
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 29. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen farbigen unteren Zellenrahmen festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter 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);

    Zelle – setColoredBorderLeft(Farbe color, Number width)

    Legt einen farbigen Rahmen für die linke Grenze einer Zelle fest.

    Tabelle : 30. Parameter
    Name Typ Beschreibung
    Farbe Farbe Zellenrahmenfarbe.
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 31. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen farbigen linken Zellenrahmen festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter 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);

    Zelle – setColoredBorderRight(Farbe color, Number width)

    Legt einen farbigen Rahmen für die rechte Grenze einer Zelle fest.

    Tabelle : 32. Parameter
    Name Typ Beschreibung
    Farbe Farbe Zellenrahmenfarbe.
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 33. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen farbigen rechten Zellenrahmen festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter 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);

    Zelle – setColoredBorderTop(Farbe color, Number width)

    Legt einen farbigen Rahmen für die Obergrenze einer Zelle fest.

    Tabelle : 34. Parameter
    Name Typ Beschreibung
    Farbe Farbe Zellenrahmenfarbe.
    width Nummer Zellenrahmenbreite in Punkten.
    Tabelle : 35. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen farbigen oberen Zellenrahmen festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter 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);

    Zelle – setHeight(Number height)

    Legt die Höhe einer Zelle fest.

    Tabelle : 36. Parameter
    Name Typ Beschreibung
    Wert Nummer Zellenhöhe in Punkten.
    Tabelle : 37. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie eine Zellenhöhe von 10 Punkten festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var height = 10;

cell.setHeight(height);

    Zelle – setHorizontalAlignment(String ausgerichtet)

    Legt die horizontale Ausrichtung für diese Zelle fest.

    Tabelle : 38. Parameter
    Name Typ Beschreibung
    Ausrichtung Zeichenfolge Einstellung für horizontale Ausrichtung.
    Gültige Werte:
    • Mitte: Richten Sie den Inhalt zentriert aus.
    • left: Richtet den Inhalt links aus.
    • right: Richtet den Inhalt rechts aus.
    Tabelle : 39. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die horizontale Ausrichtung für eine Zelle festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var alignment = "center";

cell.setHorizontalAlignment(alignment);

    Zelle – setMaxHeight(Number value)

    Legt die maximale Höhe einer Zelle fest.

    Tabelle : 40. Parameter
    Name Typ Beschreibung
    Wert Nummer Maximale Zellenhöhe in Punkten.
    Tabelle : 41. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie eine maximale Zellenhöhe von 409 Punkten festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var height = 409;

cell.setMaxHeight(height);

    Zelle – setMaxWidth(gloat value)

    Legt die maximale Breite einer Zelle fest.

    Tabelle : 42. Parameter
    Name Typ Beschreibung
    Wert Nummer Maximale Zellenbreite in Punkten.
    Tabelle : 43. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie eine maximale Zellenbreite von 1530 Punkten festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 1530;

cell.setMaxWidth(width);

    Zelle – setMinHeight(Number value)

    Legt die Mindesthöhe einer Zelle fest.

    Tabelle : 44. Parameter
    Name Typ Beschreibung
    Wert Nummer Minimale Zellenhöhe in Punkten.
    Tabelle : 45. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie eine minimale Zellenhöhe von 12,75 Punkt festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var height = 12.75;

cell.setMinHeight(height);

    Zelle – setMinWidth(Number value)

    Legt die Mindestbreite einer Zelle fest.

    Tabelle : 46. Parameter
    Name Typ Beschreibung
    Wert Nummer Minimale Zellenbreite in Punkten.
    Tabelle : 47. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie eine minimale Zellenbreite von 50,58 Punkten festlegen. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var width = 50.58;

cell.setMinWidth(width);

    Zelle – setOpacity(Number opacity)

    Legt die Deckkraft von Zelleninhalt, Rahmen und Hintergrund fest.

    Hinweis:
    Diese Einstellung wirkt sich auf alle untergeordneten Elemente der Zelle aus.
    Tabelle : 48. Parameter
    Name Typ Beschreibung
    Opazität Nummer Fließender Dezimalwert von 0 bis 1, wobei 0 transparent und 1 vollständig undurchsichtig ist.

    Standard: 0
    Tabelle : 49. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die Opazität einer Zelle festgelegt wird.

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

var opacity = 0.5;

cell.setOpacity(opacity);

    Zelle – setPading(Number pading)

    Legt die Auffüllung aller vier Seiten einer Zelle auf dieselbe Breite fest.

    Siehe auch:
    Tabelle : 50. Parameter
    Name Typ Beschreibung
    Abstand Nummer Auffüllbreite in Punkten als Dezimalwert.
    Tabelle : 51. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die unterste Zelle auf einen Punkt festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var padding = 1.0;

cell.setPadding(padding);

    Zelle – setPappingBottom(Number pading)

    Legt den Wert der unteren Auffüllungsbreite einer Zelle fest.

    Siehe auch:
    Tabelle : 52. Parameter
    Name Typ Beschreibung
    Abstand Nummer Auffüllbreite in Punkten als Dezimalwert.
    Tabelle : 53. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie der Abstand der unteren Zelle auf einen Punkt festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var padding = 1.0;

cell.setPaddingBottom(padding);

    Zelle – setPaditionLeft(Number pading)

    Legt den Wert der linken Auffüllungsbreite einer Zelle fest.

    Siehe auch:
    Tabelle : 54. Parameter
    Name Typ Beschreibung
    Abstand Nummer Auffüllbreite in Punkten als Dezimalwert.
    Tabelle : 55. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie der Abstand der linken Zelle auf einen Punkt festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var padding = 1.0;

cell.setPaddingLeft(padding);

    Zelle – setPaditionRechte(Number pading)

    Legt den Wert der rechten Auffüllungsbreite einer Zelle fest.

    Siehe auch:
    Tabelle : 56. Parameter
    Name Typ Beschreibung
    Abstand Nummer Auffüllbreite in Punkten als Dezimalwert.
    Tabelle : 57. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie der rechte Zellenabstand auf einen Punkt festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var padding = 1.0;

cell.setPaddingRight(padding);

    Zelle – setPaditionTop(Number pading)

    Legt den Wert der oberen Auffüllungsbreite einer Zelle fest.

    Siehe auch:
    Tabelle : 58. Parameter
    Name Typ Beschreibung
    Abstand Nummer Auffüllbreite in Punkten als Dezimalwert.
    Tabelle : 59. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie der Abstand der oberen Zelle auf einen Punkt festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var padding = 1.0;

cell.setPaddingTop(padding);

    Zelle – setTextAlignment(String-Ausrichtung)

    Legt die Textausrichtung dieser Zelle fest.

    Tabelle : 60. Parameter
    Name Typ Beschreibung
    Ausrichtung Zeichenfolge Textausrichtungsposition.
    Gültige Werte:
    • text-center: Richtet den Text zentriert aus.
    • textausgerichtet: Ändert den Abstand zwischen Zeichen, um den Text zwischen der linken und rechten Seite vollständig auszufüllen. Die letzte Zeile ist links ausgerichtet.
    • text-justified-all: Richtet die Textausrichtung einschließlich der letzten Zeile aus.
    • text-left: Text links ausrichten.
    • text-right: Text rechts ausrichten.
    Tabelle : 61. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie der Zellentext auf die linke Ausrichtung festgelegt wird.

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

var alignment = "text-left";

cell.setTextAlignment(alignment);

    Zelle – setVerticalAlignment(String ausgerichtet)

    Legt die vertikale Ausrichtung für diese Zelle fest.

    Tabelle : 62. Parameter
    Name Typ Beschreibung
    Ausrichtung Zeichenfolge Einstellung für vertikale Ausrichtung.
    Gültige Werte:
    • Bottom: Richtet den Inhalt unten aus.
    • mid: Richtet den Inhalt zentriert aus.
    • oben: Richtet den Inhalt oben aus.
    Tabelle : 63. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie die vertikale Ausrichtung für eine Zelle festgelegt wird. Ein Beispiel für die Verwendung von Dokumenten finden Sie unter Document API.

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

var alignment = "mid";

cell.setVerticalAlignment(alignment);