PowerPoint.TableCell class

Ruft die Sammlung der Rahmen für die Tabellenzelle ab.

readonly borders: PowerPoint.Borders;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Ruft die Anzahl der Tabellenspalten ab, über die sich diese Zelle erstreckt. Wird größer oder gleich 1 sein.

readonly columnCount: number;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

Ruft den nullbasierten Spaltenindex der Zelle in der Tabelle ab.

readonly columnIndex: number;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

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

context: RequestContext;

Eigenschaftswert

Ruft die Füllfarbe der Tabellenzelle ab.

readonly fill: PowerPoint.ShapeFill;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Ruft die Schriftart der Tabellenzelle ab.

readonly font: PowerPoint.ShapeFont;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Gibt die horizontale Ausrichtung des Texts in der Tabellenzelle an. Gibt zurück null , wenn der Zellentext unterschiedliche Ausrichtungen enthält.

horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Gibt die Einzugsebene des Texts in der Tabellenzelle an. Gibt zurück null , ob der Zellentext verschiedene Einzugsebenen enthält.

indentLevel: number | null;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Ruft die Gruppe der Ränder in der Tabellenzelle ab.

readonly margins: PowerPoint.Margins;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Ruft die Anzahl der Tabellenzeilen ab, über die sich diese Zelle erstreckt. Wird größer oder gleich 1 sein.

readonly rowCount: number;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

Ruft den nullbasierten Zeilenindex der Zelle in der Tabelle ab.

readonly rowIndex: number;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

Gibt den Textinhalt der Tabellenzelle an.

text: string;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml

// Updates a table's values.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table (which is a type of Shape).
  const shape = shapes.addTable(4, 3);
  let table = shape.getTable();
  table.load();
  await context.sync();

  // Update values in the table.
  for (let rowIndex = 0; rowIndex < table.rowCount; rowIndex++) {
    for (let columnIndex = 0; columnIndex < table.columnCount; columnIndex++) {
      const cell = table.getCellOrNullObject(rowIndex, columnIndex);
      cell.text = generateRandomString();
    }
  }

  await context.sync();
});

Gibt den Inhalt der Tabellenzelle als Array von PowerPoint.TextRun-Objekten an. Jedes TextRun Objekt stellt eine Sequenz von einem oder mehreren Zeichen dar, die dieselben Schriftartattribute aufweisen.

textRuns: PowerPoint.TextRun[];

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

Gibt die vertikale Ausrichtung des Texts in der Tabellenzelle an.

verticalAlignment: PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered";

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.9

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?: PowerPoint.Interfaces.TableCellLoadOptions): PowerPoint.TableCell;

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[]): PowerPoint.TableCell;

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;
        }): PowerPoint.TableCell;

Parameter

Gibt zurück

Ändert die Größe der Tabellenzelle so, dass sie sich über eine angegebene Anzahl von Zeilen und Spalten erstreckt. Wenn rowCount oder columnCount größer als 1 sind, wird die Zelle zu einem verbundenen Bereich. Wenn die Zelle bereits ein verbundener Bereich ist und rowCount und columnCount auf 1 festgelegt sind, ist die Zelle kein verbundener Bereich mehr.

resize(rowCount: number, columnCount: number): void;

Parameter

Gibt zurück

Hinweise

API-Satz: PowerPointApi 1.9

Teilt die Zelle in die angegebene Anzahl von Zeilen und Spalten auf.

split(rowCount: number, columnCount: number): void;

Parameter

Gibt zurück

Hinweise

API-Satz: PowerPointApi 1.9

Ü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 sie übergeben wird.) Während das ursprüngliche PowerPoint.TableCell Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als PowerPoint.Interfaces.TableCellData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): PowerPoint.Interfaces.TableCellData;

Gibt zurück