Table

Table class

Représente un tableau dans un document Word.

Pour en savoir plus, visitez leTravailler avec des tableaux article de documentation.

public class Table : CompositeNode

Constructeurs

Nom	La description
Table(DocumentBase)	Initialise une nouvelle instance du`Table` classe.

Propriétés

Nom	La description
AbsoluteHorizontalDistance { get; set; }	Obtient ou définit la position horizontale absolue du tableau flottant spécifiée par les propriétés du tableau, en points. La valeur par défaut est 0.
AbsoluteVerticalDistance { get; set; }	Obtient ou définit la position verticale absolue du tableau flottant spécifiée par les propriétés du tableau, en points. La valeur par défaut est 0.
Alignment { get; set; }	Spécifie comment un tableau en ligne est aligné dans le document.
AllowAutoFit { get; set; }	Permet à Microsoft Word et Aspose.Words de redimensionner automatiquement les cellules d’un tableau pour les adapter à leur contenu.
AllowCellSpacing { get; set; }	Obtient ou définit l’option « Autoriser l’espacement entre les cellules ».
AllowOverlap { get; }	Détermine si une table flottante doit autoriser d’autres objets flottants dans le document à chevaucher ses étendues lorsqu’ils sont affichés. La valeur par défaut est`vrai` .
Bidi { get; set; }	Obtient ou définit s’il s’agit d’un tableau de droite à gauche.
BottomPadding { get; set; }	Obtient ou définit la quantité d’espace (en points) à ajouter sous le contenu des cellules.
CellSpacing { get; set; }	Obtient ou définit la quantité d’espace (en points) entre les cellules.
Count { get; }	Obtient le nombre d’enfants immédiats de ce nœud.
CustomNodeId { get; set; }	Spécifie l’identifiant de nœud personnalisé.
Description { get; set; }	Obtient ou définit la description de cette table. Il fournit une représentation textuelle alternative des informations contenues dans la table.
DistanceBottom { get; set; }	Obtient ou définit la distance entre le bas du tableau et le texte environnant, en points.
DistanceLeft { get; set; }	Obtient ou définit la distance entre la gauche du tableau et le texte environnant, en points.
DistanceRight { get; set; }	Obtient ou définit la distance entre la droite du tableau et le texte environnant, en points.
DistanceTop { get; set; }	Obtient ou définit la distance entre le dessus de la table et le texte environnant, en points.
virtual Document { get; }	Obtient le document auquel appartient ce nœud.
FirstChild { get; }	Obtient le premier enfant du nœud.
FirstRow { get; }	Renvoie le premier`Row` nœud dans la table.
HasChildNodes { get; }	Retours`vrai` si ce nœud a des nœuds enfants.
HorizontalAnchor { get; set; }	Obtient l’objet de base à partir duquel le positionnement horizontal du tableau flottant doit être calculé. La valeur par défaut estColumn .
override IsComposite { get; }	Retours`vrai` car ce nœud peut avoir des nœuds enfants.
LastChild { get; }	Obtient le dernier enfant du nœud.
LastRow { get; }	Renvoie le dernier`Row` nœud dans la table.
LeftIndent { get; set; }	Obtient ou définit la valeur qui représente le retrait à gauche du tableau.
LeftPadding { get; set; }	Obtient ou définit la quantité d’espace (en points) à ajouter à gauche du contenu des cellules.
NextSibling { get; }	Obtient le nœud suivant immédiatement ce nœud.
override NodeType { get; }	RetoursTable .
ParentNode { get; }	Obtient le parent immédiat de ce nœud.
PreferredWidth { get; set; }	Obtient ou définit la largeur préférée du tableau.
PreviousSibling { get; }	Obtient le nœud précédant immédiatement ce nœud.
Range { get; }	Renvoie un`Range`objet qui représente la partie d’un document contenue dans ce nœud.
RelativeHorizontalAlignment { get; set; }	Obtient ou définit l’alignement horizontal relatif de la table flottante.
RelativeVerticalAlignment { get; set; }	Obtient ou définit l’alignement vertical relatif de la table flottante.
RightPadding { get; set; }	Obtient ou définit la quantité d’espace (en points) à ajouter à droite du contenu des cellules.
Rows { get; }	Fournit un accès typé aux lignes de la table.
Style { get; set; }	Obtient ou définit le style de tableau appliqué à ce tableau.
StyleIdentifier { get; set; }	Obtient ou définit l’identifiant de style indépendant des paramètres régionaux du style de table appliqué à cette table.
StyleName { get; set; }	Obtient ou définit le nom du style de tableau appliqué à ce tableau.
StyleOptions { get; set; }	Obtient ou définit des indicateurs binaires qui spécifient comment un style de tableau est appliqué à ce tableau.
TextWrapping { get; set; }	Obtient ou définit`TextWrapping` pour la table.
Title { get; set; }	Obtient ou définit le titre de ce tableau. Il fournit une représentation textuelle alternative des informations contenues dans le tableau.
TopPadding { get; set; }	Obtient ou définit la quantité d’espace (en points) à ajouter au-dessus du contenu des cellules.
VerticalAnchor { get; set; }	Obtient l’objet de base à partir duquel le positionnement vertical du tableau flottant doit être calculé. La valeur par défaut estMargin .

