Freigeben über

PowerPoint.TableAddOptions interface

Paket:
powerpoint

Stellt die verfügbaren Optionen beim Hinzufügen einer Tabelle dar.

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

// Specifies the width and height of a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying the width and height.
  shapes.addTable(3, 4, {
    width: 600,
    height: 400
  });
  await context.sync();
});

Eigenschaften

columns

Gibt , sofern angegeben, Eigenschaften für jede Spalte in der Tabelle an. Die Arraylänge muss der Anzahl der Spalten in der Tabelle entsprechen. Geben Sie ein leeres Objekt für Spalten an, die die Standardformatierung verwenden sollen.
height

Gibt die Höhe der Tabelle in Punkt an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

Hinweis: Wenn die Tabellenhöhe nicht gleichmäßig durch die Anzahl der Zeilen teilbar ist, legt PowerPoint sie auf den nächsten möglichen Wert fest. Beispielsweise kann eine Höhe von 400 für 3 Zeilen zu einer tatsächlichen Höhe von 399,9999 führen.
left

Gibt den Abstand in Punkt von der linken Seite der Tabelle zur linken Seite der Folie an. Die Tabelle wird horizontal zentriert, wenn dieser Parameter nicht angegeben wird.
mergedAreas

Wenn angegeben, stellt einen rechteckigen Bereich dar, in dem mehrere Zellen als einzelne Zelle angezeigt werden.
rows

Gibt bei Angabe der Eigenschaften für jede Zeile in der Tabelle an. Die Arraylänge muss der Anzahl der Zeilen in der Tabelle entsprechen. Geben Sie ein leeres Objekt für Zeilen an, die die Standardformatierung verwenden sollen.
specificCellProperties

Wenn angegeben, gibt die Eigenschaften für jede Zelle in der Tabelle an.

Dies sollte ein 2D-Array mit der gleichen Anzahl von Zeilen und Spalten wie die Tabelle sein. Wenn eine Zelle keine bestimmte Formatierung erfordert, geben Sie ein leeres Objekt für diese Zelle an. Nur für die obere linke Zelle eines zusammengeführten are können Eigenschaften angegeben werden, die auf den gesamten zusammengeführten Bereich angewendet werden. Für die anderen Zellen im zusammengeführten Bereich sollte ein leeres Objekt bereitgestellt werden.
style

Gibt einen Wert an, der das Tabellenformat darstellt.
top

Gibt den Abstand vom oberen Rand der Tabelle bis zum oberen Rand der Folie in Punkt an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet.
uniformCellProperties

Gibt die Formatierung an, die einheitlich auf alle Tabellenzellen angewendet wird.

Verwenden Sie specificCellProperties, um bestimmte Formatierungen auf einzelne Zellen anzuwenden.

Wenn uniformCellProperties und specificCellProperties nicht definiert sind, wird die Standardformatierung verwendet, und die Standardtabellenformatvorlage wird angewendet. Die Tabelle hat die gleiche Darstellung wie beim Hinzufügen einer Tabelle über die PowerPoint-Benutzeroberfläche.

Um eine einfache Darstellung für die Tabelle bereitzustellen, legen Sie diese Eigenschaft auf ein leeres Objekt fest, und geben Sie nicht an specificCellProperties.
values

Wenn angegeben, gibt die Werte für die Tabelle an.

Wenn die Tabelle Bereiche zusammengeführter Zellen enthält, kann nur die obere linke Zelle jedes zusammengeführten Bereichs einen nicht leeren Zeichenfolgenwert aufweisen. Die anderen Zellen im zusammengeführten Bereich müssen eine leere Zeichenfolge sein.
width

Gibt die Breite der Tabelle in Punkt an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

Hinweis: Wenn die Tabellenbreite nicht gleichmäßig durch die Anzahl der Spalten teilbar ist, legt PowerPoint sie auf den nächsten möglichen Wert fest. Beispielsweise kann eine Breite von 400 für 3 Spalten zu einer tatsächlichen Breite von 399,9999 führen.

Details zur Eigenschaft

columns

Gibt , sofern angegeben, Eigenschaften für jede Spalte in der Tabelle an. Die Arraylänge muss der Anzahl der Spalten in der Tabelle entsprechen. Geben Sie ein leeres Objekt für Spalten an, die die Standardformatierung verwenden sollen.

columns?: PowerPoint.TableColumnProperties[];

Eigenschaftswert

PowerPoint.TableColumnProperties[]

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

