Lavorare con colonne e righe

Per un maggiore controllo sul funzionamento delle tabelle, scopri come manipolare colonne e righe.

Trova l’indice dell’elemento tabella

Le colonne, le righe e le celle vengono gestite accedendo al nodo del documento selezionato dal relativo indice. Trovare l’indice di qualsiasi nodo comporta la raccolta di tutti i nodi figlio del tipo di elemento dal nodo padre e quindi utilizzare il metodo IndexOf per trovare l’indice del nodo desiderato nella raccolta.

Trovare l’indice di una tabella in un documento

A volte potrebbe essere necessario apportare modifiche a una tabella particolare in un documento. Per fare ciò, puoi fare riferimento a una tabella in base al suo indice.

L’esempio di codice seguente mostra come recuperare l’indice di una tabella in un documento:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Table table = (Table) doc.getChild(NodeType.TABLE, 0, true);

NodeCollection allTables = doc.getChildNodes(NodeType.TABLE, true);
int tableIndex = allTables.indexOf(table);

Trovare l’indice di una riga in una tabella

Allo stesso modo, potrebbe essere necessario apportare modifiche a una riga specifica in una tabella selezionata. Per fare ciò, puoi anche fare riferimento a una riga dal suo indice.

L’esempio di codice seguente mostra come recuperare l’indice di una riga in una tabella:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
int rowIndex = table.indexOf(table.getLastRow());

Trovare l’indice di una cella in una riga

Infine, potrebbe essere necessario apportare modifiche a una cella specifica, e puoi farlo anche per indice di cella.

L’esempio di codice seguente mostra come recuperare l’indice di una cella in una riga:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
int cellIndex = row.indexOf(row.getCells().get(4));

Lavorare con le colonne

Nel modello a oggetti del documentoAspose.Words (DOM), il nodo Table è costituito da nodi Row e quindi nodi Cell. Pertanto, nel modello a oggetti Document di Aspose.Words, come nei documenti Word, non esiste il concetto di colonna.

In base alla progettazione, le righe della tabella in Microsoft Word e Aspose.Words sono completamente indipendenti e le proprietà e le operazioni di base sono contenute solo nelle righe e nelle celle della tabella. Questo dà alle tabelle la possibilità di avere alcuni attributi interessanti:

• Ogni riga della tabella può avere un numero completamente diverso di celle
• Verticalmente, le celle di ogni riga possono avere larghezze diverse
• È possibile unire tabelle con diversi formati di riga e numero di celle

Tutte le operazioni eseguite sulle colonne sono in realtà “scorciatoie” che eseguono l’operazione modificando collettivamente le celle di riga in modo tale che sembra che vengano applicate alle colonne. Cioè, è possibile eseguire operazioni su colonne semplicemente iterando sullo stesso indice di cella di riga della tabella.

Il seguente esempio di codice semplifica tali operazioni dimostrando una classe facade che raccoglie le celle che costituiscono una “colonna” di una tabella:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
/// <summary>
/// Represents a facade object for a column of a table in a Microsoft Word document.
/// </summary>
static class Column
{
    private Column(Table table, int columnIndex) {
        if (table != null) {
            mTable = table;
        } else {
            throw new IllegalArgumentException("table");
        }

        mColumnIndex = columnIndex;
    }

    /// <summary>
    /// Returns a new column facade from the table and supplied zero-based index.
    /// </summary>
    public static Column fromIndex(Table table, int columnIndex)
    {
        return new Column(table, columnIndex);
    }

    private ArrayList<Cell> getCells() {
        return getColumnCells();
    }

    /// <summary>
    /// Returns the index of the given cell in the column.
    /// </summary>
    public int indexOf(Cell cell)
    {
        return getColumnCells().indexOf(cell);
    }

    /// <summary>
    /// Inserts a brand new column before this column into the table.
    /// </summary>
    public Column insertColumnBefore()
    {
        ArrayList<Cell> columnCells = getCells();

        if (columnCells.size() == 0)
            throw new IllegalArgumentException("Column must not be empty");

        // Create a clone of this column.
        for (Cell cell : columnCells)
            cell.getParentRow().insertBefore(cell.deepClone(false), cell);

        // This is the new column.
        Column column = new Column(columnCells.get(0).getParentRow().getParentTable(), mColumnIndex);

        // We want to make sure that the cells are all valid to work with (have at least one paragraph).
        for (Cell cell : column.getCells())
            cell.ensureMinimum();

        // Increase the index which this column represents since there is now one extra column in front.
        mColumnIndex++;

        return column;
    }

    /// <summary>
    /// Removes the column from the table.
    /// </summary>
    public void remove()
    {
        for (Cell cell : getCells())
            cell.remove();
    }

    /// <summary>
    /// Returns the text of the column. 
    /// </summary>
    public String toTxt() throws Exception
    {
        StringBuilder builder = new StringBuilder();

        for (Cell cell : getCells())
            builder.append(cell.toString(SaveFormat.TEXT));

        return builder.toString();
    }

    /// <summary>
    /// Provides an up-to-date collection of cells which make up the column represented by this facade.
    /// </summary>
    private ArrayList<Cell> getColumnCells()
    {
        ArrayList<Cell> columnCells = new ArrayList<Cell>();

        for (Row row : mTable.getRows())
        {
            Cell cell = row.getCells().get(mColumnIndex);
            if (cell != null)
                columnCells.add(cell);
        }

        return columnCells;
    }

