Italian community of Lazarus and Free Pascal

La toolbar (lett. barra degli strumenti) è un componente (widget) delle più usate interfacce utente. È una barra orizzontale o verticale, o un box, che raccoglie, sotto forma di icone, i collegamenti alle funzioni più usate di un software.
Lazarus permette di usare tale strumento in maniera abbastanza semplice, vediamo come con un esempio.

Per prima cosa creiamo un nuovo progetto applicazione e inseriamo sulla nuova form il componente TToolBar che troviamo nella categoria "Common controls" e in più inseriamo un oggetto TImage che troviamo nella categoria "Additional".

Bene ora andiamo nell'evento OnCreate della form e inseriamo il seguente codice



procedure TForm1.FormCreate(Sender: TObject);
begin

  stampaNome:=FALSE;
  stampaCaption:=FALSE;
  ToolBar1 := TToolBar.Create(Self);
  ToolBar1.Parent := Self;
  ToolBar1.Transparent:=true;

  AddButton(ToolBar1,'Btn_Nuovo','Nuovo',tbsButton,Application.Location + 'project1.ico');
  AddButton(ToolBar1,'Btn_Salva','Salva',tbsButton);
  AddButton(ToolBar1,'Btn_sep1','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep2','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep3','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep4','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep5','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep6','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep7','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep8','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_ChkNome','Nome',tbsCheck);
  AddButton(ToolBar1,'Btn_ChkCaption','Caption',tbsCheck);
  ToolBar1.ShowCaptions := True; //per vedere il contenuro dei pulsanti
  ToolBar1.Height := 40;
  ToolBar1.ButtonWidth := 75;
  ToolBar1.ButtonHeight:=40;
  DisegnaSfondoToolBar();
end;


Dovrebbe subito balzare alla nostra attenzione l'uso massiccio della procedura AddButton che è così composta


procedure TForm1.AddButton(ToolBar: TToolBar; ButtonName: string; ButtonCaption: string; ButtonStyle: TToolButtonStyle; NomeIcona: string='');
var
   MyImageList: TImageList;
   {$IFDEF WIN32}
           app: TCustomIcon;
   {$ENDIF}
   {$IFDEF UNIX}
           app: TIcon;
   {$ENDIF}
begin
     if length(trim(NomeIcona))>0 then
     begin
          {$IFDEF WIN32}
                  app:=TCustomIcon.Create;
          {$ENDIF}
          {$IFDEF UNIX}
                  app:=TIcon.Create;
          {$ENDIF}
          app.LoadFromFile(NomeIcona);
          MyImageList:=TImageList.Create(nil);
          MyImageList.AddIcon(app);
          app.Free;
     end;
    with TToolButton.Create(ToolBar) do
    begin
      Parent := ToolBar;
      Caption := ButtonCaption;
      Name := ButtonName;
      Style := ButtonStyle;
      if length(trim(NomeIcona))>0 then
      begin
           ToolBar1.Images:=MyImageList;
           ImageIndex := 0;
      end;
      AutoSize := False;
      OnClick:=@EffettuaOperazione;

    end;
end;


Questa procedura appena vista permette di creare nuovi pulsanti sulla Toolbar creata passandogli in ordine: la toolbar su cui inserire, il nome dell'oggetto, la caption dell'oggetto, lo stile dell'oggetto e (opzionale) il percorso dell'icona da visualizzare sull'oggetto.
Ma anche un'altra procedura dovrebbe attirare la nostra curiosità nella OnCreate della form ed è la seguente:


procedure TForm1.DisegnaSfondoToolBar();
begin
  Image1.Width:=Form1.Width;
  Image1.Height:=ToolBar1.Height;
  Image1.Top:=ToolBar1.Top;
  Image1.Left:=ToolBar1.Left;
  Image1.Picture.LoadFromFile(Application.Location + 'Immagine.PNG');
  Image1.Stretch:=TRUE;
end;


La procedura DisegnaSfondoToolBar disegna esattamente sotto la toolbar il contenuto di Immagine.PNG e siccome precedentemente avevamo impostato ToolBar1.Transparent:=true sembra che abbiamo dato uno sfondo alla nostra Toolbar (per il momento questo trucchetto ha avuto riscontro solo su windows, mentre su linux non sono riuscito a farlo funzionare), appena riesco a trovare la soluzione lo correggo.
Per ultima cosa analizziamo la seguente procedura:


procedure TForm1.EffettuaOperazione(Sender: TObject);
var
   i: integer;
   ret: string;
begin

     for i:=0 to (ToolBar1.ButtonCount-1) do
     begin
          if (ToolBar1.Buttons[i].Name=((Sender as TControl).Name)) then
          begin
               if (Sender as TControl).Name='Btn_ChkNome' then
               begin
                  if ToolBar1.Buttons[i].Down=TRUE then
                     StampaNome:=TRUE
                  else
                      StampaNome:=FALSE;
               end
               else if (Sender as TControl).Name='Btn_ChkCaption' then
               begin
                  if ToolBar1.Buttons[i].Down=TRUE then
                     StampaCaption:=TRUE
                  else
                      StampaCaption:=FALSE;
               end
               else
               begin
                    ret:='';
                    if StampaNome=TRUE then
                       ret:=ret + ' ' + ToolBar1.Buttons[i].Name;
                    if StampaCaption=TRUE then
                       ret:=ret + ' ' + ToolBar1.Buttons[i].Caption;
                   ShowMessage(trim(ret));
               end;
          end;
     end;
end;


