Foros Club Delphi - Funcionalidad (Popup de ventanas abiertas)

Automatizando las cosas

Veamos la funcionalidad que buscamos:
1.- Añadir elementos al menú de forma automática al añadir formularios hijos nuevos.
2.- Respuesta automática al seleccionar una opción de menú, colocando su formulario en primer plano.
3.- Eliminación automática del menú, al eliminar un formulario hijo

Con este planteamiento necesitamos controlar los mensajes que recibe el formulario principal para detectar el Mensaje WM_COMMAND que se envía al seleccionar una opción TMenuItem y hacer lo mismo en los hijos, esta vez para detectar WM_CLOSE. ¿Como hacemos esto?

Esto requiere hacer SubClassing del formulario principal y de los hijos. Básicamente un SubClassing realiza un cambio en la función de tratamiento de mensajes Windows de una ventana para cambiar su funcionalidad. Hacer un SubClassing en delphi es muy sencillo pues los TWinControl disponen de una función privada y virtual denominada WndProc que equivale a la función de tratamiento de mensajes Windows a nivel API, es decir, maneja mensajes del tipo WM_PAINT y no eventos como OnPaint. A su vez y para facilitar el SubClassing a alto nivel, los TWinColtrol disponen de un puntero público a un procedimiento denominado WindowProc que apunta a WndProc. Si hacemos que WindowProc apunte a nuestra función de tratamiento de mensajes, ya hemos hecho el SubClassing, con una simple asignación.

Vamos a comenzar por los formularios hijos. Generalmente un SubClassing no pretende reescribir toda la función de tratamiento de mensajes sino añadir o cambiar alguna cosa y aprovechar la función original de esa ventana (WndProc) para que haga el resto del trabajo. Es por ello que para cada formulario deberemos conocer su WndProc original y escribir un procedimiento específico para su SubClassing. Esto lo vamos a hacer con una clase de la que crearemos una instancia para cada formulario hijo.

Dado queremos que los formularios hijos informen al formulario principal cuando se van a cerrar, lo primero que vamos a hacer es escribir una clase para realizar el SubClassing. Crearemos un objeto para cada formulario hijo dotándole de una nueva función de tratamiento de mensajes que será un procedimiento que llamaremos SubClassWndProc. Éste va a añadir funcionalidad al formulario y cederá el control a su WndProc original. Necesitamos tantas versiones de SubClassWndProc como formularios hijos y es por ello que lo encapsulamos en una clase de la que crearemos las instancias que nos hagan falta.

Código Delphi [-]  TMForm = class(TForm);    // Clase interpuesta

  TSubclasWindow = class
  private
    Form: TMForm;
    procedure SubClassWndProc(var Message: TMessage);
  public
    MainForm: TForm;
    constructor Create(AForm: TMForm);
    destructor Destroy; override;  
  end;

implementation

constructor TSubclasWindow.Create(AForm: TMForm);
begin
  MainForm:= nil;
  Form:= TMForm(AForm);
  Form.WindowProc:= SubClassWndProc;    // Realizamos el SubClassing
end;

destructor TSubclasWindow.Destroy;
begin
  Form.WindowProc:= Form.WndProc;    // Deshacemos el SubClassing
  inherited Destroy;
end;

procedure TSubclasWindow.SubClassWndProc(var Message: TMessage);
begin
  if Message.Msg = WM_CLOSE then
  begin
    if MainForm <> nil then
      PostMessage(MainForm.Handle, WM_MYCLOSE, WPARAM(Form), 0);
  end;
  Form.WndProc(Message);
end;

Como vemos, esto nos permite tratar WM_CLOSE y enviar al Formulario principal un mensaje personalizado WM_MYCLOSE que informa en WParam cual formulario hijo se va a cerrar. Luego cede el control al WndProc original que al ser privado, lo trampeamos con una clase interpuesta (TMForm). Como necesitamos una función SubClassWndProc para cada formulario hijo, crearemos una instancia para cada uno y las controlaremos en una lista TList.

El SubClassing del formulario principal que es único, lo haremos sobre la clase o componente núcleo de nuestro sistema, y se dedicará a mnejar los mensajes W_COMMAND enviados desde el menú. También dará respuesta a nuestro mensaje personalizado WM_MYCLOSE, enviado desde un formulario hijo que se cierra. Esta sería la forma de tratar esos mensajes:

Código Delphi [-]procedure TMultiWindowMenuControl.SubClassWndProc(var Message: TMessage);
var
  Pos: integer;
begin
  if Message.Msg = WM_MYCLOSE then
    Delete(TForm(Message.WParam))    // Borra de la lista el formulario que se cierra
  else if Message.Msg = WM_COMMAND then
  begin
    Pos:= GetMenuItenPos(LOWORD(Message.WParam));   // Encuentro el ItemMenu que es seleccionado por su ID en WParam
    if Pos >= 0 then
      TSubclasWindow(List.Items[Pos]).Form.BringToFront;    // Pongo el formulario en primer plano
  end;
  Form.WndProc(Message);        // Permitimos respuesta al resto de mensajes con la funcion original 
end;

La funcionalidad completa que tendremos en nuestra clase TMultiWindowMenuControl será así:.
1.- Un cosntructor que capture el Formulario principal, prepare su SubClassing y cree un TList para almacenar objetos TSubclasWindow.
2.- Un destructor que también deshaga los SubClassing.
3.- Asignar el MenuItem principal del que colgaremos los MenuItem para los formularios hijos
4.- Un procedimiento Add para añadir un formulario hijo
5.- Un procedimiento Delete para eliminar un formulario hijo
6.- Un procedimiento Clear que elimine el control de todos los formularios hijos
7.- Una forma de encontrar el MenuItem señalado por el ID que proporciona WM_COMMAND y que llamará GetMenuItenPos
8.- Una respuesta al mensaje WM_MYCLOSE que libere la opcion de menu correspondiente.