Méthodes

Nom	La description
override Accept(DocumentVisitor)	Accepte un visiteur.
override AcceptEnd(DocumentVisitor)	Accepte un visiteur pour visiter la fin de la table.
override AcceptStart(DocumentVisitor)	Accepte un visiteur pour visiter le début de la table.
AppendChild<T>(T)	Ajoute le nœud spécifié à la fin de la liste des nœuds enfants pour ce nœud.
AutoFit(AutoFitBehavior)	Redimensionne le tableau et les cellules en fonction du comportement d’ajustement automatique spécifié.
ClearBorders()	Supprime toutes les bordures de tableau et de cellule de ce tableau.
ClearShading()	Supprime tout l’ombrage sur le tableau.
Clone(bool)	Crée un doublon du nœud.
ConvertToHorizontallyMergedCells()	Convertit les cellules fusionnées horizontalement par largeur en cellules fusionnées par`HorizontalMerge` .
CreateNavigator()	Crée un navigateur qui peut être utilisé pour parcourir et lire les nœuds.
EnsureMinimum()	Si la table ne contient aucune ligne, crée et ajoute une ligne`Row` .
GetAncestor(NodeType)	Obtient le premier ancêtre du spécifié`NodeType` .
GetAncestor(Type)	Obtient le premier ancêtre du type d’objet spécifié.
GetChild(NodeType, int, bool)	Renvoie un Nième nœud enfant qui correspond au type spécifié.
GetChildNodes(NodeType, bool)	Renvoie une collection active de nœuds enfants qui correspondent au type spécifié.
GetEnumerator()	Fournit un support pour chaque itération de style sur les nœuds enfants de ce nœud.
override GetText()	Obtient le texte de ce nœud et de tous ses enfants.
IndexOf(Node)	Renvoie l’index du nœud enfant spécifié dans le tableau de nœuds enfants.
InsertAfter<T>(T, Node)	Insère le nœud spécifié immédiatement après le nœud de référence spécifié.
InsertBefore<T>(T, Node)	Insère le nœud spécifié immédiatement avant le nœud de référence spécifié.
NextPreOrder(Node)	Obtient le nœud suivant selon l’algorithme de parcours de l’arbre de pré-ordre.
PrependChild<T>(T)	Ajoute le nœud spécifié au début de la liste des nœuds enfants pour ce nœud.
PreviousPreOrder(Node)	Obtient le nœud précédent selon l’algorithme de parcours de l’arbre de pré-ordre.
Remove()	Se supprime du parent.
RemoveAllChildren()	Supprime tous les nœuds enfants du nœud actuel.
RemoveChild<T>(T)	Supprime le nœud enfant spécifié.
RemoveSmartTags()	Supprime tout`SmartTag` nœuds descendants du nœud actuel.
SelectNodes(string)	Sélectionne une liste de nœuds correspondant à l’expression XPath.
SelectSingleNode(string)	Sélectionne le premier`Node` qui correspond à l’expression XPath.
SetBorder(BorderType, LineStyle, double, Color, bool)	Définit la bordure de tableau spécifiée sur le style de ligne, la largeur et la couleur spécifiés.
SetBorders(LineStyle, double, Color)	Définit toutes les bordures du tableau selon le style de ligne, la largeur et la couleur spécifiés.
SetShading(TextureIndex, Color, Color)	Définit l’ombrage sur les valeurs spécifiées sur l’ensemble du tableau.
ToString(SaveFormat)	Exporte le contenu du nœud dans une chaîne au format spécifié.
ToString(SaveOptions)	Exporte le contenu du nœud dans une chaîne en utilisant les options de sauvegarde spécifiées.

Remarques

Table est un nœud de niveau bloc et peut être un enfant de classes dérivées deStory ou InlineStory.

Table peut contenir un ou plusieursRow nœuds.

Une table minimale valide doit avoir au moins unRow.

Exemples

Montre comment créer un tableau.

Document doc = new Document();
Table table = new Table(doc);
doc.FirstSection.Body.AppendChild(table);

// Les tableaux contiennent des lignes, qui contiennent des cellules, qui peuvent contenir des paragraphes
// avec des éléments typiques tels que des exécutions, des formes et même d'autres tables.
// L'appel de la méthode « EnsureMinimum » sur une table garantira que
// le tableau comporte au moins une ligne, une cellule et un paragraphe.
Row firstRow = new Row(doc);
table.AppendChild(firstRow);

Cell firstCell = new Cell(doc);
firstRow.AppendChild(firstCell);

Paragraph paragraph = new Paragraph(doc);
firstCell.AppendChild(paragraph);

// Ajoutez du texte à la première cellule de la première ligne du tableau.
Run run = new Run(doc, "Hello world!");
paragraph.AppendChild(run);

doc.Save(ArtifactsDir + "Table.CreateTable.docx");

Montre comment parcourir tous les tableaux du document et imprimer le contenu de chaque cellule.

Document doc = new Document(MyDir + "Tables.docx");
TableCollection tables = doc.FirstSection.Body.Tables;

