Rimuovere le tabulazioni personalizzate dai livelli di elenco ti offre un controllo fine sulla disposizione degli elenchi nei documenti Word. La funzionalità Removing List Level Tab Stops aggiunge un semplice metodo ListLevel.RemoveTabStop() che cancella qualsiasi tabulazione precedentemente impostata. Questo articolo ti guida attraverso l’installazione dell’SDK, la creazione di un elenco, la rimozione della sua tabulazione e il salvataggio del documento aggiornato.

Perché rimuovere le tabulazioni a livello di elenco in un documento Word

Le liste di Word si basano spesso su una tabulazione predefinita che allinea il numero o il pallino dell’elenco con il testo. Quando un documento viene generato programmaticamente, potresti aggiungere una tabulazione personalizzata per ottenere un allineamento visivo specifico. Successivamente, i requisiti aziendali possono cambiare o potresti dover riutilizzare lo stesso modello per un layout diverso. Modificare manualmente il documento per eliminare la tabulazione è dispendioso in termini di tempo e soggetto a errori. Con ListLevel.RemoveTabStop(), è possibile ripristinare programmaticamente il livello dell’elenco al suo comportamento predefinito, garantendo coerenza nei documenti generati senza intervento manuale.

Introduzione all’API ListLevel

Aspose.Words for .NET fornisce un ricco modello di oggetti per manipolare documenti Word. La classe ListLevel rappresenta un singolo livello all’interno di un elenco (ad esempio, il primo livello di un elenco numerato). A partire dalla versione 26.7, la classe include il metodo RemoveTabStop(), che elimina qualsiasi tabulazione personalizzata impostata su quel livello.

Per iniziare, installa il pacchetto Aspose.Words da NuGet:

Install-Package Aspose.Words

Puoi saperne di più sul prodotto nella pagina del prodotto Aspose.Words for .NET. La documentazione dettagliata è disponibile nella documentazione Aspose.Words .NET, e la reference completa dell’API può essere consultata qui.

Rimuovere una tabulazione personalizzata da un singolo livello di elenco

Tutorial passo‑a‑passo

  1. Crea un nuovo Document e DocumentBuilder. L’oggetto Document contiene il file Word in memoria, mentre DocumentBuilder semplifica la creazione del contenuto.
  2. Applica un formato di elenco numerato predefinito. Questo ci fornisce un elenco con un livello predefinito e un tabulatore.
  3. Scrivi un paio di voci di elenco. Le voci ereditano la formattazione dell’elenco.
  4. Recupera il ListLevel corrente dal builder. Questo è il livello che abbiamo appena creato.
  5. Chiama RemoveTabStop() sul ListLevel. Questo elimina il tabulatore personalizzato.
  6. Salva il documento per verificare la modifica.

Il seguente esempio dimostra come rimuovere una tabulazione personalizzata da un livello di elenco utilizzando C# e Aspose.Words.

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

// Create a list with default formatting
builder.ListFormat.ApplyNumberDefault();
builder.Writeln("Numbered list item 1");
builder.Writeln("Numbered list item 2");

// Get the list level and remove its tab stop
ListLevel listLevel = builder.ListFormat.ListLevel;
listLevel.RemoveTabStop();

doc.Save("Paragraph.RemoveTabStopFromListLevel.docx");

Come funziona

  • builder.ListFormat.ApplyNumberDefault() passa il builder in un contesto di elenco numerato usando lo stile di elenco predefinito definito da Word. Questo crea implicitamente un nuovo oggetto List e un corrispondente ListLevel per il primo livello.
  • builder.Writeln(...) scrive due voci di elenco. Poiché il builder è in modalità elenco, ogni chiamata aggiunge automaticamente il numero di elenco appropriato e allinea il testo in base al tab stop del livello.
  • builder.ListFormat.ListLevel restituisce l’istanza ListLevel che controlla la formattazione per il livello di elenco corrente (livello 0 in questo caso).
  • listLevel.RemoveTabStop() cancella il tab stop personalizzato che era stato impostato quando il livello di elenco è stato creato. Dopo questa chiamata, l’elenco utilizzerà il tab stop predefinito di Word, tipicamente situato all’indentazione sinistra del livello.
  • doc.Save(...) scrive il documento in memoria in un file chiamato Paragraph.RemoveTabStopFromListLevel.docx. Apri il file in Microsoft Word o in qualsiasi visualizzatore compatibile per vedere che i numeri e il testo sono ora allineati usando il tab stop predefinito.

Note: Questo esempio di codice è riprodotto dalle note di rilascio ufficiali di Aspose.Words e non è stato eseguito in un ambiente sandbox. Verificalo nel tuo ambiente di sviluppo prima di usarlo in produzione.

Rimuovere le fermate di tabulazione da tutti i livelli di elenco in un documento

In molti scenari reali un documento contiene più elenchi, ciascuno con diversi livelli. Rimuovere una tabulazione da un solo livello potrebbe non essere sufficiente. Il frammento seguente mostra come iterare attraverso ogni elenco in un documento e cancellare la tabulazione su ciascun livello.

// Load an existing document that contains multiple lists
Document doc = new Document("Input.docx");

