Word.Table class

Spécifie l’alignement de la table par rapport à la colonne de page. La valeur peut être left, centeredou right.

alignment: Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

Renvoie l’objet TableColumnCollection qui représente les colonnes de la table.

readonly columns: Word.TableColumnCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

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é

Spécifie la description de la table.

description: string;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Obtient la collection de notes de fin dans le tableau.

readonly endnotes: Word.NoteItemCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.5 ]

Obtient la collection d’objets Field dans la table.

readonly fields: Word.FieldCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.4 ]

Obtient la police. Utilisez cette propriété pour obtenir et définir le nom de la police, la taille, la couleur et d’autres propriétés.

readonly font: Word.Font;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient la collection de notes de bas de page dans le tableau.

readonly footnotes: Word.NoteItemCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.5 ]

Spécifie le nombre de lignes d’en-tête.

headerRowCount: number;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie l’alignement horizontal de chaque cellule du tableau. La valeur peut être left, centered, rightou justified.

horizontalAlignment: Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

Indique si toutes les lignes du tableau sont uniformes.

readonly isUniform: boolean;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le niveau d’imbrication du tableau. Les tableaux de niveau supérieur ont le niveau 1.

readonly nestingLevel: number;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le corps parent du tableau.

readonly parentBody: Word.Body;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le contrôle de contenu qui contient le tableau. Génère une ItemNotFound erreur s’il n’existe pas de contrôle de contenu parent.

readonly parentContentControl: Word.ContentControl;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le contrôle de contenu qui contient le tableau. S’il n’existe pas de contrôle de contenu parent, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

readonly parentContentControlOrNullObject: Word.ContentControl;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le tableau qui contient ce tableau. Génère une ItemNotFound erreur si elle n’est pas contenue dans une table.

readonly parentTable: Word.Table;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient la cellule de tableau qui contient ce tableau. Génère une ItemNotFound erreur si elle n’est pas contenue dans une cellule de tableau.

readonly parentTableCell: Word.TableCell;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient la cellule de tableau qui contient ce tableau. Si elle n’est pas contenue dans une cellule de tableau, cette méthode renvoie un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

readonly parentTableCellOrNullObject: Word.TableCell;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le tableau qui contient ce tableau. Si elle n’est pas contenue dans une table, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

readonly parentTableOrNullObject: Word.Table;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le nombre de lignes dans le tableau.

readonly rowCount: number;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient toutes les lignes du tableau.

readonly rows: Word.TableRowCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets content alignment details about the first row of the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const firstTableRow: Word.TableRow = firstTable.rows.getFirst();
  firstTableRow.load(["horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table's first row:`, `- Horizontal alignment of every cell in the row: ${firstTableRow.horizontalAlignment}`, `- Vertical alignment of every cell in the row: ${firstTableRow.verticalAlignment}`);
});

Renvoie l’objet ShadingUniversal qui représente l’ombrage de la table.

readonly shading: Word.ShadingUniversal;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Spécifie la couleur d’ombrage. La couleur est spécifiée au format « #RRVVBB » ou par son nom de couleur.

shadingColor: string;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie le nom de style de la table. Utilisez cette propriété pour les noms des styles personnalisés et localisés. Pour utiliser les styles prédéfinis qui sont portables entre différents paramètres régionaux, voir la propriété « styleBuiltIn ».

style: string;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie si la table comporte des colonnes à bandes.

styleBandedColumns: boolean;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie si la table comporte des lignes à bandes.

styleBandedRows: boolean;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie le nom de style intégré pour la table. Utilisez cette propriété pour les styles intégrés qui sont portables entre les paramètres régionaux. Pour utiliser des styles personnalisés ou des noms de style localisés, consultez la propriété « style ».

