Freigeben über

PowerPoint.TableCell class

  • Referenz
Paket:
powerpoint

Stellt eine Tabelle dar.

Extends
OfficeExtension.ClientObject

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

Eigenschaften

borders

Ruft die Auflistung der Rahmen für die Tabellenzelle ab.
columnCount

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

Ruft den nullbasierten Spaltenindex der Zelle in der Tabelle ab.
context

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

Ruft die Füllfarbe der Tabellenzelle ab.
font

Ruft die Schriftart der Tabellenzelle ab.
horizontalAlignment

Gibt die horizontale Ausrichtung des Texts in der Tabellenzelle an.
indentLevel

Gibt die Einzugsebene des Texts in der Tabellenzelle an.
margins

Ruft den Satz von Rändern in der Tabellenzelle ab.
rowCount

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

Ruft den nullbasierten Zeilenindex der Zelle in der Tabelle ab.
text

Gibt den Textinhalt der Tabellenzelle an.
textRuns

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

Gibt die vertikale Ausrichtung des Texts in der Tabellenzelle an.

Methoden

load(options)

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)

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)

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.
resize(rowCount, columnCount)

Ä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 zusammengeführten Bereich. Wenn die Zelle bereits ein zusammengeführter Bereich ist und rowCount und columnCount auf 1 festgelegt sind, ist die Zelle kein zusammengeführter Bereich mehr.
split(rowCount, columnCount)

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

Ü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 PowerPoint.TableCell Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als PowerPoint.Interfaces.TableCellData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

Details zur Eigenschaft

borders

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

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

readonly borders: PowerPoint.Borders;

Eigenschaftswert

PowerPoint.Borders

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

columnCount

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

readonly columnCount: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

columnIndex

Ruft den nullbasierten Spaltenindex der Zelle in der Tabelle ab.

readonly columnIndex: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

context

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

context: RequestContext;

Eigenschaftswert

PowerPoint.RequestContext

fill

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft die Füllfarbe der Tabellenzelle ab.

readonly fill: PowerPoint.ShapeFill;

Eigenschaftswert

PowerPoint.ShapeFill

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

font

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft die Schriftart der Tabellenzelle ab.

readonly font: PowerPoint.ShapeFont;

Eigenschaftswert

PowerPoint.ShapeFont

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

horizontalAlignment

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt die horizontale Ausrichtung des Texts in der Tabellenzelle an.

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

Eigenschaftswert

PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed"

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

indentLevel

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt die Einzugsebene des Texts in der Tabellenzelle an.

indentLevel: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

margins

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft den Satz von Rändern in der Tabellenzelle ab.

readonly margins: PowerPoint.Margins;

Eigenschaftswert

PowerPoint.Margins

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

rowCount

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

readonly rowCount: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

rowIndex

Ruft den nullbasierten Zeilenindex der Zelle in der Tabelle ab.

readonly rowIndex: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

text

Gibt den Textinhalt der Tabellenzelle an.

text: string;

Eigenschaftswert

string

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

textRuns

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

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

textRuns: PowerPoint.TextRun[];

Eigenschaftswert

PowerPoint.TextRun[]

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

verticalAlignment

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt die vertikale Ausrichtung des Texts in der Tabellenzelle an.

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

Eigenschaftswert

PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered"

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

Details zur Methode

load(options)

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

options
PowerPoint.Interfaces.TableCellLoadOptions

Stellt Optionen dafür bereit, welche Eigenschaften des -Objekts geladen werden sollen.

Gibt zurück

PowerPoint.TableCell

load(propertyNames)

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

propertyNames

string | string[]

Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.

Gibt zurück

PowerPoint.TableCell

load(propertyNamesAndPaths)

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

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select ist eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.

Gibt zurück

PowerPoint.TableCell

resize(rowCount, columnCount)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ä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 zusammengeführten Bereich. Wenn die Zelle bereits ein zusammengeführter Bereich ist und rowCount und columnCount auf 1 festgelegt sind, ist die Zelle kein zusammengeführter Bereich mehr.

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

Parameter

rowCount

number

Die Anzahl der Zeilen, über die sich die Zelle erstreckt. Muss größer als 0 sein.

columnCount

number

Die Anzahl der Spalten, über die sich die Zelle erstreckt. Muss größer als 0 sein.

Gibt zurück

void

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

split(rowCount, columnCount)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

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

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

Parameter

rowCount

number

Die Anzahl der Zeilen, in die aufgeteilt werden soll. Muss größer als 0 sein.

columnCount

number

Die Anzahl der Spalten, in die aufgeteilt werden soll. Muss größer als 0 sein.

Gibt zurück

void

Hinweise

[ API-Satz: PowerPointApi BETA (NUR VORSCHAU) ]

toJSON()

Ü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 PowerPoint.TableCell Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als PowerPoint.Interfaces.TableCellData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

toJSON(): PowerPoint.Interfaces.TableCellData;

Gibt zurück

PowerPoint.Interfaces.TableCellData