El código completo de la clase:

Código Delphi [-]type
  TMultiWindowMenuControl = class(TComponent)
  private
    Form: TMForm;
    FMenuItem: TMenuItem;
    List: TList;
    procedure SubClassWndProc(var Message: TMessage);
    function  GetMenuItenPos(MenuID: Cardinal): Cardinal;
  public
    procedure Add(NewForm: TForm);
    procedure Delete(AForm: TForm);
    procedure Clear;
    procedure SetMenuItem(NewMenuItem: TMenuItem);
    constructor Create(AOwner: TComponent); override;
    destructor Destroy; override;
  published
    property MenuItem: TMenuItem write SetMenuItem;
  end;

implementation

constructor TMultiWindowMenuControl.Create(AOwner: TComponent);
begin
  inherited Create(AOwner);
  FMenuItem:= nil;
  List:= TList.Create;
  Form:= TMForm(AOwner);
  Form.WindowProc:= SubClassWndProc;
end;

destructor TMultiWindowMenuControl.Destroy;
begin
  Form.WindowProc:= Form.WndProc;
  Clear;
  List.Free;
  inherited Destroy;
end;

procedure TMultiWindowMenuControl.Clear;
var
  Item: TMenuItem;
begin
  While List.Count > 0 do
  begin
    TSubclasWindow(List.Items[0]).Free;
    List.Delete(0);
    Item:= FMenuItem.Items[0];
    FMenuItem.Delete(0);
    Item.Free;
  end;
end;

procedure TMultiWindowMenuControl.SetMenuItem(NewMenuItem: TMenuItem);
var
  Item: TMenuItem;
begin
  // Si FMenuItem tenía Items, los traspaso al nuevo MenuItem
  while (FMenuItem <> nil) and (FMenuItem.Count > 0) do
  begin
    Item:= FMenuItem.Items[0];
    FMenuItem.Delete(0);
    NewMenuItem.Add(Item);
  end;
  FMenuItem:= NewMenuItem;
end;

procedure TMultiWindowMenuControl.Add(NewForm: TForm);
var
  i: integer;
  SubClass: TSubclasWindow;
  Item: TMenuItem;
begin
  if FMenuItem <> nil then
  begin
    // Comprobando si existe
    for i:=0 to List.Count-1 do
      if TSubclasWindow(List.Items[i]).Form = NewForm then break;
    if (i < List.Count) and (List.Count > 0) then exit;

    SubClass:= TSubclasWindow.Create(TMForm(NewForm));
    SubClass.MainForm:= Form;
    List.Add(SubClass);
    Item:= TMenuItem.Create(FMenuItem);
    Item.Caption:= NewForm.Caption;
    FMenuItem.Add(Item);
  end;
end;

procedure TMultiWindowMenuControl.Delete(AForm: TForm);
var
  i: integer;
  Item: TMenuItem;
begin
  //Buscando para borrar
  i:= 0;
  While (i < List.Count) and (TSubclasWindow(List.Items[i]).Form <> AForm) do inc(i);
  if i < List.Count then
  begin
    TSubclasWindow(List.Items[i]).Free;
    List.Delete(i);
    Item:= FMenuItem.Items[i];
    FMenuItem.Delete(i);
    Item.Free;
  end;
end;

procedure TMultiWindowMenuControl.SubClassWndProc(var Message: TMessage);
var
  Pos: integer;
begin
  if Message.Msg = WM_MYCLOSE then
    Delete(TForm(Message.WParam))
  else if Message.Msg = WM_COMMAND then
  begin
    Pos:= GetMenuItenPos(LOWORD(Message.WParam));
    if Pos >= 0 then
      TSubclasWindow(List.Items[Pos]).Form.BringToFront;
  end;
  Form.WndProc(Message);
end;

// Encuentra la posición del Item mediante su MenuID
// devuelve -1 si no aparece
function TMultiWindowMenuControl.GetMenuItenPos(MenuID: Cardinal): Cardinal;
var
  Count: Cardinal;
begin
  Result:= Cardinal(-1);
  if FMenuItem <> nil then
  begin
    Count:= GetMenuItemCount(FMenuItem.Handle);
    if (GetMenuItemID(FMenuItem.Handle, 0) <> Cardinal(-1)) and (Count > 0) then
    begin
      Result:= 0;
      while (Result < Count) and (MenuID <> GetMenuItemID(FMenuItem.Handle, Result)) do
        inc(Result);
    end;
    if Result >= Count then Result:= Cardinal(-1);
  end;  
end;

Ambas clases se colocarán un una sola unit y la funcionalidad será tan simple como tener un formulario principal con un menú que nos permita crear formularios hijos y con un MenuItem del que se colgarán los formularios hijos de forma automática. Además, tendrá un objeto de la clase TMultiWindowMenuControl.

Código Delphi [-]// Constructor del formulario principal
procedure TForm1.FormCreate(Sender: TObject);
begin
  MultiWindowMenuControl:= TMultiWindowMenuControl.Create(self);
  MultiWindowMenuControl.MenuItem:= Ventanas;
end;

//Opciones de menú para crear formularios hijos
procedure TForm1.Opcion1Click(Sender: TObject);
begin
  MultiWindowMenuControl.Add(Form2);
  Form2.Show;
end;

procedure TForm1.Opcion2Click(Sender: TObject);
begin
  MultiWindowMenuControl.Add(Form3);
  Form3.Show;
end;
//..............

No hay que hacer nada más para tener el control de los formularios hijos de forma automática en un menú.

Todo el código lo he probado en delphi 7 y Berlin.

En este enlace teneis el código y un ejemplo.

Saludos.