PowerPoint.TableAddOptions interface

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

columns?: PowerPoint.TableColumnProperties[];

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

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

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 sie 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ächstmö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

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

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

left?: number | undefined;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

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

mergedAreas?: PowerPoint.TableMergedAreaProperties[];

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

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

Gibt (falls angegeben) Eigenschaften für jede Zeile in der Tabelle an. Die Arraylänge muss gleich der Anzahl der Zeilen in der Tabelle sein. Geben Sie ein leeres Objekt für Zeilen an, die die Standardformatierung verwenden sollen.

rows?: PowerPoint.TableRowProperties[];

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

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

Gibt (sofern angegeben) 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 verbundenen Bereichs können Eigenschaften angegeben werden, die auf den gesamten verbundenen Bereich angewendet werden. Für die anderen Zellen im verbundenen Bereich sollte ein leeres Objekt bereitgestellt werden.

specificCellProperties?: PowerPoint.TableCellProperties[][];

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

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

Gibt den Wert an, der die Tabellenformatvorlage 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

Hinweise

API-Satz: PowerPointApi 1.9

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

top?: number | undefined;

Eigenschaftswert

Hinweise

API-Satz: PowerPointApi 1.8

Gibt die Formatierung an, die einheitlich für alle Tabellenzellen gilt.

Um einzelne Zellen gezielt zu formatieren, verwenden Sie specificCellProperties.

Wenn sowohl uniformCellProperties als auch specificCellProperties nicht definiert sind, wird die Standardformatierung verwendet, und die Standardtabellenformatvorlage wird angewendet. Die Tabelle hat das gleiche Aussehen, wie wenn der Benutzer eine Tabelle über die PowerPoint-Benutzeroberfläche hinzufügt.

Um der Tabelle ein einfaches Erscheinungsbild zu verleihen, legen Sie diese Eigenschaft auf ein leeres Objekt fest, und geben Sie specificCellPropertiesnicht an.

uniformCellProperties?: PowerPoint.TableCellProperties;

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

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

Falls angegeben, werden die Werte für die Tabelle angegeben.

Wenn die Tabelle Bereiche mit verbundenen Zellen enthält, kann nur die obere linke Zelle jedes verbundenen Bereichs einen nicht leeren Zeichenfolgenwert aufweisen. Die anderen Zellen im verbundenen Bereich müssen leere Zeichenfolgen sein.

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

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

Gibt die Breite der Tabelle in Punkten an. Wenn dieser Parameter nicht angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn sie 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ächstmö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

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