Diferencia entre revisiones de «PRG DELPHI/FRAMES»

De Pragma Wiki
Ir a la navegación Ir a la búsqueda
Sin resumen de edición
Línea 144: Línea 144:
end;
end;
</pre>
</pre>
=Agregar dos botones=
Ahora podemos agregar dos botones al panel inferior:
*Uno para (hipotéticamente) guardar el texto ingresado en el memo, lo llamaremos BotonGuardar.
*Otro para cancelar la edición y dejar el panel en blanco, lo llamaremos BotonCancelar.
Vemos como el desarrollador ve los nuevos botones ubicados abajo a la derecha:
[[Archivo:20250507 1634 BOTONES EN FORM DESARROLLADOR.png|miniaturadeimagen|no|Botones según la vista del desarrollador:]]
Cuando estamos armando el form en Delphi cada componente tiene acceso a una pantalla llamada '''Object Inspector''' (inspector de objetos) que permite definir sus propiedades como el nombre del control, el caption o texto (por ejemplo, Guardar o Cancelar) y muchas otras.
Por ejemplo, vemos esa pantalla para el botón de guardar:
[[Archivo:20250507 1614 PROPERTY INSPECTOR.png|miniaturadeimagen|no|Inspector de propiedades de un control.]]
La segunda pestaña del inspector de objetos permite definir eventos, por ejemplo, definiremos el evento OnClick que se ejecuta cuando alguien presiona el botón de guardar:
[[Archivo:20250507 1623 PROPERTY INSPECTOR EVENTOS.png|miniaturadeimagen|no|Definiendo eventos en el inspector de objetos.]]
Finalmente vemos como los ve el usuario:
[[Archivo:20250507 1636 BOTONES EN FORM USUARIO.png|miniaturadeimagen|no|Botones según la vista del usuario.]]
===Evento OnClick===
Vemos como quedan definidos los botones y sus eventos OnClick en la interfaz:
[[Archivo:20250507 1632 BOTONES EN INTERFAZ FORM.png|miniaturadeimagen|no|Botones en la interfaz del form.]]
La implementación del click sobre el botón de Cancelar es la siguiente:
<pre>
procedure TTPersonaForm.BotonCancelarClick(Sender: TObject);
begin
  { Escribimos el código a ejecutar cuando hagan click sobre el botón de Cancelar
  , por ahora solo limpiamos el contenido del memo y seteamos el cursor sobre
  ese comntrolGuardar... }
  Memo1.Lines.Clear;
  Memo1.SetFocus;
end;
</pre>
Recordar que todo lo que está entre '''{''' y '''}''' es un comentario. Fuera de eso la programación hace:
*'''Memo1''' es el nombre del control del memo.
*'''Lines''' es una de sus propiedades para guardar el contenido del memo, es una lista de strings.
*A su vez, esta lista tiene un procedimiento que se llama '''Clear''' para vaciarla y eso vacía el memo.
*Finalmente llama al procedimiento '''SetFocus''' existente en todos los controles visuales que lleva el cursor al memo.

Revisión del 17:01 8 may 2025

Introducción

Los frames de Delphi tienen una definición muy similar a la de los forms permitiendo el agregado de controles visuales (y no visuales) y programando su funcionalidad, pero para mostrarse deben ser 'pegados' en algún otro componente visual, por ejemplo, un panel dentro de un form. Es decir, que desarrollamos los frames como si fueran un form, pero la única manera de interactuar con ellos es pegándolos a un componente que lo permita. Los frames son útiles para organizar grupos de controles que se usan en múltiples lugares en la aplicación.

Por ejemplo, en Pragma todas las pantallas pueden mostrarse en dentro de la aplicación:

Un frame dentro de la aplicación.

O pueden mostrarse en un form independiente:

Un frame en un form independiente.

En ambos casos es el mismo frame que arma la pantalla (según la definición de la misma en la base de datos, más sobre esto más adelante), y se puede mostrar dentro del panel a derecha de la aplicación o en un form independiente.

(Ver Trabajar con frames en Delphi).

