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 для трех столбцов может дать фактическую ширину 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 для трех столбцов может дать фактическую ширину 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();
});