Assert.AreEqual(2, tables.ToArray().Length);

for (int i = 0; i < tables.Count; i++)
{
    Console.WriteLine($"Start of Table {i}");

    RowCollection rows = tables[i].Rows;

    // Nous pouvons utiliser la méthode « ToArray » sur une collection de lignes pour la cloner dans un tableau.
    Assert.AreEqual(rows, rows.ToArray());
    Assert.AreNotSame(rows, rows.ToArray());

    for (int j = 0; j < rows.Count; j++)
    {
        Console.WriteLine($"\tStart of Row {j}");

        CellCollection cells = rows[j].Cells;

        // Nous pouvons utiliser la méthode « ToArray » sur une collection de cellules pour la cloner dans un tableau.
        Assert.AreEqual(cells, cells.ToArray());
        Assert.AreNotSame(cells, cells.ToArray());

        for (int k = 0; k < cells.Count; k++)
        {
            string cellText = cells[k].ToString(SaveFormat.Text).Trim();
            Console.WriteLine($"\t\tContents of Cell:{k} = \"{cellText}\"");
        }

        Console.WriteLine($"\tEnd of Row {j}");
    }

    Console.WriteLine($"End of Table {i}\n");
}

Montre comment créer un tableau formaté 2x2.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.Write("Row 1, cell 1.");
builder.InsertCell();
builder.Write("Row 1, cell 2.");
builder.EndRow();

// Lors de la construction du tableau, le générateur de documents appliquera ses valeurs de propriété RowFormat/CellFormat actuelles
// à la ligne/cellule actuelle dans laquelle se trouve son curseur et à toutes les nouvelles lignes/cellules au fur et à mesure qu'il les crée.
Assert.AreEqual(CellVerticalAlignment.Center, table.Rows[0].Cells[0].CellFormat.VerticalAlignment);
Assert.AreEqual(CellVerticalAlignment.Center, table.Rows[0].Cells[1].CellFormat.VerticalAlignment);

builder.InsertCell();
builder.RowFormat.Height = 100;
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 2, cell 1.");
builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 2, cell 2.");
builder.EndRow();
builder.EndTable();

// Les lignes et cellules ajoutées précédemment ne sont pas affectées rétroactivement par les modifications apportées à la mise en forme du générateur.
Assert.AreEqual(0, table.Rows[0].RowFormat.Height);
Assert.AreEqual(HeightRule.Auto, table.Rows[0].RowFormat.HeightRule);
Assert.AreEqual(100, table.Rows[1].RowFormat.Height);
Assert.AreEqual(HeightRule.Exactly, table.Rows[1].RowFormat.HeightRule);
Assert.AreEqual(TextOrientation.Upward, table.Rows[1].Cells[0].CellFormat.Orientation);
Assert.AreEqual(TextOrientation.Downward, table.Rows[1].Cells[1].CellFormat.Orientation);

doc.Save(ArtifactsDir + "DocumentBuilder.BuildTable.docx");

Montre comment créer un tableau imbriqué sans utiliser de générateur de documents.

public void CreateNestedTable()
{
    Document doc = new Document();

    // Créez le tableau externe avec trois lignes et quatre colonnes, puis ajoutez-le au document.
    Table outerTable = CreateTable(doc, 3, 4, "Outer Table");
    doc.FirstSection.Body.AppendChild(outerTable);

    // Créez un autre tableau avec deux lignes et deux colonnes, puis insérez-le dans la première cellule du premier tableau.
    Table innerTable = CreateTable(doc, 2, 2, "Inner Table");
    outerTable.FirstRow.FirstCell.AppendChild(innerTable);

    doc.Save(ArtifactsDir + "Table.CreateNestedTable.docx");
}

/// <summary>
/// Crée un nouveau tableau dans le document avec les dimensions et le texte donnés dans chaque cellule.
/// </summary>
private static Table CreateTable(Document doc, int rowCount, int cellCount, string cellText)
{
    Table table = new Table(doc);

    for (int rowId = 1; rowId <= rowCount; rowId++)
    {
        Row row = new Row(doc);
        table.AppendChild(row);

        for (int cellId = 1; cellId <= cellCount; cellId++)
        {
            Cell cell = new Cell(doc);
            cell.AppendChild(new Paragraph(doc));
            cell.FirstParagraph.AppendChild(new Run(doc, cellText));

            row.AppendChild(cell);
        }
    }

    // Vous pouvez utiliser les propriétés « Titre » et « Description » pour ajouter respectivement un titre et une description à votre tableau.
    // La table doit avoir au moins une ligne avant que nous puissions utiliser ces propriétés.
    // Ces propriétés sont significatives pour les documents .docx conformes à la norme ISO / IEC 29500 (voir la classe OoxmlCompliance).
    // Si nous enregistrons le document dans des formats antérieurs à ISO/IEC 29500, Microsoft Word ignore ces propriétés.
    table.Title = "Aspose table title";
    table.Description = "Aspose table description";

    return table;
}

Voir également

class CompositeNode
espace de noms Aspose.Words.Tables
Assemblée Aspose.Words

RowFormat Class TableAlignment Enum