Remover paradas de tabulação personalizadas dos níveis de lista oferece controle granular sobre o layout de listas em documentos Word. O recurso Removing List Level Tab Stops adiciona um método simples ListLevel.RemoveTabStop() que limpa qualquer parada de tabulação previamente definida. Este artigo orienta você na instalação do SDK, criação de uma lista, remoção de sua parada de tabulação e salvamento do documento atualizado.

Por que remover paradas de tabulação de nível de lista em um documento Word

As listas de Word frequentemente dependem de uma tabulação padrão que alinha o número ou marcador da lista com o texto. Quando um documento é gerado programaticamente, você pode adicionar uma tabulação personalizada para alcançar um alinhamento visual específico. Mais tarde, os requisitos de negócios podem mudar, ou pode ser necessário reutilizar o mesmo modelo para um layout diferente. Editar o documento manualmente para excluir a tabulação consome tempo e é propenso a erros. Com ListLevel.RemoveTabStop(), você pode reverter programaticamente o nível da lista ao seu comportamento padrão, garantindo consistência nos documentos gerados sem intervenção manual.

Apresentando a API ListLevel

Aspose.Words for .NET fornece um modelo de objeto rico para manipular documentos Word. A classe ListLevel representa um único nível dentro de uma lista (por exemplo, o primeiro nível de uma lista numerada). A partir da versão 26.7, a classe inclui o método RemoveTabStop(), que limpa qualquer tab stop personalizado definido nesse nível.

Para começar, instale o pacote Aspose.Words do NuGet:

Install-Package Aspose.Words

Você pode saber mais sobre o produto na página do produto Aspose.Words for .NET. Documentação detalhada está disponível na documentação Aspose.Words .NET, e a referência completa da API pode ser explorada aqui.

Remover uma Tabulação Personalizada de um Único Nível de Lista

Tutorial passo a passo

  1. Crie um novo Document e DocumentBuilder. O objeto Document mantém o arquivo Word na memória, enquanto DocumentBuilder simplifica a criação de conteúdo.
  2. Aplique um formato de lista numerada padrão. Isso nos fornece uma lista com um nível predefinido e parada de tabulação.
  3. Escreva alguns itens de lista. Os itens herdam a formatação da lista.
  4. Recupere o ListLevel atual do builder. Este é o nível que acabamos de criar.
  5. Chame RemoveTabStop() no ListLevel. Isso limpa a parada de tabulação personalizada.
  6. Salve o documento para verificar a alteração.

O exemplo a seguir demonstra como remover uma parada de tabulação personalizada de um nível de lista usando 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");

Como funciona

  • builder.ListFormat.ApplyNumberDefault() muda o construtor para um contexto de lista numerada usando o estilo de lista padrão definido pelo Word. Isso cria implicitamente um novo objeto List e um ListLevel correspondente para o primeiro nível.
  • builder.Writeln(...) grava dois itens de lista. Como o construtor está no modo de lista, cada chamada adiciona automaticamente o número de lista apropriado e alinha o texto com base na tabulação do nível.
  • builder.ListFormat.ListLevel devolve a instância ListLevel que controla a formatação do nível de lista atual (nível 0 neste caso).
  • listLevel.RemoveTabStop() limpa a tabulação personalizada que foi definida quando o nível da lista foi criado. Após esta chamada, a lista usará a tabulação padrão do Word, normalmente localizada na indentação esquerda do nível.
  • doc.Save(...) grava o documento em memória em um arquivo chamado Paragraph.RemoveTabStopFromListLevel.docx. Abra o arquivo no Microsoft Word ou em qualquer visualizador compatível para ver que os números e o texto agora estão alinhados usando a tabulação padrão.

Nota: Esta amostra de código foi reproduzida a partir das notas de lançamento oficiais do Aspose.Words e não foi executada em um ambiente sandbox. Verifique-a em sua própria configuração de desenvolvimento antes de usá‑la em produção.

Remover Paradas de Tabulação de Todos os Níveis de Lista em um Documento

Em muitos cenários do mundo real, um documento contém várias listas, cada uma com vários níveis. Remover uma tabulação de apenas um nível pode não ser suficiente. O trecho a seguir mostra como percorrer todas as listas em um documento e limpar a tabulação em cada nível.

