PowerPoint.Table class

表の列数を取得します。

readonly columnCount: number;

プロパティ値

注釈

API セット: PowerPointApi 1.8

テーブル内の列のコレクションを取得します。

readonly columns: PowerPoint.TableColumnCollection;

プロパティ値

注釈

API セット: PowerPointApi 1.9

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

context: RequestContext;

プロパティ値

表の行数を取得します。

readonly rowCount: number;

プロパティ値

注釈

API セット: PowerPointApi 1.8

テーブル内の行のコレクションを取得します。

readonly rows: PowerPoint.TableRowCollection;

プロパティ値

注釈

API セット: PowerPointApi 1.9

表のスタイル設定を取得します。

readonly styleSettings: PowerPoint.TableStyleSettings;

プロパティ値

注釈

API セット: PowerPointApi 1.9

テーブルのすべての値を取得します。

readonly values: string[][];

プロパティ値

注釈

API セット: PowerPointApi 1.8

テーブルの値と書式設定をクリアします。

clear(options?: PowerPoint.TableClearOptions): void;

パラメーター

返品

注釈

API セット: PowerPointApi 1.9

指定した rowIndex と columnIndexのセルを取得します。

getCellOrNullObject(rowIndex: number, columnIndex: number): PowerPoint.TableCell;

パラメーター

返品

指定された行と列のセル。 セルが結合された領域の一部であり、結合された領域の左上のセルではない場合、 isNullObject プロパティが true に設定されたオブジェクトが返されます。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

注釈

API セット: PowerPointApi 1.8

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml

// Updates a table's values.
await PowerPoint.run(async (context) => {
  const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;

  // Add a table (which is a type of Shape).
  const shape = shapes.addTable(4, 3);
  let table = shape.getTable();
  table.load();
  await context.sync();

  // Update values in the table.
  for (let rowIndex = 0; rowIndex < table.rowCount; rowIndex++) {
    for (let columnIndex = 0; columnIndex < table.columnCount; columnIndex++) {
      const cell = table.getCellOrNullObject(rowIndex, columnIndex);
      cell.text = generateRandomString();
    }
  }

  await context.sync();
});

テーブルの結合された領域を表すセルのコレクションを取得します。

getMergedAreas(): PowerPoint.TableCellCollection;

返品

テーブルの結合された領域を表すセルを持つ TableCellCollection 。

注釈

API セット: PowerPointApi 1.8

テーブルの図形オブジェクトを取得します。

getShape(): PowerPoint.Shape;

返品

注釈

API セット: PowerPointApi 1.8

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(options?: PowerPoint.Interfaces.TableLoadOptions): PowerPoint.Table;

パラメーター

返品

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames?: string | string[]): PowerPoint.Table;

パラメーター

返品

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.Table;

パラメーター

返品

rowIndex と columnIndex で指定されたセルから始まる結合領域を作成します。 マージされた領域は、指定された数の行と列にまたがります。

mergeCells(rowIndex: number, columnIndex: number, rowCount: number, columnCount: number): void;

パラメーター

返品

注釈

API セット: PowerPointApi 1.9

API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (次に、JSON.stringify渡されたオブジェクトの toJSON メソッドを呼び出します)。元の PowerPoint.Table オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( PowerPoint.Interfaces.TableData と型指定) を返します。

toJSON(): PowerPoint.Interfaces.TableData;

返品