Como quebrar um texto numa largura escolhida

Para que serve

Este utilitário reorganiza texto para caber numa largura de linha definida. É útil quando precisa de preparar texto para uma área estreita, uniformizar a apresentação de um bloco ou verificar como uma frase se distribui por várias linhas. Pode fornecer o texto, escolher a largura, acrescentar uma indentação e decidir se as palavras longas podem ser divididas. A quebra em hífen está disponível durante o processamento.

A largura não representa necessariamente o número introduzido sem alterações. Para texto não vazio, uma largura omitida ou sem valor usa 80 como referência. Quando fornece uma largura com valor, esta é convertida num número inteiro e limitada ao intervalo de 10 a 500. Assim, o resultado depende tanto do texto como da largura efetiva depois desse tratamento.

Como configurar e processar o texto

Introduza o texto. Cole ou escreva o conteúdo que pretende reorganizar. O processamento aceita texto opcional, por isso também pode testar o comportamento com o campo vazio.
Defina a largura. Indique a largura que pretende usar. Para texto não vazio, se deixar este valor sem preenchimento ou fornecer um valor sem efeito, será usada a largura efetiva predefinida de 80. Um valor fornecido com efeito é convertido num número inteiro e fica restringido a um mínimo de 10 e a um máximo de 500.
Configure a indentação, se necessário. Se quiser afastar o bloco da margem, introduza uma indentação. Esta é aplicada no início da primeira linha e também no início das linhas seguintes criadas pela quebra.
Escolha o tratamento de palavras longas. A divisão de palavras longas está ativada por predefinição e pode ser controlada. Mantenha-a ativa quando uma palavra comprida tiver de caber numa largura reduzida; desative-a quando preferir evitar essa divisão. As quebras em hífen são permitidas pelo processamento.
Execute a operação e leia o texto devolvido. Um texto que ultrapasse a largura efetiva pode passar para várias linhas. Um texto suficientemente curto pode permanecer numa só linha. Se o texto estiver vazio, a operação termina com sucesso e devolve texto vazio antes de tratar a largura.

Como interpretar o resultado

Observe primeiro o número de linhas e a posição das quebras. Várias linhas indicam que o conteúdo excedeu a largura efetiva em algum ponto; uma só linha pode ser o resultado esperado para texto curto. A indentação deve aparecer no início da primeira linha e repetir-se no início das linhas seguintes, quando estas existirem.

Tenha em conta que a largura apresentada como entrada pode não ser a largura usada no resultado: para texto não vazio, valores fora do intervalo permitido são ajustados e valores sem efeito conduzem à referência de 80. O caso do texto vazio é diferente: a operação devolve texto vazio sem fazer esse tratamento da largura, pelo que o valor devolvido associado à largura pode conservar o valor fornecido.

Se a divisão de palavras longas estiver ativa, uma palavra extensa pode ser repartida para respeitar melhor a largura. Se estiver desativada, a disposição dessa palavra pode não seguir a mesma forma. O comportamento observado deve, por isso, ser lido em conjunto com as opções escolhidas, e não apenas com o texto original.

Exemplo prático

Para preparar uma frase comprida para uma coluna estreita, introduza “A documentação contém uma palavraextraordinariamentecomprida.”, escolha uma largura reduzida e aplique uma indentação de dois espaços.

Introduza a frase indicada, escolha uma largura reduzida, acrescente uma indentação de dois espaços e mantenha ativa a divisão de palavras longas. Depois, execute a operação.

O resultado tem várias linhas de texto reorganizado; a indentação surge no início das linhas e a palavra longa pode ser dividida porque essa opção está ativa.

Limitações

O tratamento da largura varia consoante o texto esteja vazio ou não: com texto vazio, a operação termina antes da conversão e do ajuste da largura.

Erros comuns

Usar uma largura fora do intervalo sem considerar o ajuste: para texto não vazio, a largura fornecida é convertida num inteiro e limitada entre 10 e 500. Verifique a largura efetiva esperada em vez de assumir que o valor introduzido será aplicado literalmente.

Perguntas frequentes

Qual é a largura usada quando não indico um valor?

Para texto não vazio, uma largura omitida ou sem valor usa 80. Uma largura fornecida com valor é convertida num inteiro e limitada entre 10 e 500.

Posso aplicar indentação ao texto?

Sim. A indentação é aplicada no início da primeira linha e no início das linhas seguintes criadas pela quebra.

O que acontece se deixar o texto vazio?

Quando o texto está vazio, a operação termina com sucesso e devolve texto vazio antes do tratamento da largura. Nesse caso, o valor associado à largura pode manter o valor fornecido.