// 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");

Explicação do código

  • new Document("Input.docx") carrega um arquivo Word existente que pode conter várias listas.
  • doc.Lists retorna uma coleção de objetos List que representam cada lista distinta no documento.
  • list.ListLevels fornece acesso aos nove níveis possíveis (0‑8) para essa lista. Mesmo que um nível não seja usado, a coleção ainda contém uma instância ListLevel com formatação padrão.
  • Dentro do loop interno, level.RemoveTabStop() é chamado em cada nível, garantindo que não restem tabulações personalizadas em nenhum lugar do documento.
  • Por fim, doc.Save("Output_NoTabStops.docx") grava o documento limpo.

Essa abordagem é especialmente útil quando você precisa impor um layout de lista uniforme em um lote de relatórios gerados ou quando está normalizando documentos recebidos de fontes externas.

Adicionando Programaticamente e Em Seguida Removendo uma Parada de Tabulação

Às vezes, pode ser necessário adicionar uma tabulação personalizada para um layout temporário, executar algumas operações e, em seguida, retornar ao padrão. O SDK permite que você adicione uma tabulação com ListLevel.TabStops.Add(double position). Após concluir a formatação temporária, você pode chamar RemoveTabStop() para limpar.

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");

Explicação do código

  • Após criar o documento e aplicar uma lista numerada, escrevemos o primeiro item.
  • level.TabStops.Add(72) insere uma tabulação personalizada em 72 pontos (exatamente uma polegada). O item de lista subsequente alinha seu texto nessa posição.
  • Quando a formatação temporária não for mais necessária, level.RemoveTabStop() remove a tabulação personalizada, fazendo com que os itens seguintes voltem ao alinhamento padrão.
  • O Writeln final demonstra o efeito da remoção.

Esse padrão é útil quando você precisa de um ajuste pontual — por exemplo, para alinhar um título dentro de uma lista para um layout de página específico — enquanto mantém o resto do documento limpo.

Obtenha uma Licença Gratuita

Aspose oferece uma licença temporária gratuita que remove as marcas d’água de avaliação e concede acesso total à API para desenvolvimento e testes. Você pode solicitar uma na página de licença temporária da Aspose.

Recursos Adicionais Gratuitos

Conclusão

Neste tutorial, abordamos como usar o novo método ListLevel.RemoveTabStop() introduzido no Aspose.Words 26.7. Ao limpar as tabulações personalizadas, você recupera o controle sobre o alinhamento de listas, simplifica os modelos de documentos e garante formatação consistente em arquivos Word gerados. Os exemplos mostraram a remoção para um único nível de lista, remoção em massa em todo o documento e um padrão para ajustes temporários de tabulação. Incorporar essas técnicas em suas aplicações .NET tornará sua automação Word mais robusta e mais fácil de manter.

Perguntas Frequentes

  1. O que ListLevel.RemoveTabStop() realmente remove?
    O método limpa qualquer parada de tabulação personalizada que foi definida para o nível da lista, revertendo o nível para usar a parada de tabulação padrão definida pelo estilo do documento.

  2. Preciso chamar Save() após remover uma parada de tabulação?
    Sim. As alterações são feitas na memória, portanto você deve chamar Document.Save() para persistir a formatação de lista atualizada em um arquivo.

  3. Posso remover paradas de tabulação de todos os níveis de lista em um único documento?
    Absolutamente. Você pode iterar por cada List no documento e, em seguida, por cada ListLevel, invocando RemoveTabStop() onde for necessário.

  4. O RemoveTabStop() é suportado para listas com marcadores assim como para listas numeradas?
    Sim. O método funciona em qualquer ListLevel, independentemente de representar um marcador, número ou formato multinível.

  5. Remover uma tabulação personalizada afetará a indentação dos itens de lista existentes?
    Apenas a posição da tabulação personalizada é alterada. A indentação geral definida pela margem esquerda do nível da lista permanece inalterada, portanto os itens da lista mantêm sua hierarquia visual.

  6. Preciso de uma licença paga para usar ListLevel.RemoveTabStop()?
    A API está disponível na licença temporária gratuita, mas para uso em produção você deve obter uma licença completa da Aspose.

Leia Mais