Word.Table class

Gibt die Ausrichtung der Tabelle an der Seitenspalte an. Der Wert kann ,centered oderright seinleft.

alignment: Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified";

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

Gibt das TableColumnCollection -Objekt zurück, das die Spalten in der Tabelle darstellt.

readonly columns: Word.TableColumnCollection;

Eigenschaftswert

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Gibt die Beschreibung der Tabelle an.

description: string;

Eigenschaftswert

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Ruft die Auflistung der Endnoten in der Tabelle ab.

readonly endnotes: Word.NoteItemCollection;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.5 ]

Ruft die Auflistung von Field -Objekten in der Tabelle ab.

readonly fields: Word.FieldCollection;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.4 ]

Ruft die Schriftart ab. Verwenden Sie diese Option zum Abrufen und Festlegen des Schriftartnamens, der Größe, der Farbe und anderer Eigenschaften.

readonly font: Word.Font;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Auflistung der Fußnoten in der Tabelle ab.

readonly footnotes: Word.NoteItemCollection;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.5 ]

Gibt die Anzahl der Headerzeilen an.

headerRowCount: number;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt die horizontale Ausrichtung jeder Zelle in der Tabelle an. Der Wert kann ,centered ,right oderjustified sein.left

horizontalAlignment: Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified";

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

Gibt an, ob alle Zeilen der Tabelle uniform sind.

readonly isUniform: boolean;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Schachtelungsebene der Tabelle ab. Tabellen der obersten Ebene haben Ebene 1.

readonly nestingLevel: number;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den übergeordneten Text der Tabelle ab.

readonly parentBody: Word.Body;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft das Inhaltssteuerelement ab, das die Tabelle enthält. Löst einen Fehler aus ItemNotFound , wenn kein übergeordnetes Inhaltssteuerelement vorhanden ist.

readonly parentContentControl: Word.ContentControl;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft das Inhaltssteuerelement ab, das die Tabelle enthält. Wenn kein übergeordnetes Inhaltssteuerelement vorhanden ist, gibt diese Methode ein Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

readonly parentContentControlOrNullObject: Word.ContentControl;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Tabelle ab, die diese Tabelle enthält. Löst einen Fehler aus ItemNotFound , wenn er nicht in einer Tabelle enthalten ist.

readonly parentTable: Word.Table;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Tabellenzelle ab, die diese Tabelle enthält. Löst einen Fehler aus ItemNotFound , wenn er nicht in einer Tabellenzelle enthalten ist.

readonly parentTableCell: Word.TableCell;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Tabellenzelle ab, die diese Tabelle enthält. Wenn sie nicht in einer Tabellenzelle enthalten ist, gibt diese Methode ein Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

readonly parentTableCellOrNullObject: Word.TableCell;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Tabelle ab, die diese Tabelle enthält. Wenn sie nicht in einer Tabelle enthalten ist, gibt diese Methode ein -Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

readonly parentTableOrNullObject: Word.Table;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Anzahl der Zeilen in der Tabelle ab.

readonly rowCount: number;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft alle Zeilen der Tabelle ab.

readonly rows: Word.TableRowCollection;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets content alignment details about the first row of the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const firstTableRow: Word.TableRow = firstTable.rows.getFirst();
  firstTableRow.load(["horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table's first row:`, `- Horizontal alignment of every cell in the row: ${firstTableRow.horizontalAlignment}`, `- Vertical alignment of every cell in the row: ${firstTableRow.verticalAlignment}`);
});

Gibt das ShadingUniversal -Objekt zurück, das die Schattierung der Tabelle darstellt.

readonly shading: Word.ShadingUniversal;

Eigenschaftswert

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Gibt die Schattierungsfarbe an. Die Farbe wird im Format "#RRGGBB" oder mit dem Namen der Farbe angegeben.

shadingColor: string;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt den Formatvorlagennamen für die Tabelle an. Verwenden Sie diese Eigenschaft für benutzerdefinierte Formatvorlagen und lokalisierte Formatvorlagennamen. Informationen zur Verwendung der integrierten Formatvorlagen, die zwischen Gebietsschemas portabel sind, finden Sie unter der Eigenschaft "styleBuiltIn".