// Iterate through every list in the document
foreach (List list in doc.Lists)
{
    // Each list can have multiple levels (0‑8). Iterate them.
    foreach (ListLevel level in list.ListLevels)
    {
        // Remove any custom tab stop for this level
        level.RemoveTabStop();
    }
}

// Save the updated document
doc.Save("Output_NoTabStops.docx");

Spiegazione del codice

  • new Document("Input.docx") carica un file Word esistente che può contenere diverse liste.
  • doc.Lists restituisce una raccolta di oggetti List che rappresentano ciascuna lista distinta nel documento.
  • list.ListLevels fornisce l’accesso ai nove possibili livelli (0‑8) per quella lista. Anche se un livello non è utilizzato, la raccolta contiene comunque un’istanza ListLevel con formattazione predefinita.
  • All’interno del ciclo interno, level.RemoveTabStop() viene chiamato su ogni livello, garantendo che non rimangano tabulazioni personalizzate in alcuna parte del documento.
  • Infine, doc.Save("Output_NoTabStops.docx") scrive il documento pulito.

Questo approccio è particolarmente utile quando è necessario imporre un layout di elenco uniforme su un batch di report generati o quando si normalizzano documenti ricevuti da fonti esterne.

Aggiunta programmatica e successiva rimozione di una tabulazione

A volte potresti aver bisogno di aggiungere una tabulazione personalizzata per un layout temporaneo, eseguire alcune operazioni e poi tornare al valore predefinito. L’SDK consente di aggiungere una tabulazione con ListLevel.TabStops.Add(double position). Dopo aver completato la formattazione temporanea, puoi chiamare RemoveTabStop() per pulire.

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

builder.ListFormat.ApplyNumberDefault();
builder.Writeln("Temporarily aligned item 1");

// Add a custom tab stop at 72 points (1 inch)
ListLevel level = builder.ListFormat.ListLevel;
level.TabStops.Add(72);

builder.Writeln("Item with custom tab stop");

// Later, remove the custom tab stop
level.RemoveTabStop();

builder.Writeln("Item after removing tab stop");

doc.Save("TempTabStopDemo.docx");

Spiegazione del codice

  • Dopo aver creato il documento e applicato un elenco numerato, scriviamo il primo elemento.
  • level.TabStops.Add(72) inserisce una tabulazione personalizzata a 72 punti (esattamente un pollice). L’elemento successivo dell’elenco allinea il suo testo a quella posizione.
  • Dopo che la formattazione temporanea non è più necessaria, level.RemoveTabStop() rimuove la tabulazione personalizzata, facendo sì che gli elementi successivi tornino all’allineamento predefinito.
  • L’ultimo Writeln dimostra l’effetto della rimozione.

Questo modello è comodo quando è necessario un aggiustamento una tantum — ad esempio, per allineare un’intestazione all’interno di un elenco per un layout di pagina specifico — mantenendo il resto del documento pulito.

Ottieni una licenza gratuita

Aspose offre una licenza temporanea gratuita che rimuove le filigrane di valutazione e concede l’accesso completo all’API per sviluppo e test. È possibile richiederne una dalla pagina della licenza temporanea di Aspose.

Risorse aggiuntive gratuite

Conclusione

In questo tutorial abbiamo coperto come utilizzare il nuovo metodo ListLevel.RemoveTabStop() introdotto in Aspose.Words 26.7. Eliminando le tabulazioni personalizzate si riacquista il controllo sull’allineamento delle liste, si semplificano i modelli di documento e si garantisce una formattazione coerente nei file Word generati. Gli esempi hanno mostrato la rimozione per un singolo livello di elenco, la rimozione in blocco su un intero documento e un modello per regolazioni temporanee delle tabulazioni. Incorporare queste tecniche nelle vostre applicazioni .NET renderà l’automazione di Word più robusta e più facile da mantenere.

FAQs

  1. Cosa rimuove effettivamente ListLevel.RemoveTabStop()?
    Il metodo cancella qualsiasi tabulatore personalizzato che è stato definito per il livello dell’elenco, riportando il livello all’uso del tabulatore predefinito definito dallo stile del documento.

  2. Devo chiamare Save() dopo aver rimosso una tabulazione?
    Sì. Le modifiche vengono apportate in memoria, quindi è necessario chiamare Document.Save() per salvare la formattazione dell’elenco aggiornata su un file.

  3. Posso rimuovere le tabulazioni da tutti i livelli di elenco in un unico documento?
    Assolutamente. È possibile iterare su ogni List nel documento e poi su ogni ListLevel, invocando RemoveTabStop() dove necessario.

  4. RemoveTabStop() è supportato per le liste puntate così come per le liste numerate?
    Sì. Il metodo funziona su qualsiasi ListLevel indipendentemente dal fatto che rappresenti un elenco puntato, un numero o un formato multilevel.

  5. La rimozione di una tabulazione personalizzata influirà sull’indentazione degli elementi di elenco esistenti?
    Solo la posizione della tabulazione cambia. L’indentazione complessiva definita dall’indentazione sinistra del livello di elenco rimane invariata, quindi gli elementi dell’elenco mantengono la loro gerarchia visiva.

  6. Ho bisogno di una licenza a pagamento per utilizzare ListLevel.RemoveTabStop()?
    L’API è disponibile nella licenza temporanea gratuita, ma per l’uso in produzione dovresti ottenere una licenza completa da Aspose.

Leggi di più