TForm
Previous  Top  Next

Descripción:

La clase TForm maneja los formularios. Son la base para derivar los formularios definidos por el usuario.  


Herencia:

Hereda de la clase TWinControl.  


Propiedades:

Las propiedades de la clase TWinControl.  
 
ActiveControl: Tipo TWinControl. Contiene el control activo del formulario.  
 
AutoCreate: Tipo lógico. Especifica si el formulario se crea automáticamente al iniciar la aplicación. Por defecto es .T. y se utiliza sólo en el IDE, no está disponible en tiempo de ejecución.  
 
BorderIcons: Tipo TBorderIcons. Contiene el tipo de bordes del formulario. Controla la apariencia del formulario. Todas las combinaciones son posibles pero no visibles, depende de la combinación.  

BorderStyle: Tipo numérico. Contiene el estilo del borde del formulario. Se pueden usar las constantes bsNone, bsSingle, bsSizeable, bsDialog, bsToolWindow y bsSizeToolWindow.  
 
EnabledWithModals: Tipo lógico. Especifica si el formulario permanecerá activo cuando otro formulario sea mostrado de forma modal.  

FileName: Tipo carácter y sólo disponible en tiempo de diseño. Contiene el nombre del archivo fuente asociado.  

FormStyle: Tipo numérico. Contiene el estilo del formulario. Se pueden usar las constantes fsNormal, fsMDIChild, fsMDIForm y fsStayOnTop.  

Icon: Tipo TIcon. Contiene el icono del formulario. Este icono puede ser distinto del que se asigne a la aplicación.  

Menu: Tipo TMainMenu. Contiene el menú del formulario.  

MaxHeight: Tipo numérico. Si es distinto de cero especifica la altura máxima del formulario.  

MaxWidth: Tipo numérico. Si es distinto de cero especifica la anchura máxima del formulario.  

MinHeight: Tipo numérico. Si es distinto de cero especifica la altura mínima del formulario.  

MinLeft: Tipo numérico. Si es distinto de cero especifica la posición izquierda mínima del formulario.  
 
MinTop: Tipo numérico. Si es distinto de cero especifica la posición superior mínima del formulario.  
 
MinWidth: Tipo numérico. Si es distinto de cero especifica la anchura mínima del formulario.  

ModalResult: Tipo numérico. Contiene el valor de salida del modo modal. Se pueden usar las constantes mrNone, mrOk, mrCancel, mrAbort, mrRetry, mrIgnore, mrYes y mrNo. Un formulario visualizado en modo modal se puede cerrar especificando para esta propiedad un valor distinto de mrNone.  

Position: Tipo numérico. Especifica la posición del formulario al hacerlo visible. Se pueden usar las constantes poDesigned, poDefault, poDefaultPosOnly, poDefaultSizeOnly, poScreenCenter y poActiveCenter.  
 
ShowInTaskBar: Tipo lógico. Especifica si el formulario se muestra en la barra de tareas.  

WindowState: Tipo numérico. Especifica el estado del formulario. Se pueden usar las constantes wsNormal, wsMinimized y wsMaximized.  


Métodos:

Los métodos de la clase TWinControl.  

Close(): Oculta, minimiza o destruye el formulario. La acción por defecto para el formulario principal es destruirlo y terminar la aplicación. Para los otros formularios es ocultarlos. Este comportamiento se puede cambiar en el evento OnClose.  

Create( [<oOwner>] ): Constructor del formulario. El parámetro oOwner especifica el objeto que crea este nuevo formulario. Al derivar una clase de TForm, se usa este método para crear todos los controles del formulario. Devuelve una referencia al formulario.  

Hide(): Oculta el formulario. Este método no destruye el formulario.  

Show(): Muestra el formulario.  

ShowModal(): Muestra el formulario en modo modal. Un formulario en modo modal desactiva todos los demás formularios visibles y cuando se cierra se vuelven a activar.  


Eventos:

Los eventos de la clase TWinControl.  

OnClose: Se lanza cuando se cierra el formulario. El método asignado recibe el parámetro por referencia nAction. Por defecto su valor es caHide para los formularios normales y para los que tengan el estilo fsMDIChild con la propiedad BorderIcons:Minimize puesta a .T., el valor caMinimize, en caso contrario, el valor caNone. Para el formulario principal, un valor distinto de caNone hace que se cierre la aplicación.  

OnCloseQuery: Se lanza cuando se pretende cerrar el formulario. El método asignado recibe el parámetro por referencia lCanClose. Por defecto su valor es .T. Modificando su valor a .F. el formulario ignora la petición de cierre.  

OnCreate: Se lanza cuando se acaba de crear el formulario.  
 
OnDestroy: Se lanza cuando se va a destruir el formulario.  

OnHelp: Se lanza cuando se va a mostrar el diálogo de ayuda. El método asignado recibe el parámetro por referencia lCallHelp. Por defecto su valor es .T. Modificando su valor a .F. no se muestra el diálogo.  

OnHide: Se lanza cuando se oculta el formulario.  

OnShow: Se lanza cuando se muestra el formulario.