PowerPoint.Table class

Obtient le nombre de colonnes dans le tableau.

readonly columnCount: number;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Obtient la collection de colonnes dans la table.

readonly columns: PowerPoint.TableColumnCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.9 ]

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

context: RequestContext;

Valeur de propriété

Obtient le nombre de lignes dans le tableau.

readonly rowCount: number;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Obtient la collection de lignes dans la table.

readonly rows: PowerPoint.TableRowCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.9 ]

Obtient les paramètres de style de tableau.

readonly styleSettings: PowerPoint.TableStyleSettings;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.9 ]

Obtient toutes les valeurs de la table.

readonly values: string[][];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Efface les valeurs de table et la mise en forme.

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

Paramètres

Retours

Remarques

[ Ensemble d’API : PowerPointApi 1.9 ]

Obtient la cellule au niveau des et spécifiés rowIndexcolumnIndex.

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

Paramètres

Retours

Cellule au niveau de la ligne et de la colonne spécifiées. Si la cellule fait partie d’une zone fusionnée et non de la cellule supérieure gauche de la zone fusionnée, un objet avec la isNullObject propriété définie true sur est retourné. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

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

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

Obtient une collection de cellules qui représentent les zones fusionnées de la table.

getMergedAreas(): PowerPoint.TableCellCollection;

Retours

avec des TableCellCollection cellules qui représentent les zones fusionnées de la table.

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Obtient l’objet shape de la table.

getShape(): PowerPoint.Shape;

Retours

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

Retours

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

Retours

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

Retours

Crée une zone fusionnée à partir de la cellule spécifiée par rowIndex et columnIndex. La zone fusionnée s’étend sur un nombre spécifié de lignes et de colonnes.

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

Paramètres

Retours

Remarques

[ Ensemble d’API : PowerPointApi 1.9 ]

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringify, à son tour, appelle la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine PowerPoint.Table est un objet API, la toJSON méthode renvoie un objet JavaScript brut (typé en tant PowerPoint.Interfaces.TableDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

toJSON(): PowerPoint.Interfaces.TableData;

Retours