Che viene richiamata sull'evento OnClick di tutti i componenti che abbiamo aggiunto con la AddButton sulla TToolBar che se le tbsCheck sono cliccate o meno stampano a video risultati diversi.
Bene l'esempio è abbastanza semplice, a onor del vero sono riuscito a visualizzare l'icona del pulsante con nome Btn_Nuovo solo su windows, mentre su linux no. Ma appena riesco a risolvere l'arcano aggiornerò anche questo How To.
Segue il codice completo.



unit Unit1;

{$mode objfpc}{$H+}

interface

uses
  Classes, SysUtils, FileUtil, Forms, Controls, Graphics, Dialogs, ComCtrls,
  ExtCtrls;

type

  { TForm1 }

  TForm1 = class(TForm)
    Image1: TImage;
    ToolBar1: TToolBar;
    procedure FormCreate(Sender: TObject);
    procedure EffettuaOperazione(Sender: TObject);
    procedure AddButton(ToolBar: TToolBar; ButtonName: string; ButtonCaption: string; ButtonStyle: TToolButtonStyle; NomeIcona: string='');
    procedure DisegnaSfondoToolBar();
    procedure FormResize(Sender: TObject);
  private
    { private declarations }
    stampaNome, stampaCaption: BOOLEAN;
  public
    { public declarations }
  end;

var
  Form1: TForm1;

implementation

{$R *.lfm}

{ TForm1 }

procedure TForm1.EffettuaOperazione(Sender: TObject);
var
   i: integer;
   ret: string;
begin

     for i:=0 to (ToolBar1.ButtonCount-1) do
     begin
          if (ToolBar1.Buttons[i].Name=((Sender as TControl).Name)) then
          begin
               if (Sender as TControl).Name='Btn_ChkNome' then
               begin
                  if ToolBar1.Buttons[i].Down=TRUE then
                     StampaNome:=TRUE
                  else
                      StampaNome:=FALSE;
               end
               else if (Sender as TControl).Name='Btn_ChkCaption' then
               begin
                  if ToolBar1.Buttons[i].Down=TRUE then
                     StampaCaption:=TRUE
                  else
                      StampaCaption:=FALSE;
               end
               else
               begin
                    ret:='';
                    if StampaNome=TRUE then
                       ret:=ret + ' ' + ToolBar1.Buttons[i].Name;
                    if StampaCaption=TRUE then
                       ret:=ret + ' ' + ToolBar1.Buttons[i].Caption;
                   ShowMessage(trim(ret));
               end;
          end;
     end;
end;

procedure TForm1.AddButton(ToolBar: TToolBar; ButtonName: string; ButtonCaption: string; ButtonStyle: TToolButtonStyle; NomeIcona: string='');
var
   MyImageList: TImageList;
   {$IFDEF WIN32}
           app: TCustomIcon;
   {$ENDIF}
   {$IFDEF UNIX}
           app: TIcon;
   {$ENDIF}
begin
     if length(trim(NomeIcona))>0 then
     begin
          {$IFDEF WIN32}
                  app:=TCustomIcon.Create;
          {$ENDIF}
          {$IFDEF UNIX}
                  app:=TIcon.Create;
          {$ENDIF}
          app.LoadFromFile(NomeIcona);
          MyImageList:=TImageList.Create(nil);
          MyImageList.AddIcon(app);
          app.Free;
     end;
    with TToolButton.Create(ToolBar) do
    begin
      Parent := ToolBar;
      Caption := ButtonCaption;
      Name := ButtonName;
      Style := ButtonStyle;
      if length(trim(NomeIcona))>0 then
      begin
           ToolBar1.Images:=MyImageList;
           ImageIndex := 0;
      end;
      AutoSize := False;
      OnClick:=@EffettuaOperazione;

    end;
end;

procedure TForm1.FormCreate(Sender: TObject);
begin

  stampaNome:=FALSE;
  stampaCaption:=FALSE;
  ToolBar1 := TToolBar.Create(Self);
  ToolBar1.Parent := Self;
  ToolBar1.Transparent:=true;

  AddButton(ToolBar1,'Btn_Nuovo','Nuovo',tbsButton,Application.Location + 'project1.ico');
  AddButton(ToolBar1,'Btn_Salva','Salva',tbsButton);
  AddButton(ToolBar1,'Btn_sep1','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep2','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep3','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep4','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep5','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep6','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep7','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_sep8','|',tbsSeparator);
  AddButton(ToolBar1,'Btn_ChkNome','Nome',tbsCheck);
  AddButton(ToolBar1,'Btn_ChkCaption','Caption',tbsCheck);
  ToolBar1.ShowCaptions := True; //per vedere il contenuro dei pulsanti
  ToolBar1.Height := 40;
  ToolBar1.ButtonWidth := 75;
  ToolBar1.ButtonHeight:=40;
  DisegnaSfondoToolBar();
end;

procedure TForm1.DisegnaSfondoToolBar();
begin
  Image1.Width:=Form1.Width;
  Image1.Height:=ToolBar1.Height;
  Image1.Top:=ToolBar1.Top;
  Image1.Left:=ToolBar1.Left;
  Image1.Picture.LoadFromFile(Application.Location + 'Immagine.PNG');
  Image1.Stretch:=TRUE;
end;

procedure TForm1.FormResize(Sender: TObject);
begin
  DisegnaSfondoToolBar();
end;


end.



E' possibile scaricare l'esempio completo al seguente indirizzo: http://www.lazaruspascal.it/esempi/toolbar.zip