Zum Hauptinhalt springen

AreaClientRestore

AreaClientRestore​

Größe des Client-Bereichs herstellen

Details

Frame-Objekte bestehen aus einem so genannten Non-Client-Bereich und einem Client-Bereich. Der Non-Client-Bereich enthält die Titelleiste, sowie den Fensterrand. Der Client-Bereich enthält die graphischen Objekte.

Die Area-Eigenschaften (AreaTop, AreaLeft, AreaRight und AreaBottom) geben die äußeren Abmessungen eines Fenster-Objekts an. Bei einer Veränderung z. B. der Höhe der Titelleiste über die Systemeinstellungen von Windows, verändert sich ebenfalls die Höhe des Client-Bereiches. Unter Umständen ist dies jedoch nicht gewünscht, da beispielsweise sonst Teile von Objekten die am unteren Rand stehen, abgeschnitten werden.

Beim Speichern eines Frame-Objekts im Designer, wird immer die Höhe des Client-Bereiches im Frame-Objekt gespeichert. Durch das Aktivieren der Eigenschaft AreaClientRestore in der Eigenschaftsliste wird die Größe des Client-Bereiches nach der Fenstererstellung wiederhergestellt (auch beim Öffnen des Frames im Designer).

Die Eigenschaft kann auch prozedural gesetzt werden, jedoch muss dies geschehen, bevor der Frame erzeugt wird, am besten direkt nach der Anweisung WinOpen () oder im Ereignis EvtInit des Frame-Objektes:

Beispiel:

tHdl # WinOpen(_WinOpenDialog);
if (tHdl != 0)
{
  // Die Anweisung weist das Frame-Objekt an, die Größe des Client-
  // Bereiches wiederherzustellen.
  tHdl->wpAreaClientRestore # true;

  // Durch WinDialogRun() wird der Frame erzeugt und sichtbar gemacht.
  // Erst hier wird die Wiederherstellung durchgeführt.
  tHdl->WinDialogRun(_WinDialogCenterScreen);
  tHdl->WinClose();
}