Impostazioni di larghezza preferite

introduzione

Le tabelle rappresentano un modo efficace per organizzare e presentare le informazioni nei documenti di Word. Quando lavori con le tabelle in Aspose.Words per .NET, hai diverse opzioni per impostare la larghezza delle celle della tabella per assicurarti che si adattino perfettamente al layout del tuo documento. Questa guida ti guiderà attraverso il processo di creazione di tabelle con le impostazioni di larghezza preferite utilizzando Aspose.Words per .NET, concentrandosi sulle opzioni di dimensionamento assoluto, relativo e automatico.

Prerequisiti

Prima di immergerti nel tutorial, assicurati di avere quanto segue:

  1. Aspose.Words per .NET: assicurati di avere Aspose.Words per .NET installato nel tuo ambiente di sviluppo. Puoi scaricarloQui.

  2. Ambiente di sviluppo .NET: disporre di un ambiente di sviluppo .NET configurato, come Visual Studio.

  3. Conoscenza di base di C#: la familiarità con la programmazione C# ti aiuterà a comprendere meglio i frammenti di codice e gli esempi.

  4. Documentazione Aspose.Words: fare riferimento aDocumentazione Aspose.Words per informazioni dettagliate sull’API e ulteriori letture.

Importa spazi dei nomi

Prima di iniziare a scrivere codice, devi importare gli spazi dei nomi necessari nel tuo progetto C#:

using Aspose.Words;
using Aspose.Words.Tables;

Questi spazi dei nomi forniscono l’accesso alle funzionalità principali di Aspose.Words e dell’oggetto Table, consentendo di manipolare le tabelle dei documenti.

Analizziamo il processo di creazione di una tabella con diverse impostazioni di larghezza preferite in passaggi chiari e gestibili.

Passaggio 1: inizializzare il documento e DocumentBuilder

Titolo: Creazione di un nuovo documento e DocumentBuilder

Spiegazione: inizia creando un nuovo documento Word e aDocumentBuilder esempio. ILDocumentBuilder La classe fornisce un modo semplice per aggiungere contenuto al tuo documento.

// Definire il percorso per salvare il documento.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// Crea un nuovo documento.
Document doc = new Document();

// Crea un DocumentBuilder per questo documento.
DocumentBuilder builder = new DocumentBuilder(doc);

Qui si specifica la directory in cui verrà salvato il documento e si inizializza il fileDocumentEDocumentBuilder oggetti.

Passaggio 2: inserisci la prima cella della tabella con larghezza assoluta

Inserisci la prima cella nella tabella con una larghezza fissa di 40 punti. Ciò garantirà che questa cella mantenga sempre una larghezza di 40 punti indipendentemente dalla dimensione della tabella.


// Inserisci una cella di dimensioni assolute.
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln("Cell at 40 points width");

In questo passaggio inizierai a creare la tabella e inserirai una cella con larghezza assoluta. ILPreferredWidth.FromPoints(40) Il metodo imposta la larghezza della cella su 40 punti eShading.BackgroundPatternColor applica un colore di sfondo giallo chiaro.

Passaggio 3: inserire una cella di dimensioni relative

Inserisci un’altra cella con una larghezza pari al 20% della larghezza totale della tabella. Questo dimensionamento relativo garantisce che la cella si adatti proporzionalmente alla larghezza della tabella.

// Inserisci una cella di dimensioni relative (percentuale).
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln("Cell at 20% width");

La larghezza di questa cella sarà pari al 20% della larghezza totale della tabella, rendendola adattabile a diverse dimensioni dello schermo o layout di documenti.

Passaggio 4: inserisci una cella con dimensioni automatiche

Infine, inserisci una cella che si dimensiona automaticamente in base allo spazio disponibile rimanente nella tabella.

// Inserisci una cella con dimensioni automatiche.
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln("Cell automatically sized. The size of this cell is calculated from the table preferred width.");
builder.Writeln("In this case the cell will fill up the rest of the available space.");

ILPreferredWidth.Auto l’impostazione consente a questa cella di espandersi o contrarsi in base allo spazio rimasto dopo aver conteggiato le altre celle. Ciò garantisce che la disposizione del tavolo appaia equilibrata e professionale.

Passaggio 5: finalizzare e salvare il documento

Dopo aver inserito tutte le celle, completa la tabella e salva il documento nel percorso specificato.

// Salva il documento.
doc.Save(dataDir + "WorkingWithTables.PreferredWidthSettings.docx");

Questo passaggio finalizza la tabella e salva il documento con il nome file “WorkingWithTables.PreferredWidthSettings.docx” nella directory designata.

Conclusione

Creare tabelle con le impostazioni di larghezza preferite in Aspose.Words per .NET è semplice una volta comprese le diverse opzioni di dimensionamento disponibili. Sia che tu abbia bisogno di larghezze di cella fisse, relative o automatiche, Aspose.Words offre la flessibilità per gestire in modo efficiente vari scenari di layout della tabella. Seguendo i passaggi descritti in questa guida, puoi assicurarti che le tue tabelle siano ben strutturate e visivamente accattivanti nei tuoi documenti Word.

Domande frequenti

Qual è la differenza tra la larghezza assoluta e quella relativa delle celle?

Le larghezze assolute delle celle sono fisse e non cambiano, mentre le larghezze relative si adattano in base alla larghezza totale della tabella.

Posso utilizzare percentuali negative per le larghezze relative?

No, le percentuali negative non sono valide per la larghezza delle celle. Sono ammesse solo percentuali positive.

Come funziona la funzione di dimensionamento automatico?

Il ridimensionamento automatico regola la larghezza della cella per riempire lo spazio rimanente nella tabella dopo che le altre celle sono state ridimensionate.

Posso applicare stili diversi a celle con impostazioni di larghezza diverse?

Sì, puoi applicare vari stili e formattazioni alle celle indipendentemente dalle impostazioni di larghezza.

Cosa succede se la larghezza totale della tabella è inferiore alla somma delle larghezze di tutte le celle?

La tabella regolerà automaticamente la larghezza delle celle per adattarle allo spazio disponibile, il che potrebbe causare la riduzione di alcune celle.