O Componente Área de Texto (JTextArea)

As Propriedades do Componente Área de Texto

Algumas propriedades que podemos alterar para melhorar o desempenho desse componente são as seguintes:

• columns – essa propriedade especifica o número de colunas da caixa de texto. O valor padrão é 20, mas você poderá alterar esse valor para outro qualquer, desde que a largura do componente não ultrapasse os limites do seu formulário comprometendo o layout.
• editable – se esse checkbox estiver marcado, significa que o componente poderá ser preenchido e editado, caso contrário, ficará desabilitado para inclusão e edição de texto. Por padrão, esse checkbox já é marcado.
• lineWrap – se esse checkbox estiver marcado, significa que as linhas serão quebradas automaticamente quando o texto atingir a margem direita da caixa de texto, caso contrário, será considerado como uma única linha. O valor padrão é false, ou seja, desmarcado.
• rows – essa propriedade especifica o número de linhas visíveis da caixa de texto. O valor padrão é 5, mas você poderá alterar esse valor para outro qualquer, desde que a altura do componente não ultrapasse os limites do seu formulário, comprometendo o layout.
• tabSize – essa propriedade especifica a quantidade de caracteres em branco quando um novo parágrafo é criado usando-se a tecla TAB. O valor padrão é 8, mas você poderá alterar esse valor para outro qualquer.
• text – essa propriedade é utilizada para você especificar um texto padrão para o componente quando a aplicação for executada, ao invés de ficar em branco. Por exemplo, você poderia informar ao usuário que nessa caixa de texto ele deverá inserir um resumo do seu currículo, adicionando, nessa propriedade, a mensagem: “Informe aqui um resumo do seu currículo.” Você poderá utilizar essa propriedade também para inserir um texto antes da execução da aplicação, ou até mesmo alterar o conteúdo do componente durante a execução através de código.

  Na seção Outras propriedades, você poderá também configurar a propriedade:

• enabled – se esse checkbox estiver marcado, significa que o componente ficará habilitado para inclusão e edição de texto, dependendo da configuração da propriedade editable. Caso contrário, ficará desabilitado e não será permitida a inclusão de texto nem a edição. Essa propriedade anula por completo a propriedade editable. Por padrão, esse checkbox já é marcado.
• opaque – essa propriedade determina a opacidade do componente, ou seja, se esse checkbox estiver marcado, a cor de fundo do componente será opaco, cuja cor padrão é branco, caso contrário, o fundo do componente ficará transparente.

Vejamos agora uma aplicação onde você poderá inserir um texto antes de executá-la:

1. Crie um novo projeto (Arquivo -> Novo projeto).
2. Salve seu projeto com o nome (sugestão): ComponenteAreaDeTexto, em uma pasta de sua escolha.
3. Clique com o botão direito na aplicação e crie um novo Formulário JFrame com o nome de: AreaDeTexto.
4. A partir da paleta de componentes, na seção Controles Swing, clique e arraste um componente Área de texto para a área do projeto.
5. Com o componente já selecionado, marque a propriedade lineWrap para que o texto seja quebrado quando atingir a margem direita.

   Clique no pequeno botão à direita da propriedade text. Será mostrada a seguinte janela:

   
6. Na área em branco, digite um texto qualquer ou copie de alguma fonte externa. Em seguida, clique em OK para concluir.
7. De volta ao projeto, execute a aplicação (F6) e confira o resultado com o apresentado na Figura 5 a seguir:

Mesmo que o texto tenha sido inserido antecipadamente, isso não impede de você alterá-lo ou apagá-lo, desde que a propriedade editable esteja habilitada.