Como acrescentar preenchimento às linhas de texto até uma largura definida

Objetivo do preenchimento

Esta ferramenta acrescenta preenchimento às linhas de texto que ficam abaixo de uma largura escolhida. O processamento é feito linha a linha, por isso pode ser útil para preparar listas, cabeçalhos, colunas simples ou blocos com várias linhas. Pode definir a largura de referência, escolher o caráter acrescentado e indicar se esse caráter fica antes, depois ou dos dois lados do conteúdo. As linhas que já têm a largura indicada não são encurtadas nem alteradas.

Procedimento de utilização

1. Introduza o bloco de texto no controlo de entrada. Se o bloco tiver várias linhas, separe-as com o caráter de mudança de linha reconhecido pela ferramenta. Cada linha será tratada individualmente, em vez de o texto inteiro ser medido como uma única sequência.
2. Indique a largura pretendida. Para um valor fornecido e utilizável, a ferramenta converte-o num número inteiro e mantém o resultado entre 1 e 200. Quando a largura fica por indicar, é usado o valor 20. Escolha um número que corresponda ao espaço disponível no destino, lembrando-se de que esta operação acrescenta preenchimento, mas não reduz linhas compridas.
3. Defina o caráter de preenchimento, se preferir outro resultado além de espaços. Um campo vazio usa um espaço; quando introduz vários caracteres, apenas o primeiro caráter desse valor é selecionado. Assim, para utilizar pontos, basta fornecer um valor que comece por um ponto.
4. Selecione a posição do preenchimento. A opção esquerda coloca os caracteres depois do texto, enquanto a opção direita os coloca antes. Qualquer outro valor de alinhamento segue o posicionamento centrado segundo o comportamento revisto.
5. Consulte a saída e compare cada linha com a largura escolhida. Uma linha mais curta recebe cópias suficientes do caráter selecionado para atingir essa largura. Uma linha que já tenha essa largura ou seja mais extensa é devolvida sem encurtamento.
6. Se o objetivo for um bloco visualmente regular, reveja as linhas que ultrapassam a medida indicada. Elas conservarão o comprimento original, pelo que o resultado poderá conter linhas com dimensões diferentes. Se não introduzir texto, a ferramenta devolve uma saída vazia e não aplica preenchimento nem normaliza a largura.

Leitura da saída

Interprete o resultado separando a posição do texto da dimensão da linha. No alinhamento à esquerda, o conteúdo permanece no início e o preenchimento aparece no fim; no alinhamento à direita, o caráter escolhido é colocado antes do conteúdo. No posicionamento centrado, o preenchimento é repartido pelos dois lados da linha curta.

Quando essa repartição não pode ser dividida em partes iguais, o lado esquerdo recebe a porção menor e o lado direito recebe a maior. A divisão original do bloco pelo caráter de mudança de linha é mantida na saída, com as linhas reunidas pelo mesmo separador. A largura indicada serve como referência mínima para as linhas curtas, não como uma largura máxima para todo o resultado.

Por isso, uma saída que contenha uma linha mais longa do que a medida selecionada não indica necessariamente um problema no preenchimento. Essa linha foi preservada, enquanto as linhas menores foram completadas até ao valor efetivo.

Exemplo prático

Uma pessoa quer apresentar duas linhas curtas alinhadas à direita dentro de uma largura de 12 caracteres.

Introduza «Bom dia» numa linha e «Portugal» na seguinte, indique 12, escolha o ponto e selecione o alinhamento à direita. Depois, observe a saída linha a linha.

Com largura 12, alinhamento à direita e ponto como caráter, a saída terá duas linhas de 12 caracteres: a primeira terminará com «Bom dia» depois de cinco pontos e a segunda com «Portugal» depois de quatro pontos.

Limitações

• Um valor de largura não convertível para inteiro pode falhar antes de o processamento terminar. O comportamento revisto cobre o caráter de mudança de linha indicado, mas não estabelece o resultado para retornos de carro ou outros separadores.

Erros comuns

• Uma largura preenchida com um valor que não possa ser convertida num número inteiro pode interromper o processamento antes da conclusão; substitua-a por um valor numérico inteiro dentro do intervalo aceite.

Perguntas frequentes

Posso definir a largura do preenchimento?

Quando o texto tem conteúdo, a largura fornecida é convertida para um inteiro e fica limitada entre 1 e 200; se não indicar esse valor, é usada a largura 20. Com texto vazio, a saída permanece vazia e esta normalização não é aplicada.

Posso escolher outro caráter além do espaço?

Quando fornece um valor de preenchimento não vazio, só o seu primeiro caráter é usado; se deixar essa entrada sem conteúdo, o preenchimento é feito com espaços.

O preenchimento reconhece qualquer tipo de mudança de linha?

A ferramenta divide o texto pelo caráter de mudança de linha reconhecido na descrição do comportamento. O tratamento de retornos de carro e de outras representações de nova linha não está estabelecido.