Elemento: PanelDibujo.
Icono:
Texto: Un contenedor 2D para elementos de dibujo.
Descripción: Un PanelDibujo es un contenedor especial para hijos que sean elementos de dibujo. Aunque también es un contenedor, no debe usarse para albergar otro tipo de elementos.
Los paneles de dibujo representan una región del plano bidimensional y proporcionan su propio sistema de coordenadas, desde el punto (Mínimo X, Mínimo Y) al (Máximo X, Máximo Y). (Aunque también pueden ajustar sus escalas automáticamente).
Los paneles de dibujo son interactivos y responden a los diferentes gestos del ratón según el esquema siguiente:
Cuando el usuario hace clic en el panel, se invoca la acción asociada a la propiedad "Al Pulsar". Inmediatamente después, se fijan las propiedades "X" e "Y" del panel a las coordenadas de la posición del ratón, lo que invoca a su vez a la acción asociada a la propiedad "Al Mover", si la hubiera.
Cuando el usuario mueve el ratón (con el botón del ratón apretado), se actualizan las propiedades "X" e "Y" y se invoca la acción asociada a la propiedad "Al Mover".
Cuando el usuario finalmente suelta el botón del ratón (si lo hace dentro del elemento) se invoca la acción asociada a la propiedad "Al Soltar".
Tabla de propiedades |
||
Nombre | Descripción | Valores aceptados |
Escalas | ||
Autoescala X | Si se debe calcular automáticamente la escala en el eje X. | Una variable booleana o una de las constantes true o false. |
Autoescala Y | Si se debe calcular automáticamente la escala en el eje Y. | Una variable booleana o una de las constantes true o false. |
Mínimo X | El menor valor de la coordenada X que resulta visible en el panel. | Una constante o variable de tipo double. |
Máximo X | El mayor valor de la coordenada X que resulta visible en el panel. | Una constante o variable de tipo double. |
Mínimo Y | El menor valor de la coordenada Y que resulta visible en el panel. | Una constante o variable de tipo double. |
Mínimo Y | El mayor valor de la coordenada Y que resulta visible en el panel. | Una constante o variable de tipo double. |
Interacción | ||
X | La coordenada X de la posición del ratón. | Una variable de tipo double. |
Y | La coordenada Y de la posición del ratón. | Una variable de tipo double. |
Al Pulsar | La acción a invocar cuando se hace clic sobre el panel. | El código Java a invocar para la acción. |
Al Mover | La acción a invocar cuando se arrastra el ratón pulsado sobre el panel. | El código Java a invocar para la acción. |
Al Soltar | La acción a invocar cuando se suelta el botón del ratón sobre el panel. | El código Java a invocar para la acción. |
Configuración |
||
Cuadrado | Si debe mantenerse la proporción entre las coordenadas X e Y. | Una variable booleana o una de las constantes true o false. |
Espacios | Los espacios sin usar que deben dejarse alrededor de la zona de dibujo real. | Una variable Object de tipo java.awt.Rectangle o cuatro enteros indicando los mérgenes superior, izquierdo, inferior y derecho, respectivamente. |
Coordenadas | Si se deben mostrar las coordenadas al pulsar sobre un punto del panel. | Una variable booleana o una de las constantes true o false. |
Formato X | El formato para la visualización de la coordenada X. | Cualquier valor aceptado por la clase java.text.DecimalFormat. Ver página auxiliar. El valor por defecto es "x=0.000". |
Formato Y | El formato para la visualización de la coordenada Y. | Cualquier valor aceptado por la clase java.text.DecimalFormat. Ver página auxiliar. El valor por defecto es "y=0.000". |
Aspecto Gráfico |
||
Tamaño | El tamaño del elemento. | Una variable Object de tipo java.awt.Dimension o los valores enteros de ancho y alto, respectivamente, separados por una coma. |
Fondo | El color usado para el fondo del elemento y el de sus hijos (salvo que fijen expresamente su propio valor). | Una variable Object de la clase java.awt.Color
o uno de los colores predefinidos: black,
blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink,
red, white, yellow.
También puede especificarse un color dando las coordenadas enteras (entre 0 y 255) de sus componentes RGB (más la transparencia opcional). El valor por defecto lo decide el sistema. |
Color | El color usado para los textos del elemento o de cualquiera de sus hijos (salvo que fijen expresamente su propio valor). | Ver los valores para la propiedad Fondo. |
Fuente | El tipo de fuente a usar por cualquier texto del elemento o de cualquiera de sus hijos (salvo que fijen expresamente su propio valor). | Una variable Object de la clase java.awt.Font
o una terna de familia, estilo y tamaño, separados por comas. El
estilo debe ser uno de plain,
bold, italic, bold | italic. Ejemplo: Monospaced,italic,18.
El valor por defecto lo decide el sistema. |
Ayuda | El texto mostrado cuando el cursor se posa sobre el elemento. | Cualquier constante o variable de tipo String. |