// Specifies the column widths and row heights of a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying column widths and row heights.
  shapes.addTable(3, 4, {
    columns: [{ columnWidth: 100 }, { columnWidth: 200 }, { columnWidth: 100 }, { columnWidth: 200 }],
    rows: [{ rowHeight: 60 }, { rowHeight: 120 }, { rowHeight: 180 }]
  });
  await context.sync();
});

height

Gibt die Höhe der Tabelle in Punkt an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

Hinweis: Wenn die Tabellenhöhe nicht gleichmäßig durch die Anzahl der Zeilen teilbar ist, legt PowerPoint sie auf den nächsten möglichen Wert fest. Beispielsweise kann eine Höhe von 400 für 3 Zeilen zu einer tatsächlichen Höhe von 399,9999 führen.

height?: number | undefined;

Eigenschaftswert

number | undefined

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

// Specifies the width and height of a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying the width and height.
  shapes.addTable(3, 4, {
    width: 600,
    height: 400
  });
  await context.sync();
});

left

Gibt den Abstand in Punkt von der linken Seite der Tabelle zur linken Seite der Folie an. Die Tabelle wird horizontal zentriert, wenn dieser Parameter nicht angegeben wird.

left?: number | undefined;

Eigenschaftswert

number | undefined

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

mergedAreas

Wenn angegeben, stellt einen rechteckigen Bereich dar, in dem mehrere Zellen als einzelne Zelle angezeigt werden.

mergedAreas?: PowerPoint.TableMergedAreaProperties[];

Eigenschaftswert

PowerPoint.TableMergedAreaProperties[]

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

// Specifies the merge areas of a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying one 2x2 merged area.
  shapes.addTable(3, 4, {
    values: [
      ["A", "BB", "CCC", "DDDD"],
      ["E", "FF", "", "HHHH"],
      ["1", "", "", "1234"]
    ],
    mergedAreas: [{ rowIndex: 1, columnIndex: 1, rowCount: 2, columnCount: 2 }]
  });
  await context.sync();
});

rows

Gibt bei Angabe der Eigenschaften für jede Zeile in der Tabelle an. Die Arraylänge muss der Anzahl der Zeilen in der Tabelle entsprechen. Geben Sie ein leeres Objekt für Zeilen an, die die Standardformatierung verwenden sollen.

rows?: PowerPoint.TableRowProperties[];

Eigenschaftswert

PowerPoint.TableRowProperties[]

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

// Specifies the column widths and row heights of a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying column widths and row heights.
  shapes.addTable(3, 4, {
    columns: [{ columnWidth: 100 }, { columnWidth: 200 }, { columnWidth: 100 }, { columnWidth: 200 }],
    rows: [{ rowHeight: 60 }, { rowHeight: 120 }, { rowHeight: 180 }]
  });
  await context.sync();
});

specificCellProperties

Wenn angegeben, gibt die Eigenschaften für jede Zelle in der Tabelle an.

Dies sollte ein 2D-Array mit der gleichen Anzahl von Zeilen und Spalten wie die Tabelle sein. Wenn eine Zelle keine bestimmte Formatierung erfordert, geben Sie ein leeres Objekt für diese Zelle an. Nur für die obere linke Zelle eines zusammengeführten are können Eigenschaften angegeben werden, die auf den gesamten zusammengeführten Bereich angewendet werden. Für die anderen Zellen im zusammengeführten Bereich sollte ein leeres Objekt bereitgestellt werden.

specificCellProperties?: PowerPoint.TableCellProperties[][];

Eigenschaftswert

PowerPoint.TableCellProperties[][]

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

// Specifies the font formatting and fill colors of the cells in a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying font formatting and fill colors.
  shapes.addTable(3, 4, {
    values: [
      ["A", "BB", "CCC", "DDDD"],
      ["E", "FF", "GGG", "HHHH"],
      ["1", "12", "123", "1234"]
    ],
    specificCellProperties: [
      [
        { fill: { color: "red" }, font: { color: "yellow", name: "Calibri" } },
        { fill: { color: "#0048ba" }, font: { color: "yellow", name: "Coolvetica" } },
        { fill: { color: "red" }, font: { color: "yellow", italic: true } },
        { fill: { color: "red" }, font: { color: "#9966cc", strikethrough: true } }
      ],
      [
        { fill: { color: "#fbceb1" }, font: { color: "yellow", doubleStrikethrough: true } },
        { fill: { color: "red" }, font: { color: "yellow", subscript: true } },
        { fill: { color: "#0048ba" }, font: { color: "yellow", superscript: true } },
        { fill: { color: "red" }, font: { color: "yellow" } }
      ],
      [
        { fill: { color: "red" }, font: { color: "#b0bf1a" } },
        { fill: { color: "#9966cc" }, font: { color: "yellow" } },
        { fill: { color: "#b0bf1a" }, font: { color: "yellow" } },
        { fill: { color: "red" }, font: { color: "#fbceb1" } }
      ]
    ]
  });
  await context.sync();
});

