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.

[MisterNiceGuy]

Geht auch bei mir nicht :/ WM_User und _appbardata kennt er nicht

[Sprint]

Zitat von MisterNiceGuy:

Geht auch bei mir nicht :/ WM_User und _appbardata kennt er nicht

Die Konstante WM_USER befindet sich in der Unit "Messages". Und _AppBarData oder besser TAppBarData findest du in der Unit "ShellAPI".

[CalganX]

Hi,
sorry der Beitrag ist mir ein wenig durch die Lappen gegangen, ich werde die Hinweise auf die Units noch ergänzen.
Jemand sonst noch irgendwelche Fehler gefunden?

Chris

[SirThornberry]

Warum
aAppBarData: _AppBarData als Globale, nur weil man es mehrmals nutzt? Für sowas gibt es doch Private. Schließlich bezieht sich das ganze auf das Hauptform und geht die anderen klassen nix an.

[Fingolfin]

Das Tutorial ist echt gut, hat mir einen guten Start in die Materie vermittelt.

Aber so wie ich das sehe sind Appbars mitunter ein ziemliches Problem, aber vielleicht weiß ja jemand Rat. Die Nutzung einer Appbar zerballert mir einfach manche Menüs in anderen Fenstern. Bei Delphi 2005 kann ich das z.B beobachten. Da ist nach der Erzeugung der Appbar erstmal das Hauptmenü "unter" den Toolbars.

Wenn da jemand einen Tipp hätte, wärs toll.

[Luckie]

Man sollte aber vorher überprüfen, ob sich nicht an der Seite schon eine Appbar befindet. sonst gehat das nämlich schief.

[MisterNiceGuy]

@sprint: Öhm, das Problem ist, dass Chakotay WM_user hätte schreiben müssen.
Damit gehts, jetzt bekomme ich nurnoch einen Fehler bei WM_Appbar (Undef. Bezeichner)

P.S. Einmal muss es iResult heißen, nicht result!!!


Edit1.text := 'Oleole es geht, man muss WM_APPBARMSG schreiben, dann klappts!';

[CalganX]

Hi,
ich habe das mal oben alles korrigiert.
Chris

[phlux]

Nachdem ich hier ein bissl rumgeschnüffelt habe, sind mir ein paar fehler aufgefallen (ich poste mal nur das korrigierte ):

Delphi-Quellcode:

// In der Uses Klausel fehlt die Angaben von ShellApi

// Wenn man schon oben die Variable aAppBarData in fAppBarData umbenennt sollte man es vllt auch im
// ganzen code tun ;)

// Zeile 11
  WM_APPBARMSG = WM_USER + 1;

mfg phlux

[CalganX]

Hi phlux,
done.
Danke für die Hinweise.

Chris