Campos de texto: JTextArea

JTextField es un componente que muestra una sola línea de texto, en cambio JTextArea muestra múltiples líneas de texto. Ambos componentes muestran todo su texto en el mismo formato (fuente, color...), sin embargo, es factible modificar esos dos parámetos y no usar los que Java implementa por defecto.

• Para crear un objeto JTextArea se pueden emplear varios constructores:
  
  JTextArea texto = new JTextArea(); //sin parámetros
  JTextArea texto = new JTextArea(10,40); //número de filas y columnas
  JTextArea texto = new JTextArea( "Texto dentro de JTextArea" ); //cadena de texto
   
• Si se desea que JTextArea implemente barras de deslizamiento (scroll) ha de estar contenida en un objeto JScrollPane cuyo primer parámetro es el objeto contenido y los otros dos parámetos se refieren a las barras de scroll:

  JScrollPane pScroll = new JScrollPane(texto, JScrollPane.VERTICAL_SCROLLBAR_ALWAYS, JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS);
   

• Y este objeto JScrollPane es el que debe ser añadido al panel contenedor, y no la propia JTextArea, de no ser así, las barras de scroll no funcionarán adecadamente:

  p1 = new JPanel(new BorderLayout()); //panel contenedor principal
  ... / ...
  p1.add(pScroll, BorderLayout.CENTER); //el panel principal contiene a JScrollPane y éste a su vez a JTextArea
   

• JTextArea puede ser editada por el usuario o puede ser de sólo lectura, dependiendo de la propiedad setEditable():
  
  texto.setEditable(false); //sólo lectura
   
• En este ejercicio se van añadiendo líneas desde JTextField a JTextArea al pulsar un botón, y otro botón limpia el área de texto.
  Imagen del programa en funcionamiento:
  
  
  
  (Documento para repasar las acciones al pulsar un botón)
   
• El método que añade líneas desde JTextField a JTextArea obtiene en primer lugar la cadena de texto de JTextField, utiliza un entero orden para poner un tope al número de líneas que se pueden escribir en JTextArea y numerar las líneas que se van añadiendo y recurre al método append() de TextArea para añadir nuevas líneas (texto1 es JTextField y texto2 es JTextArea):

  // CLASE QUE AÑADE LÍNEAS DESDE JTEXTFIELD A TEXTAREA
    class ponerTexto implements ActionListener {
     public void actionPerformed(ActionEvent evt) {
       String texto = texto1.getText();
         /* 16 líneas como máximo, mostrando al principio el número de línea
         * mostrar un cero antes del número de línea hasta llegar a 10 */
         if (orden<16) {
           if (orden<9) {
              texto2.append("0" + (orden+1) + " - " + texto + newline); }
           else if (orden>=9)
              { texto2.append((orden+1) + " - " + texto + newline); }
         // posicionarse siempre en la última línea de JTExtArea
         texto2.setCaretPosition(texto2.getDocument().getLength());
         orden++; }
         else { 
           texto1.setFont(new java.awt.Font("Arial", Font.BOLD, 12));
           F2 = new Color(255,0,0);
           texto1.setForeground(F2);
           texto1.setText("No se pueden añadir más de 16 líneas."); }
       }
     }

• El método que limpia de texto JTextArea es muy simple, vacía el área de texto e inicializa a cero la variable orden que cuenta las líneas añadidas a JTextArea:
  

  // CLASE QUE VACÍA TEXTAREA
    class limpiarTexto implements ActionListener {
     public void actionPerformed(ActionEvent evt) {
       texto1.setFont(new java.awt.Font("Arial", Font.PLAIN, 12));
       F3 = new Color(0,0,0);
       texto1.setForeground(F3);
       texto1.setText(texto1Inicio);
       texto2.setText("");
       orden=0;}
     }

• Código completo.