style

Gibt einen Wert an, der das Tabellenformat darstellt.

style?: PowerPoint.TableStyle | "NoStyleNoGrid" | "ThemedStyle1Accent1" | "ThemedStyle1Accent2" | "ThemedStyle1Accent3" | "ThemedStyle1Accent4" | "ThemedStyle1Accent5" | "ThemedStyle1Accent6" | "NoStyleTableGrid" | "ThemedStyle2Accent1" | "ThemedStyle2Accent2" | "ThemedStyle2Accent3" | "ThemedStyle2Accent4" | "ThemedStyle2Accent5" | "ThemedStyle2Accent6" | "LightStyle1" | "LightStyle1Accent1" | "LightStyle1Accent2" | "LightStyle1Accent3" | "LightStyle1Accent4" | "LightStyle1Accent5" | "LightStyle1Accent6" | "LightStyle2" | "LightStyle2Accent1" | "LightStyle2Accent2" | "LightStyle2Accent3" | "LightStyle2Accent4" | "LightStyle2Accent5" | "LightStyle2Accent6" | "LightStyle3" | "LightStyle3Accent1" | "LightStyle3Accent2" | "LightStyle3Accent3" | "LightStyle3Accent4" | "LightStyle3Accent5" | "LightStyle3Accent6" | "MediumStyle1" | "MediumStyle1Accent1" | "MediumStyle1Accent2" | "MediumStyle1Accent3" | "MediumStyle1Accent4" | "MediumStyle1Accent5" | "MediumStyle1Accent6" | "MediumStyle2" | "MediumStyle2Accent1" | "MediumStyle2Accent2" | "MediumStyle2Accent3" | "MediumStyle2Accent4" | "MediumStyle2Accent5" | "MediumStyle2Accent6" | "MediumStyle3" | "MediumStyle3Accent1" | "MediumStyle3Accent2" | "MediumStyle3Accent3" | "MediumStyle3Accent4" | "MediumStyle3Accent5" | "MediumStyle3Accent6" | "MediumStyle4" | "MediumStyle4Accent1" | "MediumStyle4Accent2" | "MediumStyle4Accent3" | "MediumStyle4Accent4" | "MediumStyle4Accent5" | "MediumStyle4Accent6" | "DarkStyle1" | "DarkStyle1Accent1" | "DarkStyle1Accent2" | "DarkStyle1Accent3" | "DarkStyle1Accent4" | "DarkStyle1Accent5" | "DarkStyle1Accent6" | "DarkStyle2" | "DarkStyle2Accent1" | "DarkStyle2Accent2" | "DarkStyle2Accent3";

Eigenschaftswert

PowerPoint.TableStyle | "NoStyleNoGrid" | "ThemedStyle1Accent1" | "ThemedStyle1Accent2" | "ThemedStyle1Accent3" | "ThemedStyle1Accent4" | "ThemedStyle1Accent5" | "ThemedStyle1Accent6" | "NoStyleTableGrid" | "ThemedStyle2Accent1" | "ThemedStyle2Accent2" | "ThemedStyle2Accent3" | "ThemedStyle2Accent4" | "ThemedStyle2Accent5" | "ThemedStyle2Accent6" | "LightStyle1" | "LightStyle1Accent1" | "LightStyle1Accent2" | "LightStyle1Accent3" | "LightStyle1Accent4" | "LightStyle1Accent5" | "LightStyle1Accent6" | "LightStyle2" | "LightStyle2Accent1" | "LightStyle2Accent2" | "LightStyle2Accent3" | "LightStyle2Accent4" | "LightStyle2Accent5" | "LightStyle2Accent6" | "LightStyle3" | "LightStyle3Accent1" | "LightStyle3Accent2" | "LightStyle3Accent3" | "LightStyle3Accent4" | "LightStyle3Accent5" | "LightStyle3Accent6" | "MediumStyle1" | "MediumStyle1Accent1" | "MediumStyle1Accent2" | "MediumStyle1Accent3" | "MediumStyle1Accent4" | "MediumStyle1Accent5" | "MediumStyle1Accent6" | "MediumStyle2" | "MediumStyle2Accent1" | "MediumStyle2Accent2" | "MediumStyle2Accent3" | "MediumStyle2Accent4" | "MediumStyle2Accent5" | "MediumStyle2Accent6" | "MediumStyle3" | "MediumStyle3Accent1" | "MediumStyle3Accent2" | "MediumStyle3Accent3" | "MediumStyle3Accent4" | "MediumStyle3Accent5" | "MediumStyle3Accent6" | "MediumStyle4" | "MediumStyle4Accent1" | "MediumStyle4Accent2" | "MediumStyle4Accent3" | "MediumStyle4Accent4" | "MediumStyle4Accent5" | "MediumStyle4Accent6" | "DarkStyle1" | "DarkStyle1Accent1" | "DarkStyle1Accent2" | "DarkStyle1Accent3" | "DarkStyle1Accent4" | "DarkStyle1Accent5" | "DarkStyle1Accent6" | "DarkStyle2" | "DarkStyle2Accent1" | "DarkStyle2Accent2" | "DarkStyle2Accent3"

