JScrollPane: Desplazamiento

Jerarquía de JScrollPane

1. Raíz Común

java.lang.Object

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Concepto Clave

El JScrollPane es un contenedor especial que “envuelve” a otro componente (como un JTextArea o una JList) para proporcionar barras de desplazamiento automáticas cuando el contenido supera el tamaño visible.

Funcionamiento del “Viewport”

El JScrollPane funciona como una ventana corredera:

1. El Viewport es el área visible.
2. El Componente Cliente es el objeto real que contiene los datos.
3. Las ScrollBars aparecen dinámicamente según sea necesario.

CLICK TO ZOOM

Concepto de Viewport en JScrollPane

1. El Componente Cliente

Representa el contenido total (ej: una imagen gigante o una tabla con miles de filas).

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Visualizando el Viewport

Imagina que tienes una cartulina gigante (el Componente Cliente) y una pequeña ventana recortada en un papel (el Viewport). Al mover el papel sobre la cartulina, solo ves la porción que queda bajo el hueco. Eso es exactamente lo que hace el JScrollPane.

Configuración de Políticas

Puedes controlar cuándo aparecen las barras mediante métodos o en el constructor:

Constante	Comportamiento
VERTICAL_SCROLLBAR_ALWAYS	La barra vertical siempre está visible.
VERTICAL_SCROLLBAR_AS_NEEDED	Solo aparece si el texto sobresale (Por defecto).
HORIZONTAL_SCROLLBAR_NEVER	Nunca muestra la barra horizontal (ideal con lineWrap).

---

Implementación Correcta

Error Común

No añadas el componente y el scroll por separado al marco. Añade el componente al scroll, y luego el scroll al marco.

import javax.swing.*;

public class EjemploScroll extends JFrame {
    public EjemploScroll() {
        JTextArea area = new JTextArea(20, 30);

        // FORMA CORRECTA: Metemos el área dentro del scroll
        JScrollPane scroll = new JScrollPane(area);

        // Configuramos políticas si es necesario
        scroll.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);

        // Añadimos el CONTENEDOR (scroll), no el área directamente
        this.add(scroll);

        this.setSize(400, 300);
        this.setVisible(true);
    }
}

¿Por qué hereda de JComponent?

A diferencia del JScrollPane de AWT, el JScrollPane de Swing es un componente ligero que permite personalización extrema de las barras, el fondo y hasta los botones de las esquinas.