Arbeiten mit AppBars

[CalganX]

Sogenannte AppBars sind bspw. Formulare, die an einer Deskseite sitzen und sich verhalten, wie die Taskleiste: es kann z.B. kein Fenster darüber liegen und es ist immer zu sehen.
Diese AppBar's lassen sich auch mit Delphi-Mitteln relativ einfach erzeugen. Im folgenden will ich das einmal kurz erklären.

Als erstes brauchen wir eine Variable vom Typ _AppBarData. Diese Variable enthält alle wichtige Informationen über die AppBar, die wir an Windows senden. Die Variable muss global bzw. ein Feld des Formulares sein, weil wir auf sie mehrmals im Programm zugreifen müssen.
Dann füllen wir dieses Record mit Daten:

Delphi-Quellcode:

uses {...}, ShellApi, {...};

{...}

type
  TfrmMain = class(TForm)
  {...}
  private
    fAppBarData: _AppBarData;
  {...}
  end;

const
  // Konstante, die als CallBack für die AppBar arbeitet
  WM_APPBARMSG = WM_USER + 1;

{...}

// bspw. im OnCreate-Ereignis des Formulares, welches als AppBar dienen soll
var
  iResult: integer;
begin
  // Größe der ganzen Struktur
  fAppBarData.cbSize := SizeOf(TAppBarData);
  // Handle des Formulares, das als AppBar dienen soll
  fAppBarData.hWnd := Self.Handle;
  // Callback-Message  
  fAppBarData.uCallbackMessage := WM_APPBARMSG;
  // Wo soll die AppBar sein?
  fAppBarData.uEdge := ABE_TOP;
  {Alternative Werte: ABE_BOTTOM, ABE_LEFT, ABE_RIGHT}

  // Rect für den reservierten Platz, wo keine Anwendung "hin darf"
  fAppBarData.rc.Left := 0;
  fAppBarData.rc.Right := 0;
  fAppBarData.rc.Top := 0;
  fAppBarData.rc.Bottom := self.ClientHeight;

Die letzten Zeilen Code zeigen den zu reservierenden Platz. Das Formular kann durchaus größer/kleiner sein (dann müsste bei rc.Bottom ein anderer Wert stehen). Allerdings würde das bewirken, dass der reservierte Platz nicht mehr dem Formular entspricht und es somit zu durchaus komischen Konstruktionen kommen kann.

Delphi-Quellcode:

  // AppBar erstellen
  iResult := SHAppBarMessage(ABM_NEW, fAppBarData);

  // Hat das Erzeugen geklappt?
  if iResult = 0 then
  begin
    ShowMessage('Die AppBar konnte nicht erzeugt werden. Unter Umständen existiert bereits eine AppBar an dieser Position.');
    Exit;
  end;

  // Formular genauso breit machen, wie Bildschirm
  self.Width := screen.Width;

  // Position abfragen und nochmal setzen
  SHAppBarMessage(ABM_QUERYPOS, fAppBarData);
  SHAppBarMessage(ABM_SETPOS, fAppBarData);
  // Nachrichtenschleife abarbeiten
  Application.ProcessMessages;
  // Bringt das Fenster an die gewünschte Position. Dazu werden die vorher festgelegten Werte verwendet.
  MoveWindow(aAppBarData.hWnd, fAppBarData.rc.Left, fAppBarData.Rc.Top,
    GetSystemMetrics(SM_CXSCREEN), fAppBarData.rc.Bottom, true);
end;

Die AppBar wurde nun erzeugt. Am Ende muss der reservierte Platz auf jedenfall wieder freigegeben werden:

Delphi-Quellcode:

// zum Beispiel im OnDestroy-Ereignis des Formulars
begin
  SHAppBarMessage(ABM_REMOVE, aAppBarData);
end;

Fertig ist die AppBar.

[-187-]

Danke erstmal ! ..es waren leider noch ein paar Fehler drinne, hier der Code den ich benutzt habe...

Delphi-Quellcode:

unit Unit1;

interface

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

type
  TForm1 = class(TForm)
    procedure FormCreate(Sender: TObject);
    procedure FormDestroy(Sender: TObject);
  private
    fAppBarData: _AppBarData;
  public
    { Public declarations }
  end;
const
  WM_APPBARMSG = WM_USER + 1;

var
  Form1: TForm1;

implementation

{$R *.dfm}

procedure TForm1.FormCreate(Sender: TObject);
var 
  iResult: integer; 
