PowerPoint.TableAddOptions interface

Si elle est fournie, spécifie les propriétés de chaque colonne de la table. La longueur du tableau doit être égale au nombre de colonnes dans la table. Spécifiez un objet vide pour les colonnes qui doivent utiliser la mise en forme par défaut.

columns?: PowerPoint.TableColumnProperties[];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Spécifie la hauteur, en points, de la table. Une valeur par défaut est utilisée lorsque ce paramètre n’est pas fourni. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

Remarque : Si la hauteur du tableau n’est pas uniformément divisible par le nombre de lignes, PowerPoint la définit sur la valeur la plus proche possible. Par exemple, une hauteur de 400 pour 3 lignes peut entraîner une hauteur réelle de 399,9999.

height?: number | undefined;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Spécifie la distance, en points, entre le côté gauche du tableau et le côté gauche de la diapositive. La table est centrée horizontalement lorsque ce paramètre n’est pas fourni.

left?: number | undefined;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

S’il est spécifié, représente une zone rectangulaire où plusieurs cellules apparaissent sous la forme d’une seule cellule.

mergedAreas?: PowerPoint.TableMergedAreaProperties[];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Si elle est fournie, spécifie les propriétés de chaque ligne de la table. La longueur du tableau doit être égale au nombre de lignes de la table. Spécifiez un objet vide pour les lignes qui doivent utiliser la mise en forme par défaut.

rows?: PowerPoint.TableRowProperties[];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Si elle est fournie, spécifie les propriétés de chaque cellule du tableau.

Il doit s’agir d’un tableau 2D avec le même nombre de lignes et de colonnes que la table. Si une cellule ne nécessite pas de mise en forme spécifique, spécifiez un objet vide pour cette cellule. Seule la cellule supérieure gauche d’un fusionné peut avoir des propriétés spécifiées, qui seront appliquées à l’ensemble de la zone fusionnée. Pour les autres cellules de la zone fusionnée, un objet vide doit être fourni.

specificCellProperties?: PowerPoint.TableCellProperties[][];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Spécifie la valeur qui représente le style de tableau.

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";

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.9 ]

Spécifie la distance, en points, entre le bord supérieur du tableau et le bord supérieur de la diapositive. Une valeur par défaut est utilisée lorsque ce paramètre n’est pas fourni.

top?: number | undefined;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie la mise en forme qui s’applique uniformément à toutes les cellules du tableau.

Pour appliquer une mise en forme spécifique à des cellules individuelles, utilisez specificCellProperties.

Si uniformCellProperties et specificCellProperties ne sont pas définis, la mise en forme par défaut est utilisée et le style de tableau par défaut est appliqué. La table aura la même apparence que lorsque l’utilisateur ajoute une table via l’interface utilisateur PowerPoint.

Pour fournir une apparence simple à la table, définissez cette propriété sur un objet vide et ne spécifiez specificCellPropertiespas .

uniformCellProperties?: PowerPoint.TableCellProperties;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Si elle est fournie, spécifie les valeurs de la table.

Lorsque le tableau contient des zones de cellules fusionnées, seule la cellule supérieure gauche de chaque zone fusionnée peut avoir une valeur de chaîne non vide. Les autres cellules de la zone fusionnée doivent être une chaîne vide.

values?: string[][];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

Spécifie la largeur, en points, du tableau. Une valeur par défaut est utilisée lorsque ce paramètre n’est pas fourni. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

Remarque : Si la largeur du tableau n’est pas uniformément divisible par le nombre de colonnes, PowerPoint la définit sur la valeur la plus proche possible. Par exemple, une largeur de 400 pour 3 colonnes peut entraîner une largeur réelle de 399,9999.

width?: number | undefined;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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