    private int mColumnIndex;
    private Table mTable;
}

L’esempio di codice seguente mostra come inserire una colonna vuota in una tabella:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Tables.docx");

Table table = (Table) doc.getChild(NodeType.TABLE, 0, true);

Column column = Column.fromIndex(table, 0);
// Print the plain text of the column to the screen.
System.out.println(column.toTxt());
        
// Create a new column to the left of this column.
// This is the same as using the "Insert Column Before" command in Microsoft Word.
Column newColumn = column.insertColumnBefore();

for (Cell cell : newColumn.getColumnCells())
    cell.getFirstParagraph().appendChild(new Run(doc, "Column Text " + newColumn.indexOf(cell)));

L’esempio di codice seguente mostra come rimuovere una colonna da una tabella in un documento:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Tables.docx");

Table table = (Table) doc.getChild(NodeType.TABLE, 1, true);

Column column = Column.fromIndex(table, 2);
column.remove();

Specificare le righe come righe di intestazione

È possibile scegliere di ripetere la prima riga della tabella come riga di intestazione solo nella prima pagina o in ogni pagina se la tabella è divisa in più. In Aspose.Words, è possibile ripetere la riga di intestazione su ogni pagina utilizzando la proprietà HeadingFormat.

È inoltre possibile contrassegnare più righe di intestazione se tali righe si trovano una dopo l’altra all’inizio della tabella. Per fare ciò, è necessario applicare le proprietà HeadingFormat a queste righe.

Si noti che le righe di intestazione non funzionano nelle tabelle nidificate. Cioè, se hai una tabella all’interno di un’altra tabella, questa impostazione non avrà alcun effetto. È una limitazione di Microsoft Word che non consente questo, non Aspose.Words.

L’esempio di codice seguente mostra come creare una tabella che include righe di intestazione che si ripetono nelle pagine successive:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.startTable();
builder.getRowFormat().setHeadingFormat(true);
builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
builder.getCellFormat().setWidth(100.0);
builder.insertCell();
builder.writeln("Heading row 1");
builder.endRow();
builder.insertCell();
builder.writeln("Heading row 2");
builder.endRow();

builder.getCellFormat().setWidth(50.0);
builder.getParagraphFormat().clearFormatting();

for (int i = 0; i < 50; i++)
{
    builder.insertCell();
    builder.getRowFormat().setHeadingFormat(false);
    builder.write("Column 1 Text");
    builder.insertCell();
    builder.write("Column 2 Text");
    builder.endRow();
}

doc.save(getArtifactsDir() + "WorkingWithTables.RepeatRowsOnSubsequentPages.docx");

Impedisci a tabelle e righe di suddividere le pagine

Ci sono momenti in cui il contenuto di una tabella non deve essere diviso tra le pagine. Ad esempio, se un titolo è sopra una tabella, il titolo e la tabella dovrebbero sempre essere tenuti insieme sulla stessa pagina per preservare l’aspetto corretto.

Ci sono due tecniche separate che sono utili per raggiungere questa funzionalità:

• Allow row break across pages, che viene applicato alle righe della tabella
• Keep with next, che viene applicato ai paragrafi nelle celle della tabella

Per impostazione predefinita, le proprietà di cui sopra sono disabilitate.

Evitare che una riga si rompa tra le pagine

Ciò comporta la limitazione del contenuto all’interno delle celle di una riga da dividere in una pagina. In Microsoft Word, questo può essere trovato sotto le proprietà della tabella come l’opzione “Consenti alla riga di suddividere le pagine”. In Aspose.Words questo si trova sotto l’oggetto RowFormat di un Row come proprietà RowFormat.AllowBreakAcrossPages.

L’esempio di codice seguente mostra come disabilitare l’interruzione delle righe tra le pagine per ogni riga di una tabella:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Table spanning two pages.docx");

Table table = (Table) doc.getChild(NodeType.TABLE, 0, true);

// Disable breaking across pages for all rows in the table.
for (Row row : (Iterable<Row>) table.getRows())
    row.getRowFormat().setAllowBreakAcrossPages(false);

doc.save(getArtifactsDir() + "WorkingWithTables.RowFormatDisableBreakAcrossPages.docx");

Impedire a una tabella di attraversare le pagine

Per impedire che la tabella si divida tra le pagine, è necessario specificare che vogliamo che il contenuto contenuto all’interno della tabella rimanga insieme.

A tale scopo, Aspose.Words utilizza un metodo che consente agli utenti di selezionare una tabella e abilitare il parametro KeepWithNext su true per ogni paragrafo all’interno delle celle della tabella. L’eccezione è l’ultimo paragrafo della tabella, che dovrebbe essere impostato su false.

Il seguente esempio di codice mostra come impostare una tabella per stare insieme sulla stessa pagina:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Table spanning two pages.docx");
        
Table table = (Table) doc.getChild(NodeType.TABLE, 0, true);

// We need to enable KeepWithNext for every paragraph in the table to keep it from breaking across a page,
// except for the last paragraphs in the last row of the table.
for (Cell cell : (Iterable<Cell>) table.getChildNodes(NodeType.CELL, true))
{
    cell.ensureMinimum();

    for (Paragraph para : (Iterable<Paragraph>) cell.getParagraphs())
        if (!(cell.getParentRow().isLastRow() && para.isEndOfCell()))
            para.getParagraphFormat().setKeepWithNext(true);
}

doc.save(getArtifactsDir() + "WorkingWithTables.KeepTableTogether.docx");