Edit

Share via

PowerPoint.TableColumnProperties interface

Package:
powerpoint

Provides the table column properties.

Remarks

API set: PowerPointApi 1.8

Used by

Examples

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

Properties

columnWidth

Represents the desired width of each column in points, or is undefined.

When a table is being added, for columns whose width is undefined, the column width will be calculated by evenly dividing the remaining width of the table amongst those columns. If the table doesn't have a defined width, a default column width will be used.

Property Details

columnWidth

Represents the desired width of each column in points, or is undefined.

When a table is being added, for columns whose width is undefined, the column width will be calculated by evenly dividing the remaining width of the table amongst those columns. If the table doesn't have a defined width, a default column width will be used.

columnWidth?: number | undefined;

Property Value

number | undefined

Remarks

API set: PowerPointApi 1.8

Examples

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