styleBuiltIn: Word.BuiltInStyleName | "Other" | "Normal" | "Heading1" | "Heading2" | "Heading3" | "Heading4" | "Heading5" | "Heading6" | "Heading7" | "Heading8" | "Heading9" | "Toc1" | "Toc2" | "Toc3" | "Toc4" | "Toc5" | "Toc6" | "Toc7" | "Toc8" | "Toc9" | "FootnoteText" | "Header" | "Footer" | "Caption" | "FootnoteReference" | "EndnoteReference" | "EndnoteText" | "Title" | "Subtitle" | "Hyperlink" | "Strong" | "Emphasis" | "NoSpacing" | "ListParagraph" | "Quote" | "IntenseQuote" | "SubtleEmphasis" | "IntenseEmphasis" | "SubtleReference" | "IntenseReference" | "BookTitle" | "Bibliography" | "TocHeading" | "TableGrid" | "PlainTable1" | "PlainTable2" | "PlainTable3" | "PlainTable4" | "PlainTable5" | "TableGridLight" | "GridTable1Light" | "GridTable1Light_Accent1" | "GridTable1Light_Accent2" | "GridTable1Light_Accent3" | "GridTable1Light_Accent4" | "GridTable1Light_Accent5" | "GridTable1Light_Accent6" | "GridTable2" | "GridTable2_Accent1" | "GridTable2_Accent2" | "GridTable2_Accent3" | "GridTable2_Accent4" | "GridTable2_Accent5" | "GridTable2_Accent6" | "GridTable3" | "GridTable3_Accent1" | "GridTable3_Accent2" | "GridTable3_Accent3" | "GridTable3_Accent4" | "GridTable3_Accent5" | "GridTable3_Accent6" | "GridTable4" | "GridTable4_Accent1" | "GridTable4_Accent2" | "GridTable4_Accent3" | "GridTable4_Accent4" | "GridTable4_Accent5" | "GridTable4_Accent6" | "GridTable5Dark" | "GridTable5Dark_Accent1" | "GridTable5Dark_Accent2" | "GridTable5Dark_Accent3" | "GridTable5Dark_Accent4" | "GridTable5Dark_Accent5" | "GridTable5Dark_Accent6" | "GridTable6Colorful" | "GridTable6Colorful_Accent1" | "GridTable6Colorful_Accent2" | "GridTable6Colorful_Accent3" | "GridTable6Colorful_Accent4" | "GridTable6Colorful_Accent5" | "GridTable6Colorful_Accent6" | "GridTable7Colorful" | "GridTable7Colorful_Accent1" | "GridTable7Colorful_Accent2" | "GridTable7Colorful_Accent3" | "GridTable7Colorful_Accent4" | "GridTable7Colorful_Accent5" | "GridTable7Colorful_Accent6" | "ListTable1Light" | "ListTable1Light_Accent1" | "ListTable1Light_Accent2" | "ListTable1Light_Accent3" | "ListTable1Light_Accent4" | "ListTable1Light_Accent5" | "ListTable1Light_Accent6" | "ListTable2" | "ListTable2_Accent1" | "ListTable2_Accent2" | "ListTable2_Accent3" | "ListTable2_Accent4" | "ListTable2_Accent5" | "ListTable2_Accent6" | "ListTable3" | "ListTable3_Accent1" | "ListTable3_Accent2" | "ListTable3_Accent3" | "ListTable3_Accent4" | "ListTable3_Accent5" | "ListTable3_Accent6" | "ListTable4" | "ListTable4_Accent1" | "ListTable4_Accent2" | "ListTable4_Accent3" | "ListTable4_Accent4" | "ListTable4_Accent5" | "ListTable4_Accent6" | "ListTable5Dark" | "ListTable5Dark_Accent1" | "ListTable5Dark_Accent2" | "ListTable5Dark_Accent3" | "ListTable5Dark_Accent4" | "ListTable5Dark_Accent5" | "ListTable5Dark_Accent6" | "ListTable6Colorful" | "ListTable6Colorful_Accent1" | "ListTable6Colorful_Accent2" | "ListTable6Colorful_Accent3" | "ListTable6Colorful_Accent4" | "ListTable6Colorful_Accent5" | "ListTable6Colorful_Accent6" | "ListTable7Colorful" | "ListTable7Colorful_Accent1" | "ListTable7Colorful_Accent2" | "ListTable7Colorful_Accent3" | "ListTable7Colorful_Accent4" | "ListTable7Colorful_Accent5" | "ListTable7Colorful_Accent6";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie si la table a une première colonne avec un style spécial.

styleFirstColumn: boolean;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie si la table a une dernière colonne avec un style spécial.

styleLastColumn: boolean;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie si la table a un total (dernière) ligne avec un style spécial.

styleTotalRow: boolean;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient les tableaux enfants imbriqués au niveau de profondeur suivant.

readonly tables: Word.TableCollection;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie le titre de la table.

title: string;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Spécifie les valeurs de texte dans le tableau, sous la forme d’un tableau JavaScript 2D.

values: string[][];

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Spécifie l’alignement vertical de chaque cellule du tableau. La valeur peut être top, centerou bottom.

verticalAlignment: Word.VerticalAlignment | "Mixed" | "Top" | "Center" | "Bottom";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

