Zum Hauptinhalt springen

RecList

RecList​

RecList

Details

Mit diesem Objekt lassen sich Datensätze einer Datei oder Selektionsmenge in Form einer Liste anzeigen. In Abhängigkeit der darzustellenden Datensätze ist folgendes zu beachten:

  • Anzeige Datensätze einer Datei In der Eigenschaft DbFileNo wird die Dateinummer der gewünschten Datei angegeben. Über die Eigenschaft DbKeyNo wird bestimmt, über welchen Schlüssel die Liste sortiert werden soll.
  • Anzeige Datensätze einer verknüpften Datei Bei einer Verknüpfung wird die Zieldatei in der Eigenschaft DbLinkFileNo und die Nummer der Verknüpfung in der Eigenschaft DbKeyNo angegeben.
  • Anzeige Datensätze einer Selektionsmenge Sollen Datensätze einer Selektionsmenge dargestellt werden, wird in der Eigenschaft DbSelection der Deskriptor der Selektion (SelOpen ()) angegeben. Da der Deskriptor der Selektion erst zur Laufzeit bekannt ist, kann diese Eigenschaft nicht im Designer gesetzt werden.
  • Anzeige verknüpfter Datensätze einer Selektionsmenge Sollen verknüpfte Datensätze einer Selektionsmenge dargestellt werden, wird in der Eigenschaft DbSelection der Deskriptor der Selektion (SelOpen ()) angegeben. Da der Deskriptor der Selektion erst zur Laufzeit bekannt ist, kann diese Eigenschaft nicht im Designer gesetzt werden. In der Selektionsmenge müssen die verknüpften Datensätze als Ergebnismenge enthalten sein.
  • Anzeige Datensätze über Filter Sollen Datensätze angezeigt werden, die einem bestimmten Filterkriterium entsprechen, wird in der Eigenschaft DbFilter der Deskriptor des gesetzten Filters (RecFilterCreate ()) angegeben. Da der Deskriptor des Filters erst zur Laufzeit bekannt ist, kann diese Eigenschaft nicht im Designer gesetzt werden.
  • Anzeige von Grafiken Über die Eigenschaften TileNameUser und ClmTypeImage können Grafiken in einer RecList angezeigt werden.
  • Anzeige von Feldern aus einer anderen Datei In dem RecList-Objekt können auch Spalten angegeben werden, die Felder aus einer anderen Datei ausgeben, als in der Eigenschaft DbFileNo angegeben ist. Der Inhalt der Felder muss in dem Ereignis EvtLstDataInit gesetzt werden. Auf die gleiche Weise können auch Abkürzungen in der Liste ausgeschrieben werden.

Die Feldpuffer werden durch die RecList nur dann mit dem selektierten Datensatz gefüllt, wenn beim Ereignis EvtLstSelect eine Funktion angesprungen wird. Der selektierte Datensatz wird erst beim Fokuswechsel in ein anderes Objekt in die Feldpuffer übertragen. Es werden nur die Feldpuffer gesetzt, die in den Spalten der RecList eingetragen sind. Das Übertragen der Feldpuffer beim Fokuswechsel kann durch das Deaktivieren des Flags _WinLstRecFocusTermReset in der Eigenschaft LstFlags unterbunden werden.

Wird beim Ereignis EvtLstSelect eine Funktion aufgerufen, werden die Feldpuffer, die in den Spalten der RecList enthalten sind, mit den Werten des selektierten Datensatzes gefüllt. Diese Übertragung der Feldinhalte kann durch das Flag _WinLstRecSelectBuffer in der Eigenschaft LstFlags aktiviert und deaktiviert werden.

Über das Ereignis EvtLstRecControl der RecList können bestimmte Sätze von der Anzeige ausgenommen werden.

Bei diesem Objekt ist eine Mehrfachselektion möglich. Zur Verwendung der Mehrfachselektion, muss die Eigenschaft MultiSelect gesetzt werden. Weitere Informationen befinden sich im Abschnitt SelectionData -Objekt.

Im Designer ist die Übernahme der Datenbankfelder in die RecList wie folgt möglich:

  • **** Ziehen eines Feldes aus der Datenstruktur in die Liste.
  • **** Ziehen eines Teildatensatzes aus der Datenstruktur in die Liste.
  • **** Mit Betätigung der Strg -Taste beim Ziehen wird automatisch eine RecList erstellt.
  • **** Über den RecList-Editor .

Die Breite des RecList-Objekts ist durch Beschränkungen auf der Ebene des Betriebssystems auf ca. 16.000 Pixel begrenzt. Um ein flexibel verwendbares RecList-Objekt zu erstellen, kann entweder eine RecList mit vielen Spalten angelegt werden, wobei alle Spalten, die nicht benötigt werden, nicht angezeigt werden (Eigenschaft Visible = false), oder es werden die Spalten einer RecList an die darzustellenden Felder (Eigenschaft DbFieldName) angepasst.