style: string;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt an, ob die Tabelle über gebänderte Spalten verfügt.

styleBandedColumns: boolean;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt an, ob die Tabelle über gebänderte Zeilen verfügt.

styleBandedRows: boolean;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt den integrierten Formatvorlagennamen für die Tabelle an. Verwenden Sie diese Eigenschaft für integrierte Formatvorlagen, die zwischen Gebietsschemas portabel sind. Informationen zum Verwenden benutzerdefinierter Formatvorlagen oder lokalisierter Namen finden Sie unter der Eigenschaft "style".

styleBuiltIn: Word.BuiltInStyleName | "Other" | "Normal" | "Heading1" | "Heading2" | "Heading3" | "Heading4" | "Heading5" | "Heading6" | "Heading7" | "Heading8" | "Heading9" | "Toc1" | "Toc2" | "Toc3" | "Toc4" | "Toc5" | "Toc6" | "Toc7" | "Toc8" | "Toc9" | "FootnoteText" | "Header" | "Footer" | "Caption" | "FootnoteReference" | "EndnoteReference" | "EndnoteText" | "Title" | "Subtitle" | "Hyperlink" | "Strong" | "Emphasis" | "NoSpacing" | "ListParagraph" | "Quote" | "IntenseQuote" | "SubtleEmphasis" | "IntenseEmphasis" | "SubtleReference" | "IntenseReference" | "BookTitle" | "Bibliography" | "TocHeading" | "TableGrid" | "PlainTable1" | "PlainTable2" | "PlainTable3" | "PlainTable4" | "PlainTable5" | "TableGridLight" | "GridTable1Light" | "GridTable1Light_Accent1" | "GridTable1Light_Accent2" | "GridTable1Light_Accent3" | "GridTable1Light_Accent4" | "GridTable1Light_Accent5" | "GridTable1Light_Accent6" | "GridTable2" | "GridTable2_Accent1" | "GridTable2_Accent2" | "GridTable2_Accent3" | "GridTable2_Accent4" | "GridTable2_Accent5" | "GridTable2_Accent6" | "GridTable3" | "GridTable3_Accent1" | "GridTable3_Accent2" | "GridTable3_Accent3" | "GridTable3_Accent4" | "GridTable3_Accent5" | "GridTable3_Accent6" | "GridTable4" | "GridTable4_Accent1" | "GridTable4_Accent2" | "GridTable4_Accent3" | "GridTable4_Accent4" | "GridTable4_Accent5" | "GridTable4_Accent6" | "GridTable5Dark" | "GridTable5Dark_Accent1" | "GridTable5Dark_Accent2" | "GridTable5Dark_Accent3" | "GridTable5Dark_Accent4" | "GridTable5Dark_Accent5" | "GridTable5Dark_Accent6" | "GridTable6Colorful" | "GridTable6Colorful_Accent1" | "GridTable6Colorful_Accent2" | "GridTable6Colorful_Accent3" | "GridTable6Colorful_Accent4" | "GridTable6Colorful_Accent5" | "GridTable6Colorful_Accent6" | "GridTable7Colorful" | "GridTable7Colorful_Accent1" | "GridTable7Colorful_Accent2" | "GridTable7Colorful_Accent3" | "GridTable7Colorful_Accent4" | "GridTable7Colorful_Accent5" | "GridTable7Colorful_Accent6" | "ListTable1Light" | "ListTable1Light_Accent1" | "ListTable1Light_Accent2" | "ListTable1Light_Accent3" | "ListTable1Light_Accent4" | "ListTable1Light_Accent5" | "ListTable1Light_Accent6" | "ListTable2" | "ListTable2_Accent1" | "ListTable2_Accent2" | "ListTable2_Accent3" | "ListTable2_Accent4" | "ListTable2_Accent5" | "ListTable2_Accent6" | "ListTable3" | "ListTable3_Accent1" | "ListTable3_Accent2" | "ListTable3_Accent3" | "ListTable3_Accent4" | "ListTable3_Accent5" | "ListTable3_Accent6" | "ListTable4" | "ListTable4_Accent1" | "ListTable4_Accent2" | "ListTable4_Accent3" | "ListTable4_Accent4" | "ListTable4_Accent5" | "ListTable4_Accent6" | "ListTable5Dark" | "ListTable5Dark_Accent1" | "ListTable5Dark_Accent2" | "ListTable5Dark_Accent3" | "ListTable5Dark_Accent4" | "ListTable5Dark_Accent5" | "ListTable5Dark_Accent6" | "ListTable6Colorful" | "ListTable6Colorful_Accent1" | "ListTable6Colorful_Accent2" | "ListTable6Colorful_Accent3" | "ListTable6Colorful_Accent4" | "ListTable6Colorful_Accent5" | "ListTable6Colorful_Accent6" | "ListTable7Colorful" | "ListTable7Colorful_Accent1" | "ListTable7Colorful_Accent2" | "ListTable7Colorful_Accent3" | "ListTable7Colorful_Accent4" | "ListTable7Colorful_Accent5" | "ListTable7Colorful_Accent6";

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt an, ob die Tabelle über eine erste Spalte mit einer speziellen Formatvorlage verfügt.

