Swing y JFC (Java Foundation Classes)

Con la clase JLabel, se puede mostrar texto no seleccionable e im�genes. Si necesitamos crear un componente que muestre un sencillo texto o una imagen, reaccionando opcionalmente a la entrada del usuario, podemos hacerlo utilizando un ejemplar de JLabel o de una subclase personalizada de JLabel. Si el componente interactivo tiene estado, pobablemente deber�amos utilizar un button en vez de una etiqueta.

Aqu� podemos ver una imagen de una aplicaci�n que muestra tres etiquetas. La ventana est� dividida entres filas de la misma altura, la etieueta de cada fila es lo m�s ancha posible.

Intenta esto:

Compila y ejecuta la aplicaci�n. El c�digo fuente est� en LabelDemo.java, y la imagen en middle.gif.
Redimensiona la ventana para poder ver c�mo los contenidos de las etiquetas se sit�an con las �reas de dibujo.

Todos los contenidos de las etiquetas tienen el alineamiento vertical por defecto -- los contenidos est�n centrados verticalmente en el �rea de la etiqueta. La etiqueta superior que contiene texto e imagen, tiene alineamiento horizontal centrado. La segunda etiqueta, que s�lo tiene texto, tiene alineamiento a la izquierda que es por defecto para las etiquetas de s�lo texto. La tercera etiqueta, que contiene s�lo una imagen, tiene alineamiento horizontal centrado, que es por defecto para las etiquetas s�lo de im�genes.

Abajo puedes ver el c�digo de LabelDemo.java que crea las etiquetas del ejemplo anterior.

ImageIcon icon = new ImageIcon("images/middle.gif");
. . .
label1 = new JLabel("Image and Text",
		    icon,
		    JLabel.CENTER);
//Set the position of the text, relative to the icon.
label1.setVerticalTextPosition(JLabel.BOTTOM);
label1.setHorizontalTextPosition(JLabel.CENTER);

label2 = new JLabel("Text-Only Label");

label3 = new JLabel(icon);

//Add labels to the JPanel.
add(label1);
add(label2);
add(label3);

�El API Label

Las siguientes tablas listan los m�todos y constructores m�s utilizados de JLabel. Otros m�todos est�n definidos por la clase Component. Incluyen setFont y setForeground. El API se divide en dos categor�as.

�Seleccionar u Obtener el Contenido de la Etiqueta

M�todo	Prop�sito
JLabel(Icon) JLabel(Icon, int) JLabel(String) JLabel(String, Icon, int) JLabel(String, int) JLabel()	Crea un ejemplar de JLabel, inicializ�ndolo para tener texto/imagen/alineamiento especificados. El argumento int especifica el alineamiento horizontal del contenido de la etiqueta dentro de su �rea de dibujo. El alineamiento horizontal debe ser una de las siguientes constantes definidas en el interface SwingConstants (que implementa JLabel): LEFT, CENTER, o LEFT.
void setText(String) String getText()	Selecciona u obtiene el texto mostrado por la etiqueta.
void setIcon(Icon) Icon getIcon()	Selecciona u obtiene la imagen mostrada por la etiqueta.
void setDisplayedMnemonic(char) char getDisplayedMnemonic()	Selecciona u obtiene la letra que deber�a ser la tecla alternativa. Esto es muy �til cuando una etiqueta describe un componente (como un campo de texto) que tiene un tecla alternativa pero no puede mostrarla.
void setDisabledIcon(Icon) Icon getDisabledIcon()	Selecciona u obtiene la imagen mostrada por la etiqueta cuando est� desactivada. Si no se especifica esta imagen, el aspecto y comportamiento crea una manipulando la imagen por defecto.

�Ajuste Fina de la Apariencia de la Etiqueta

M�todo	Prop�sito
void setHorizontalAlignment(int) void setVerticalAlignment(int) int getHorizontalAlignment() int getVerticalAlignment()	Selecciona u obtiene donde deber�a mostrarse el contenido de la etiqueta. El Interface SwingConstants define tres posibles valores para el alineamiento horizontal: LEFT (por defecto para etiquetas de s�lo texto), CENTER (por defecto para etiquetas de s�lo imagen), o LEFT; y tres para alineamiento vertical: TOP, CENTER (por defecto), y BOTTOM.
void setHorizontalTextPosition(int) void setVerticalTextPosition(int) int getHorizontalTextPosition() int getVerticalTextPosition()	Selecciona u obtiene d�nde deber�a mostrarse el texto del bot�n con respecto a su imagen. El interface SwingConstants define tres posibles valores para posici�n horizontal: LEFT, CENTER, y LEFT (por defecto); y tres para posici�n vertical: TOP, CENTER (por defecto), y BOTTOM.
void setIconTextGap(int) int getIconTextGap()	Selecciona u obtiene el n�mero de pixels entre el texto de la etiqueta y su imagen.