Hinweise

[ API-Satz: PowerPointApi 1.9 ]

top

Gibt den Abstand vom oberen Rand der Tabelle bis zum oberen Rand der Folie in Punkt an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet.

top?: number | undefined;

Eigenschaftswert

number | undefined

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

uniformCellProperties

Gibt die Formatierung an, die einheitlich auf alle Tabellenzellen angewendet wird.

Verwenden Sie specificCellProperties, um bestimmte Formatierungen auf einzelne Zellen anzuwenden.

Wenn uniformCellProperties und specificCellProperties nicht definiert sind, wird die Standardformatierung verwendet, und die Standardtabellenformatvorlage wird angewendet. Die Tabelle hat die gleiche Darstellung wie beim Hinzufügen einer Tabelle über die PowerPoint-Benutzeroberfläche.

Um eine einfache Darstellung für die Tabelle bereitzustellen, legen Sie diese Eigenschaft auf ein leeres Objekt fest, und geben Sie nicht an specificCellProperties.

uniformCellProperties?: PowerPoint.TableCellProperties;

Eigenschaftswert

PowerPoint.TableCellProperties

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

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

  // Add a table, specifying border styles.
  shapes.addTable(3, 4, {
    values: [
      ["A", "BB", "CCC", "DDDD"],
      ["E", "FF", "GGG", "HHHH"],
      ["1", "12", "123", "1234"]
    ],
    uniformCellProperties: {
      borders: {
        left: { color: "blue", dashStyle: PowerPoint.ShapeLineDashStyle.solid, weight: 4 },
        right: { color: "blue", dashStyle: PowerPoint.ShapeLineDashStyle.solid, weight: 4 },
        top: { color: "red", dashStyle: PowerPoint.ShapeLineDashStyle.longDashDotDot, weight: 2 },
        bottom: { color: "red", dashStyle: PowerPoint.ShapeLineDashStyle.longDashDotDot, weight: 2 }
      }
    }
  });
  await context.sync();
});

values

Wenn angegeben, gibt die Werte für die Tabelle an.

Wenn die Tabelle Bereiche zusammengeführter Zellen enthält, kann nur die obere linke Zelle jedes zusammengeführten Bereichs einen nicht leeren Zeichenfolgenwert aufweisen. Die anderen Zellen im zusammengeführten Bereich müssen eine leere Zeichenfolge sein.

values?: 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

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

  // Add a table, specifying cell values.
  const shape = shapes.addTable(3, 4, {
    values: [
      ["A", "BB", "CCC", "DDDD"],
      ["E", "FF", "GGG", "HHHH"],
      ["1", "12", "123", "1234"]
    ]
  });
  await context.sync();
});

width

Gibt die Breite der Tabelle in Punkt an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

Hinweis: Wenn die Tabellenbreite nicht gleichmäßig durch die Anzahl der Spalten teilbar ist, legt PowerPoint sie auf den nächsten möglichen Wert fest. Beispielsweise kann eine Breite von 400 für 3 Spalten zu einer tatsächlichen Breite von 399,9999 führen.

width?: number | undefined;

Eigenschaftswert

number | undefined

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

// Specifies the width and height of a table.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table, specifying the width and height.
  shapes.addTable(3, 4, {
    width: 600,
    height: 400
  });
  await context.sync();
});