styleFirstColumn: boolean;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt an, ob die Tabelle eine letzte Spalte mit einem speziellen Format aufweist.

styleLastColumn: boolean;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt an, ob die Tabelle über eine (letzte) Gesamtzeile mit einer speziellen Formatvorlage verfügt.

styleTotalRow: boolean;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die untergeordneten Tabellen ab, die eine Ebene tiefer verschachtelt sind.

readonly tables: Word.TableCollection;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt den Titel der Tabelle an.

title: string;

Eigenschaftswert

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Gibt die Textwerte in der Tabelle als 2D-JavaScript-Array an.

values: string[][];

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Gibt die vertikale Ausrichtung jeder Zelle in der Tabelle an. Der Wert kann ,center oderbottom seintop.

verticalAlignment: Word.VerticalAlignment | "Mixed" | "Top" | "Center" | "Bottom";

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

Gibt die Breite der Tabelle in Punkt an.

width: number;

Eigenschaftswert

Hinweise

[ API-Satz: WordApi 1.3 ]

Fügt am Anfang oder Ende der Tabelle Spalten hinzu, wobei die erste oder letzte vorhandene Spalte als Vorlage verwendet wird. Dies gilt für einheitliche Tabellen. Falls Zeichenfolgenwerte angegeben werden, werden diese in den neu eingefügten Zeilen festgelegt.

addColumns(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", columnCount: number, values?: string[][]): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Fügt am Anfang oder Ende der Tabelle Zeilen hinzu, wobei die erste oder letzte vorhandene Zeile als Vorlage verwendet wird. Falls Zeichenfolgenwerte angegeben werden, werden diese in den neu eingefügten Zeilen festgelegt.

addRows(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", rowCount: number, values?: string[][]): Word.TableRowCollection;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Übernimmt die angegebene Formatvorlage, behält jedoch die von einem Benutzer direkt angewendete Formatierung bei.

applyStyleDirectFormatting(styleName: string): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Bestimmt, wie Microsoft Word die Tabellengröße ändert, wenn AutoAnpassen verwendet wird.

autoFitBehavior(behavior: Word.AutoFitBehavior): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Bestimmt, wie Microsoft Word die Tabellengröße ändert, wenn AutoAnpassen verwendet wird.

autoFitBehavior(behavior: "FixedSize" | "Content" | "Window"): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Passt die Tabellenspalten automatisch an die Breite des Fensters an.

autoFitWindow(): void;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Weist einer Tabelle ein vordefiniertes Aussehen zu.

autoFormat(options?: Word.TableAutoFormatOptions): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Löscht den Inhalt der Tabelle.

clear(): void;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Konvertiert eine Tabelle in Text.

convertToText(options?: Word.TableConvertToTextOptions): Word.Range;

Parameter

Gibt zurück

Ein Range -Objekt, das den konvertierten Text darstellt.

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Löscht die gesamte Tabelle.

delete(): void;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Löscht bestimmte Spalten. Dies gilt für einheitliche Tabellen.

deleteColumns(columnIndex: number, columnCount?: number): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Löscht bestimmte Zeilen.

deleteRows(rowIndex: number, rowCount?: number): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Verteilt die Breite der Spalten gleichmäßig. Dies gilt für einheitliche Tabellen.

distributeColumns(): void;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Rahmenart für den angegebenen Rahmen ab.

getBorder(borderLocation: Word.BorderLocation): Word.TableBorder;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets border details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const borderLocation = Word.BorderLocation.top;
  const border: Word.TableBorder = firstTable.getBorder(borderLocation);
  border.load(["type", "color", "width"]);
  await context.sync();

  console.log(`Details about the ${borderLocation} border of the first table:`, `- Color: ${border.color}`, `- Type: ${border.type}`, `- Width: ${border.width} points`);
});

