Поделиться через

PowerPoint.TableAddOptions interface

Пакет:
powerpoint

Представляет доступные параметры при добавлении таблицы.

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

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

Свойства

columns

Если задано значение , задает свойства для каждого столбца в таблице. Длина массива должна быть равна количеству столбцов в таблице. Укажите пустой объект для столбцов, которые должны использовать форматирование по умолчанию.
height

Задает высоту таблицы (в точках). Если этот параметр не указан, используется значение по умолчанию. InvalidArgument Создает исключение, если задано отрицательное значение.

Примечание. Если высота таблицы не равномерно делится на количество строк, PowerPoint устанавливает для нее ближайшее возможное значение. Например, высота 400 для 3 строк может привести к фактической высоте 399,9999.
left

Указывает расстояние (в точках) от левой части таблицы до левой части слайда. Таблица находится по горизонтали, если этот параметр не указан.
mergedAreas

Если задано значение , представляет прямоугольную область, в которой несколько ячеек отображаются в виде одной ячейки.
rows

Если указан параметр , задает свойства для каждой строки в таблице. Длина массива должна быть равна количеству строк в таблице. Укажите пустой объект для строк, которые должны использовать форматирование по умолчанию.
specificCellProperties

Если задано значение , указывает свойства для каждой ячейки в таблице.

Это должен быть двухмерный массив с тем же количеством строк и столбцов, что и таблица. Если ячейка не требует определенного форматирования, укажите для нее пустой объект. Только верхняя левая ячейка объединенного объекта может иметь указанные свойства, которые будут применяться ко всей объединенной области. Для других ячеек в объединенной области должен быть указан пустой объект.
style

Задает значение, представляющее стиль таблицы.
top

Указывает расстояние (в точках) от верхнего края таблицы до верхнего края слайда. Если этот параметр не указан, используется значение по умолчанию.
uniformCellProperties

Задает форматирование, которое применяется ко всем ячейкам таблицы.

Чтобы применить определенное форматирование к отдельным ячейкам, используйте specificCellProperties.

Если значение uniformCellProperties и specificCellProperties не определено, будет использоваться форматирование по умолчанию и стиль таблицы по умолчанию. Таблица будет иметь тот же внешний вид, что и при добавлении таблицы с помощью пользовательского интерфейса PowerPoint.

Чтобы обеспечить простой внешний вид таблицы, задайте для этого свойства пустой объект и не указывайте specificCellProperties.
values

Если задано значение , задает значения для таблицы.

Если таблица содержит области объединенных ячеек, только левая верхняя ячейка каждой объединенной области может иметь непустое строковое значение. Другие ячейки в объединенной области должны быть пустой строкой.
width

Задает ширину таблицы (в точках). Если этот параметр не указан, используется значение по умолчанию. InvalidArgument Создает исключение, если задано отрицательное значение.

Примечание. Если ширина таблицы не равномерно делится на количество столбцов, PowerPoint устанавливает для нее ближайшее возможное значение. Например, ширина 400 для 3 столбцов может привести к фактической ширине 399,9999.

Сведения о свойстве

columns

Если задано значение , задает свойства для каждого столбца в таблице. Длина массива должна быть равна количеству столбцов в таблице. Укажите пустой объект для столбцов, которые должны использовать форматирование по умолчанию.

columns?: PowerPoint.TableColumnProperties[];

Значение свойства

PowerPoint.TableColumnProperties[]

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Задает высоту таблицы (в точках). Если этот параметр не указан, используется значение по умолчанию. InvalidArgument Создает исключение, если задано отрицательное значение.

Примечание. Если высота таблицы не равномерно делится на количество строк, PowerPoint устанавливает для нее ближайшее возможное значение. Например, высота 400 для 3 строк может привести к фактической высоте 399,9999.

height?: number | undefined;

Значение свойства

number | undefined

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Указывает расстояние (в точках) от левой части таблицы до левой части слайда. Таблица находится по горизонтали, если этот параметр не указан.

left?: number | undefined;

Значение свойства

number | undefined

Комментарии

[ Набор API: PowerPointApi 1.8 ]

mergedAreas

Если задано значение , представляет прямоугольную область, в которой несколько ячеек отображаются в виде одной ячейки.

mergedAreas?: PowerPoint.TableMergedAreaProperties[];

Значение свойства

PowerPoint.TableMergedAreaProperties[]

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Если указан параметр , задает свойства для каждой строки в таблице. Длина массива должна быть равна количеству строк в таблице. Укажите пустой объект для строк, которые должны использовать форматирование по умолчанию.

rows?: PowerPoint.TableRowProperties[];

Значение свойства

PowerPoint.TableRowProperties[]

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Если задано значение , указывает свойства для каждой ячейки в таблице.

Это должен быть двухмерный массив с тем же количеством строк и столбцов, что и таблица. Если ячейка не требует определенного форматирования, укажите для нее пустой объект. Только верхняя левая ячейка объединенного объекта может иметь указанные свойства, которые будут применяться ко всей объединенной области. Для других ячеек в объединенной области должен быть указан пустой объект.

specificCellProperties?: PowerPoint.TableCellProperties[][];

Значение свойства

PowerPoint.TableCellProperties[][]

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Задает значение, представляющее стиль таблицы.

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

Значение свойства

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"

Комментарии

[ Набор API: PowerPointApi 1.9 ]

top

Указывает расстояние (в точках) от верхнего края таблицы до верхнего края слайда. Если этот параметр не указан, используется значение по умолчанию.

top?: number | undefined;

Значение свойства

number | undefined

Комментарии

[ Набор API: PowerPointApi 1.8 ]

uniformCellProperties

Задает форматирование, которое применяется ко всем ячейкам таблицы.

Чтобы применить определенное форматирование к отдельным ячейкам, используйте specificCellProperties.

Если значение uniformCellProperties и specificCellProperties не определено, будет использоваться форматирование по умолчанию и стиль таблицы по умолчанию. Таблица будет иметь тот же внешний вид, что и при добавлении таблицы с помощью пользовательского интерфейса PowerPoint.

Чтобы обеспечить простой внешний вид таблицы, задайте для этого свойства пустой объект и не указывайте specificCellProperties.

uniformCellProperties?: PowerPoint.TableCellProperties;

Значение свойства

PowerPoint.TableCellProperties

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Если задано значение , задает значения для таблицы.

Если таблица содержит области объединенных ячеек, только левая верхняя ячейка каждой объединенной области может иметь непустое строковое значение. Другие ячейки в объединенной области должны быть пустой строкой.

values?: string[][];

Значение свойства

string[][]

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

// 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

Задает ширину таблицы (в точках). Если этот параметр не указан, используется значение по умолчанию. InvalidArgument Создает исключение, если задано отрицательное значение.

Примечание. Если ширина таблицы не равномерно делится на количество столбцов, PowerPoint устанавливает для нее ближайшее возможное значение. Например, ширина 400 для 3 столбцов может привести к фактической ширине 399,9999.

width?: number | undefined;

Значение свойства

number | undefined

Комментарии

[ Набор API: PowerPointApi 1.8 ]

Примеры

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