Los frames también permiten la orientación de objetos y un frame puede ser derivado por otro:

  • El frame de base podría contener controles estándar como un menú, un botón de aplicar, un botón de cancelar y funcionalidad básica.
  • Los frames que derivan del anterior pueden agregar controles específicos a los datos que editan, por ejemplo: podría haber una frame de clientes, otro de artículos, con su propia funcionalidad y ambas se favorecen de la funcionalidad del ancestro.

La aplicación de Pragma hace un uso extensivo de los frames.

Frame de ejemplo

Como ayuda para comprender la estructura de los frames crearemos un frame sencillo con algunos controles y funcionalidad básica. Siguiendo con el ejemplo de la clase TPersona el form se llamará TPersonaFrame.

Un frame tiene dos vistas distintas:

  • La vista que ve el usuario durante la ejecucuión de la aplicación.
  • La vista que tiene el desarrollador mientras crea el form.

Crear un nuevo frame

Los frames pueden crearse usando herramientas de Delphi o programando, en este caso usaremos Delphi.

Cuando recién creamos un frame el desarrollador verá lo siguiente:

Frame vacío visto por el desarrollador.

Notar los puntos en pantalla que asisten para ubicar los controles.

Eventualmente veremos la vista del usuario, por ahora vamos a agregar algún control.

Código del nuevo frame

El código hasta ahora apenas si contiene algunos comandos, aunque se nota muy parecido a una clase:

unit PersonaFrame;

interface

uses
  Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms, 
  Dialogs;

type
  TTPersonaFrame = class(TFrame)
  private
    { Private declarations }
  public
    { Public declarations }
  end;

implementation

{$R *.dfm}

end.

Al igual que una clase tiene:

  • unit.
  • interface.
  • uses.
  • type.
  • implementation.

Y deriva de la clase TFrame que es un objeto incluido en Delphi.

Definición de clases en Delphi puede servir como referencia.

Eventos en el frame

Un evento es un acontecimiento que ocurre dentro de una aplicación, los eventos pueden vincularse con procedimientos de objetos para que éstos hagan algo cuando sean notificados.

Al igual que cualquier componente, los frames permiten la definición de eventos. Aunque no tienen, como los forms, los eventos de OnShow y OnHide.

Eventoa en un frame.

(Ver más sobre eventos en Eventos en Delphi).

Agregar controles al frame

Los controles son objetos visuales que permiten la interacción del usuario con la aplicación tales como:

  • Paneles.
  • Cajas de edición.
  • Checkboxes.
  • Botones.

Vamos a agregar algo al frame.

Agregar un checkbox

Un checkbox permite marcar un campo indicando algo, solo tiene 2 valores posibles: marcado o desmarcado.

Para el desarrollador se ve así:

Un checkbox en un frame.

En el código:

type
  TTPersonaFrame = class(TFrame)
    CheckBoxDeAcuerdo: TprxCheckBox;

El tipo del control es TprxCheckBox que es un checkbox programado en Pragma que deriva de TCheckBox.

Delphi además guarda información en un archivo con detalles sobre el tamaño, alineación y jerarquía de los controles del frame, por ejemplo:

object TPersonaFrame: TTPersonaFrame
  Left = 0
  Top = 0
  Width = 345
  Height = 257
  TabOrder = 0
  object CheckBoxDeAcuerdo: TprxCheckBox
    Left = 64
    Top = 56
    Width = 233
    Height = 14
    Caption = 'Click si est'#225' de acuerdo'
    TabOrder = 0
  end
end

Cómo usar el frame

Vamos a mostrar el frame en el form que creamos en Definición de forms en Delphi, antes de eso hay que hacer un par de cambios.

Para empezar, vamos a agregar un panel justo debajo del memo, y un botón para agregar el frame:

Cambios al form para abrir el frame.

Y al botón le agregamos un evento OnClick para que se ejecute cuando lo piquemos, el código es:

procedure TTPersonaForm.ButtonCrearFrameClick(Sender: TObject);
var
  vFrame: TTPersonaFrame;
begin
  vFrame := TTPersonaFrame.Create(Self);
  vFrame.Name   := 'nombre_del_frame';
  vFrame.Parent := PanelParaFrame;
  vFrame.Align  := alClient;
end;