Spécifie la largeur du tableau en points.

width: number;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Ajoute des colonnes au début ou à la fin du tableau, en utilisant la première ou la dernière colonne existante en tant que modèle. Applicable aux tableaux uniformes. Si spécifiées, les valeurs de chaîne sont définies sur les lignes nouvellement insérées.

addColumns(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", columnCount: number, values?: string[][]): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Ajoute des lignes au début ou à la fin du tableau, en utilisant la première ou la dernière ligne existante en tant que modèle. Si spécifiées, les valeurs de chaîne sont définies sur les lignes nouvellement insérées.

addRows(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", rowCount: number, values?: string[][]): Word.TableRowCollection;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Applique le style spécifié, mais conserve toute mise en forme directement appliquée par un utilisateur.

applyStyleDirectFormatting(styleName: string): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Détermine la façon dont Microsoft Word redimensionne un tableau lorsque la fonction Ajustement automatique est utilisée.

autoFitBehavior(behavior: Word.AutoFitBehavior): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Détermine la façon dont Microsoft Word redimensionne un tableau lorsque la fonction Ajustement automatique est utilisée.

autoFitBehavior(behavior: "FixedSize" | "Content" | "Window"): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Ajuste automatiquement les colonnes du tableau à la largeur de la fenêtre.

autoFitWindow(): void;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Permet d'appliquer un aspect prédéfini à un tableau.

autoFormat(options?: Word.TableAutoFormatOptions): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Efface le contenu du tableau.

clear(): void;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Convertit un tableau en texte.

convertToText(options?: Word.TableConvertToTextOptions): Word.Range;

Paramètres

Retours

Objet Range qui représente le texte converti.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Supprime le tableau entier.

delete(): void;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Supprime des colonnes spécifiques. Applicable aux tableaux uniformes.

deleteColumns(columnIndex: number, columnCount?: number): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Supprime des lignes spécifiques.

deleteRows(rowIndex: number, rowCount?: number): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Répartit uniformément les largeurs de colonne. Applicable aux tableaux uniformes.

distributeColumns(): void;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le style de la bordure spécifiée.

getBorder(borderLocation: Word.BorderLocation): Word.TableBorder;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets border details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const borderLocation = Word.BorderLocation.top;
  const border: Word.TableBorder = firstTable.getBorder(borderLocation);
  border.load(["type", "color", "width"]);
  await context.sync();

  console.log(`Details about the ${borderLocation} border of the first table:`, `- Color: ${border.color}`, `- Type: ${border.type}`, `- Width: ${border.width} points`);
});

Obtient le style de la bordure spécifiée.

getBorder(borderLocation: "Top" | "Left" | "Bottom" | "Right" | "InsideHorizontal" | "InsideVertical" | "Inside" | "Outside" | "All"): Word.TableBorder;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient la cellule du tableau à une ligne et une colonne spécifiées. Génère une ItemNotFound erreur si la cellule de tableau spécifiée n’existe pas.

getCell(rowIndex: number, cellIndex: number): Word.TableCell;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/table-cell-access.yaml

// Gets the content of the first cell in the first table.
await Word.run(async (context) => {
  const firstCell: Word.Body = context.document.body.tables.getFirst().getCell(0, 0).body;
  firstCell.load("text");

  await context.sync();
  console.log("First cell's text is: " + firstCell.text);
});

Obtient la cellule du tableau à une ligne et une colonne spécifiées. Si la cellule de tableau spécifiée n’existe pas, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

getCellOrNullObject(rowIndex: number, cellIndex: number): Word.TableCell;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient la marge intérieure des cellules en points.

getCellPadding(cellPaddingLocation: Word.CellPaddingLocation): OfficeExtension.ClientResult<number>;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets cell padding details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const cellPaddingLocation = Word.CellPaddingLocation.right;
  const cellPadding = firstTable.getCellPadding(cellPaddingLocation);
  await context.sync();

  console.log(
    `Cell padding details about the ${cellPaddingLocation} border of the first table: ${cellPadding.value} points`
  );
});

Obtient la marge intérieure des cellules en points.

getCellPadding(cellPaddingLocation: "Top" | "Left" | "Bottom" | "Right"): OfficeExtension.ClientResult<number>;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le tableau suivant. Génère une ItemNotFound erreur si cette table est la dernière.

getNext(): Word.Table;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le tableau suivant. Si cette table est la dernière, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

getNextOrNullObject(): Word.Table;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le paragraphe après le tableau. Génère une ItemNotFound erreur s’il n’y a pas de paragraphe après le tableau.

