PowerPoint.TableCell class

Obtient la collection de bordures pour la cellule de tableau.

readonly borders: PowerPoint.Borders;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Obtient le nombre de colonnes de tableau sur lesquelles cette cellule s’étend. Sera supérieur ou égal à 1.

readonly columnCount: number;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Obtient l’index de colonne de base zéro de la cellule dans la table.

readonly columnIndex: number;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

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 la couleur de remplissage de la cellule du tableau.

readonly fill: PowerPoint.ShapeFill;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Obtient la police de la cellule du tableau.

readonly font: PowerPoint.ShapeFont;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Spécifie l’alignement horizontal du texte dans la cellule du tableau. Retourne null si le texte de la cellule contient des alignements différents.

horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Spécifie le niveau de retrait du texte dans la cellule du tableau. Retourne null si le texte de la cellule contient différents niveaux de retrait.

indentLevel: number | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Obtient l’ensemble de marges dans la cellule du tableau.

readonly margins: PowerPoint.Margins;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Obtient le nombre de lignes de tableau sur laquelle cette cellule s’étend. Sera supérieur ou égal à 1.

readonly rowCount: number;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Obtient l’index de ligne de base zéro de la cellule dans la table.

readonly rowIndex: number;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie le contenu du texte de la cellule du tableau.

text: string;

Valeur de propriété

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

Spécifie le contenu de la cellule de tableau sous la forme d’un tableau d’objets. Chaque TextRun objet représente une séquence d’un ou plusieurs caractères qui partagent les mêmes attributs de police.

textRuns: PowerPoint.TextRun[];

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Spécifie l’alignement vertical du texte dans la cellule du tableau.

verticalAlignment: PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered";

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

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.TableCellLoadOptions): PowerPoint.TableCell;

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.TableCell;

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.TableCell;

Paramètres

Retours

Redimensionne la cellule du tableau pour qu’elle s’étende sur un nombre spécifié de lignes et de colonnes. Si rowCount ou columnCount est supérieur à 1, la cellule devient une zone fusionnée. Si la cellule est déjà une zone fusionnée et que rowCount et columnCount ont la valeur 1, la cellule n’est plus une zone fusionnée.

resize(rowCount: number, columnCount: number): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

Fractionne la cellule en nombre spécifié de lignes et de colonnes.

split(rowCount: number, columnCount: number): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

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.TableCell est un objet API, la toJSON méthode renvoie un objet JavaScript brut (typé en tant PowerPoint.Interfaces.TableCellDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

toJSON(): PowerPoint.Interfaces.TableCellData;

Retours