Ruft die Rahmenart für den angegebenen Rahmen ab.

getBorder(borderLocation: "Top" | "Left" | "Bottom" | "Right" | "InsideHorizontal" | "InsideVertical" | "Inside" | "Outside" | "All"): Word.TableBorder;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die Tabellenzelle in einer angegebenen Zeile und Spalte ab. Löst einen Fehler aus ItemNotFound , wenn die angegebene Tabellenzelle nicht vorhanden ist.

getCell(rowIndex: number, cellIndex: number): Word.TableCell;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/table-cell-access.yaml

// Gets the content of the first cell in the first table.
await Word.run(async (context) => {
  const firstCell: Word.Body = context.document.body.tables.getFirst().getCell(0, 0).body;
  firstCell.load("text");

  await context.sync();
  console.log("First cell's text is: " + firstCell.text);
});

Ruft die Tabellenzelle in einer angegebenen Zeile und Spalte ab. Wenn die angegebene Tabellenzelle nicht vorhanden ist, gibt diese Methode ein -Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

getCellOrNullObject(rowIndex: number, cellIndex: number): Word.TableCell;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den Textabstand in Punkt ab.

getCellPadding(cellPaddingLocation: Word.CellPaddingLocation): OfficeExtension.ClientResult<number>;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets cell padding details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const cellPaddingLocation = Word.CellPaddingLocation.right;
  const cellPadding = firstTable.getCellPadding(cellPaddingLocation);
  await context.sync();

  console.log(
    `Cell padding details about the ${cellPaddingLocation} border of the first table: ${cellPadding.value} points`
  );
});

Ruft den Textabstand in Punkt ab.

getCellPadding(cellPaddingLocation: "Top" | "Left" | "Bottom" | "Right"): OfficeExtension.ClientResult<number>;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die nächste Tabelle ab. Löst einen Fehler aus ItemNotFound , wenn diese Tabelle die letzte ist.

getNext(): Word.Table;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft die nächste Tabelle ab. Wenn es sich bei dieser Tabelle um die letzte Tabelle handelt, gibt diese Methode ein -Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

getNextOrNullObject(): Word.Table;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den Absatz nach der Tabelle ab. Löst einen Fehler aus ItemNotFound , wenn nach der Tabelle kein Absatz vorhanden ist.

getParagraphAfter(): Word.Paragraph;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den Absatz nach der Tabelle ab. Wenn nach der Tabelle kein Absatz vorhanden ist, gibt diese Methode ein Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

getParagraphAfterOrNullObject(): Word.Paragraph;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den Absatz vor der Tabelle ab. Löst einen Fehler aus ItemNotFound , wenn vor der Tabelle kein Absatz vorhanden ist.

getParagraphBefore(): Word.Paragraph;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den Absatz vor der Tabelle ab. Wenn vor der Tabelle kein Absatz vorhanden ist, gibt diese Methode ein Objekt zurück, dessen isNullObject -Eigenschaft auf truefestgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.

getParagraphBeforeOrNullObject(): Word.Paragraph;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Ruft den Bereich ab, der diese Tabelle enthält, oder den Bereich am Anfang bzw. Ende der Tabelle.

getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | "Whole" | "Start" | "End" | "After"): Word.Range;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Fügt ein Inhaltssteuerelement in der Tabelle ein.

insertContentControl(): Word.ContentControl;

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Fügt an der angegebenen Position einen Absatz ein.

insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Fügt eine Tabelle mit der angegebenen Anzahl von Zeilen und Spalten ein.

insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", values?: string[][]): Word.Table;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: Word.Interfaces.TableLoadOptions): Word.Table;

Parameter

Gibt zurück

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames?: string | string[]): Word.Table;

Parameter

Gibt zurück

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Word.Table;

Parameter

Gibt zurück

Führt die Zellen zusammen, die inklusive durch eine erste und letzte Zelle begrenzt sind.

mergeCells(topRow: number, firstCell: number, bottomRow: number, lastCell: number): Word.TableCell;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.4 ]

Updates die Tabelle mit den Merkmalen des vordefinierten Tabellenformats, das beim Aufruf der autoFormat -Methode festgelegt wurde. Das vordefinierte Standardformat ist TableFormatType.none.

reapplyAutoFormat(): void;

Gibt zurück

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Führt eine Suche mit den angegebenen Suchoptionen für den Bereich des Table Objekts aus. Die Suchergebnisse sind eine Auflistung von Range -Objekten.

search(searchText: string, searchOptions?: Word.SearchOptions | {
            ignorePunct?: boolean;
            ignoreSpace?: boolean;
            matchCase?: boolean;
            matchPrefix?: boolean;
            matchSuffix?: boolean;
            matchWholeWord?: boolean;
            matchWildcards?: boolean;
        }): Word.RangeCollection;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Wählt die Tabelle oder die Position am Anfang oder Ende der Tabelle aus und navigiert die Word-Benutzeroberfläche an diese Position.

select(selectionMode?: Word.SelectionMode): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Wählt die Tabelle oder die Position am Anfang oder Ende der Tabelle aus und navigiert die Word-Benutzeroberfläche an diese Position.

select(selectionMode?: "Select" | "Start" | "End"): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.

set(properties: Interfaces.TableUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parameter

Gibt zurück

Legt mehrere Eigenschaften für das -Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.

set(properties: Word.Table): void;

Parameter

Gibt zurück

Legt den Textabstand in Punkt fest.

setCellPadding(cellPaddingLocation: Word.CellPaddingLocation, cellPadding: number): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Legt den Textabstand in Punkt fest.

setCellPadding(cellPaddingLocation: "Top" | "Left" | "Bottom" | "Right", cellPadding: number): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApi 1.3 ]

Sortiert die angegebene Tabelle.

sort(options?: Word.TableSortOptions): void;

Parameter

Gibt zurück

Hinweise

[ API-Satz: WordApiDesktop 1.4 ]

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON -Methode des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche Word.Table Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als Word.Interfaces.TableData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

toJSON(): Word.Interfaces.TableData;

Gibt zurück

Nachverfolgung des Objekts zwecks automatischer Anpassung auf der Grundlage der umgebenden Änderungen im Dokument. Dieser Aufruf ist eine Kurzform für context.trackedObjects.add(thisObject). Wenn Sie dieses Objekt über .sync Aufrufe hinweg und außerhalb der sequenziellen Ausführung eines ".run"-Batches verwenden und beim Festlegen einer Eigenschaft oder beim Aufrufen einer Methode für das Objekt den Fehler "InvalidObjectPath" erhalten, müssen Sie das Objekt der nachverfolgten Objektauflistung hinzufügen, als das Objekt zum ersten Mal erstellt wurde. Wenn dieses Objekt Teil einer Auflistung ist, sollten Sie auch die übergeordnete Auflistung nachverfolgen.

track(): Word.Table;

Gibt zurück

Gibt den diesem Objekt zugewiesenen Arbeitsspeicher frei, wenn das Objekt zuvor nachverfolgt wurde. Dieser Aufruf ist die Kurzform für context.trackedObjects.remove(thisObject). Viele nachverfolgte Objekte verlangsamen die Ausführung der Hostanwendung, also achten Sie darauf, alle hinzugefügten Objekte nach abgeschlossener Verwendung freizugeben. Sie müssen aufrufen context.sync() , bevor die Speicherfreigabe wirksam wird.

untrack(): Word.Table;

Gibt zurück