begin 
  // Größe der ganzen Struktur 
  fAppBarData.cbSize := SizeOf(TAppBarData); 
  // Handle des Formulares, das als AppBar dienen soll 
  fAppBarData.hWnd := Self.Handle; 
  // Callback-Message  
  fAppBarData.uCallbackMessage := WM_APPBARMSG; 
  // Wo soll die AppBar sein? 
  fAppBarData.uEdge := ABE_TOP; 
  {Alternative Werte: ABE_BOTTOM, ABE_LEFT, ABE_RIGHT} 

  // Rect für den reservierten Platz, wo keine Anwendung "hin darf" 
  fAppBarData.rc.Left := 0; 
  fAppBarData.rc.Right := 0; 
  fAppBarData.rc.Top := 0; 
  fAppBarData.rc.Bottom := self.ClientHeight;
  
  // AppBar erstellen 
  iResult := SHAppBarMessage(ABM_NEW, fAppBarData); 

  // Hat das Erzeugen geklappt? 
  if iResult = 0 then 
  begin 
    ShowMessage('Die AppBar konnte nicht erzeugt werden. Unter Umständen existiert bereits eine AppBar an dieser Position.'); 
    Exit; 
  end; 

  // Formular genauso breit machen, wie Bildschirm 
  self.Width := screen.Width; 

  // Position abfragen und nochmal setzen 
  SHAppBarMessage(ABM_QUERYPOS, fAppBarData); 
  SHAppBarMessage(ABM_SETPOS, fAppBarData); 
  // Nachrichtenschleife abarbeiten 
  Application.ProcessMessages; 
  // Bringt das Fenster an die gewünschte Position. Dazu werden die vorher festgelegten Werte verwendet. 
  MoveWindow(fAppBarData.hWnd, fAppBarData.rc.Left, fAppBarData.Rc.Top, 
    GetSystemMetrics(SM_CXSCREEN), fAppBarData.rc.Bottom, true);
end;

procedure TForm1.FormDestroy(Sender: TObject);
begin
  SHAppBarMessage(ABM_REMOVE, fAppBarData);
end;

end.

[einfach112]

SHAppBarMessage(ABM_REMOVE, fAppBarData);

damit habe ich ein problem ....
habe die bar als fAppBarData.uEdge := ABE_BOTTOM;

jetzt muss ich ab und zu die grösse meines programms ändern bzw. somit auch die grösse des reservierten bereichs ...
also lösche ich zunächst den reservierten platz mit :
SHAppBarMessage(ABM_REMOVE, fAppBarData);
das problem ist ....
in diesem moment erstreckt sich meine form über den ganzen Bildschirm....
ich setze zwar dann den platz neu und meine form nimmt dann auch wieder gestallt an aber wie gesagt für einen hundertstel teil erstreckt sich das programm....
jetzt die frage wie kann ich dieses umgehen !?
Danke schonmal wie immer im voraus !
einfach112

[S4SH1981]

Hallo

wie bekomme ich es denn hin, dass ich den ganzen Bereich reserviere, aber mein fenster links rechts mitte angeordnet wird.
sagen wir mal mit 100 pixeln.

Mit

Delphi-Quellcode:

  // Formular genauso breit machen, wie Bildschirm
  self.Width := 100;

gehts nicht.

Gruß S4SH

[S4SH1981]

PUSH

[mkinzler]

Zitat:

self.Width := Screen.Width;

mcht das Formular so breit wie den Bildschirm

[S4SH1981]

Danke Kinzler,

aber ich will, dass mein Fenster nur 100 Pixel breit wird.

[S4SH1981]

*PUSH*

[MuTzE.Y85]

@ S4SH1981

Code:

MoveWindow(fAppBarData.hWnd, Screen.Width div 2 - 50, fAppBarData.Rc.Top, 100, fAppBarData.rc.Bottom, True);

50 Pixel von der Mitte anfangen und 100 Breit.

[whiteF]

hi,

meine Form wird unter dem reservierten Bereich angeordnet

Eig. sollte diese Form ja in dem reservierten Bereich.
Hab den Code 1zu1 kopiert.

Daten PC: Win 7 / 1920*1080

Screenshot anbei:


Die Höhe des blauen freien Bereichs gleicht, dem der Höhe der sichtbaren Form2.

weiß jmd was da schief läuft?

[MuTzE.Y85]

Also bei mir ist es mit dem Code oben im reservierten Bereich.

Hast du das Fenster zu irgendeinem Zeitpunkt in der Größe oder so verändert?
Wenn ich das mache, z.B. mit der Maus, dann ist es darunter.
Bei dir ist das Form2. Was macht Form1?