getParagraphAfter(): Word.Paragraph;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le paragraphe après le tableau. S’il n’y a pas de paragraphe après la table, cette méthode renvoie un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

getParagraphAfterOrNullObject(): Word.Paragraph;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le paragraphe avant le tableau. Génère une ItemNotFound erreur s’il n’y a pas de paragraphe avant le tableau.

getParagraphBefore(): Word.Paragraph;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient le paragraphe avant le tableau. S’il n’y a pas de paragraphe avant la table, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

getParagraphBeforeOrNullObject(): Word.Paragraph;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Obtient la plage qui contient ce tableau, ou la plage située au début ou à la fin du tableau.

getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | "Whole" | "Start" | "End" | "After"): Word.Range;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Insère un contrôle de contenu dans le tableau.

insertContentControl(): Word.ContentControl;

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Insère un paragraphe à l’emplacement spécifié.

insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Insère un tableau avec le nombre spécifié de lignes et de colonnes.

insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", values?: string[][]): Word.Table;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

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?: Word.Interfaces.TableLoadOptions): Word.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[]): Word.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;
        }): Word.Table;

Paramètres

Retours

Fusionne les cellules délimitées inclusivement par une première et une dernière cellule.

mergeCells(topRow: number, firstCell: number, bottomRow: number, lastCell: number): Word.TableCell;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.4 ]

Mises à jour le tableau avec les caractéristiques du format de tableau prédéfini définis lors de l’appel de la autoFormat méthode. Le format prédéfini par défaut est TableFormatType.none.

reapplyAutoFormat(): void;

Retours

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Effectue une recherche avec les options de recherche spécifiées sur l’étendue de l’objet Table . Les résultats de la recherche sont une collection d’objets Range .

search(searchText: string, searchOptions?: Word.SearchOptions | {
            ignorePunct?: boolean;
            ignoreSpace?: boolean;
            matchCase?: boolean;
            matchPrefix?: boolean;
            matchSuffix?: boolean;
            matchWholeWord?: boolean;
            matchWildcards?: boolean;
        }): Word.RangeCollection;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Sélectionne le tableau ou la position de début ou de fin du tableau et y accède dans l’interface utilisateur de Word.

select(selectionMode?: Word.SelectionMode): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Sélectionne le tableau ou la position de début ou de fin du tableau et y accède dans l’interface utilisateur de Word.

select(selectionMode?: "Select" | "Start" | "End"): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Définit plusieurs propriétés d’un objet en même temps. Vous pouvez passer un objet brut avec les propriétés appropriées ou un autre objet API du même type.

set(properties: Interfaces.TableUpdateData, options?: OfficeExtension.UpdateOptions): void;

Paramètres

Retours

Définit plusieurs propriétés sur l’objet en même temps, en fonction d’un objet chargé existant.

set(properties: Word.Table): void;

Paramètres

Retours

Définit la marge intérieure des cellules en points.

setCellPadding(cellPaddingLocation: Word.CellPaddingLocation, cellPadding: number): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Définit la marge intérieure des cellules en points.

setCellPadding(cellPaddingLocation: "Top" | "Left" | "Bottom" | "Right", cellPadding: number): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApi 1.3 ]

Trie le contenu du tableau spécifié

sort(options?: Word.TableSortOptions): void;

Paramètres

Retours

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

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

toJSON(): Word.Interfaces.TableData;

Retours

Effectuer le suivi de l’objet pour l’ajustement automatique en fonction environnant des modifications dans le document. Cet appel est un raccourci pour context.trackedObjects.add(thisObject). Si vous utilisez cet objet sur des .sync appels et en dehors de l’exécution séquentielle d’un lot « .run », et que vous obtenez une erreur « InvalidObjectPath » lors de la définition d’une propriété ou de l’appel d’une méthode sur l’objet, vous devez ajouter l’objet à la collection d’objets suivie lors de la première création de l’objet. Si cet objet fait partie d’une collection, vous devez également suivre la collection parente.

track(): Word.Table;

Retours

Publication mémoire associée à cet objet si elle a été précédemment suivie. Cet appel est abrégé pour context.trackedObjects.remove(thisObject). Vous rencontrez de nombreux objets suivies ralentit l’application hôte, donc n’oubliez pas de libérer les objets que l'on ajoute, une fois que vous avez terminé à les utiliser. Vous devez appeler context.sync() avant que la mise en production de la mémoire ne prenne effet.

untrack(): Word.Table;

Retours