Curso de C++ Builder


TForm - Propiedades, métodos y eventos



 

1. Propiedades de los formularios.

 

1.1. Propiedades en tiempo de diseño y ejecución.

 

Propiedad

Descripción

ActiveControl Establece qué componente tiene el foco cuando se abre el formulario.
Enabled Indica si el formulario está activo (si puede recibir el foco).
AutoScroll,
HorzScrollBar y
VertScrollBar
Controlan conjuntamente las barras de desplazamiento de un formulario.
BorderIcons Indica qué iconos aparecen en la barra de título de un formulario.
BorderStyle Indica qué tipo de borde debe tener el formulario.
Caption y Name Caption indica la cadena que aparece en la barra de título del formulario mientras que Name indica con qué nombre se refiere al formulario en la aplicación (en el código).
Color Color de fondo del formulario.
Cursor Especifica qué cursor se muestra cuando está sobre el formulario.
Font Permite especificar las propiedades de la fuente de letra que se usará en el formulario. Se aplica a todos los componentes ubicados en el formulario.
Icon Establece el icono que se verá en la barra de título cuando se muestre el formulario en tiempo de ejecución y cuando se minimize.
Height y Width Altura y anchura (en píxeles) del formulario.
ClientWidth y
ClientHeight
Altura y anchura (en píxeles) del área de cliente del formulario (el área de cliente es la que queda dentro de los bordes del formulario y por debajo de la barra de título y de la barra de menú). Al modificar estas propiedades se actualizan Width y Height.
Left y Top Coordenadas X e Y del formulario (su esquina superior izquierda) en la pantalla.
Position Determina el tamaño y la posición del formulario.
FormStyle Para especificar si un formulario es o no parte de una aplicación multiformulario.
HelpFile y
HelpContext
Para especificar el fichero de ayuda asociado a la aplicación y gestionar la ayuda contextual.
Hint y
ShowHint

Hint especifica el texto que debe aparecer en el cuadro de ayuda o texto de sugerencia asociado al formulario. Este cuadro aparece cuando ocurre el evento OnHint. Por defecto se muestra únicamente el cuadro asociado al componente sobre el que está el ratón por lo que usualmente se emplea esta propiedad para mostrar la información extensa de este componente en una barra de estado, por ejemplo.

ShowHint determina si los cuadros de sugerencia estarán activados o desactivados para el formulario.

Visible Indica si el formulario es visible o no.
Los métodos Show() y ShowModal() hacen que un formulario sea visible y lo colocan por encima de todos.
WindowState Para establecer el estado inicial del formulario (normal, minimizado o maximizado) o consultar su estado.

 

1.2. Propiedades en tiempo de ejecución.

 

Propiedad

Descripción

Active Indica si el formulario está activo (si tiene el foco).
Canvas El lienzo es la superficie del formulario sobre la que se puede dibujar. La propiedad Canvas da acceso a esta superficie para dibujar líneas, mapas de bits, texto, ... en el área de cliente.
Suele usarse con el gestor del evento OnPaint.
ClientRect Coordenadas de los cuatro puntos que delimitan el área de cliente del formulario.
ModalResult El valor devuelto cuando se cierra un formulario modal (abierto con el método ShowModal()).
FormState Proporciona información acerca del estado en que se encuentra un formulario (si se está creando, si es visible, si es modal, etc.).

 

2. Métodos de los formularios.

 

Método

Descripción

BringToFront() y
SendToBack()
Coloca al formulario en primer plano o en último, respectivamente.
Hide() Oculta el formulario (establece la propiedad Visible a falso).
Print() Imprime el contenido del formulario.
Show() y
ShowModal()
Para mostrar formularios. ShowModal() ejecuta (abre) el formulario modalmente: debe cerrarse para que el usuario pueda seguir trabajando con la aplicación.
Close() y
CloseQuery()
Close() cierra el formulario tras llamar a CloseQuery() para asegurarse de que es correcto cerrarlo. Esta última llama al manipulador del evento OnCloseQuery.
SetFocus() Activa el formulario y lo coloca en primer plano, poniendo a verdad la propiedad Active. Además, el componente especificado en la propiedad ActiveControl recibe el foco.
CanFocus() Devuelve verdad si el formulario puede recibir el foco (si las propiedades Visible y Enabled están a verdad).
SetBounds() Establece simultáneamente los valores de las propiedades Top, Left, Width y Height.
ClientToScreen() y
ScreenToClient()
Convierte las coordenadas del área de cliente en coordenadas de pantalla y viceversa.
Invalidate(),
Refresh(),
Repaint() y
Update()
Redibujar un formulario.
Release() Destruye un formulario y libera toda la memoria asociada.

 

3. Eventos de los formularios.

 

Una acción puede desencadenar varios eventos y el orden en ocurren puede ser muy importante:

Eventos asociados a la creación y destrucción de un formulario.
Eventos asociados al movimiento y pulsación con el ratón.
Eventos asociados a la pulsación de alguna tecla.

 

Evento

Descripción

OnActivate y
OnDeactivate
Ocurren cuando se activa o desactiva un formulario, respectivamente.
Un formulario se activa cuando se recibe el foco y se desactiva cuando el foco pasa a otro formulario de la misma aplicación.
OnCreate y
OnDestroy
OnCreate ocurre cuando se crea inicialmente el formulario (sólo ocurre un evento de este tipo por formulario) y OnDestroy cuando se destruye.
OnClose y
OnCloseQuery
El evento OnClose ocurre cuando se cierra un formulario. Hace una llamada a OnCloseQuery para asegurarse de que es correcto cerrarlo.
OnMouseDown,
OnMouseMove,
OnMouseUp,
OnClick y
OnDblClick
Para responder a los eventos que suceden al mover el ratón o cuando se pincha con él sobre el formulario.
OnKeyDown,
OnKeyUp y
OnKeyPress
Para responder a los eventos que suceden al pulsar alguna tecla sobre el formulario.
OnHelp Ocurre cuando se recibe una petición de ayuda en el formulario.
OnHide y
OnShow
Ocurren cuando se oculta o se muestra el formulario, respectivamente (cuando su propiedad Visible se establece a falso o verdad, respectivamente).
OnShow ocurre justo antes de que el formulario se haga visible.
OnPaint Ocurre cuando el formulario necesita ser redibujado (refrescado). Esto ocurre muy frecuentemente, y aunque los componentes del formulario se redibujan por sí mismos generalmente, a veces es preciso redibujar "manualmente" el formulario.
Ocurre antes de que cualquier control sea redibujado.
OnResize Ocurre cuando se modifica el tamaño del formulario, justo después de redimensionar el formulario.
OnShortCut Ocurre cuando se pulsa una tecla, antes de que ocurra OnKeyDown.


Atrás