Zum Hauptinhalt springen

RecView

RecView​

RecView

Details

Das RecView-Objekt eignet sich für die Darstellung von Inhalten aus der Datenbank mit variabler Zeilenhöhe. Beispielsweise ist die Anzeige von Bildern, Text- und RTF-Inhalten möglich. Die anzuzeigenden Inhalte (Elemente) bestimmen sich aus der Spaltendefinition, die im RecView-Editor konfiguriert wird.

Elemente können mit unbegrenzter Höhe (ContentHeightMax = 0) dargestellt werden oder auf eine Höhe begrenzt werden. Ist die Eigenschaft ContentHeightMax < 0, hat das Element eine feste Höhe, die dem Betrag der Eigenschaft entspricht. Enthält die Eigenschaft einer Wert > 0, dann besitzt das Element eine Maximalhöhe des angegebenen Wertes.

Die Höhe einer Zeile leitet sich aus der Höhe des größten Elementes einer Zeile ab.

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 Text- und RTF-Inhalten Wird die Eigenschaft ContentType auf den Wert _WinContentTypeText bzw. _WinContentTypeRTF gesetzt, können Text- und RTF-Inhalte aus Datenbankfeldern, internen Texten, binären Objekten und externen Dateien angezeigt werden. Die Quelle des Inhaltes wird über die Eigenschaft DbFieldName für Datenbankfelder, oder FileName für andere Quellen definiert.
  • Anzeige von Bildern Über die Eigenschaften ContentType mit dem Wert _WinContentTypeImage können Bilder in einem RecView angezeigt werden. Der Pfad des Bildes wird in der Eigenschaft FileName definiert.
  • Anzeige von Feldern aus einer anderen Datei In dem RecView-Objekt können auch Spalten angegeben werden, die Felder aus einer anderen Datei ausgeben, als in der Eigenschaft DbFileNo angegeben ist. Die Caption...-Eigenschaft des jeweiligen (Sub-)Items muss im Ereignis EvtLstGroupInit auf den Inhalt des Felder der anderen Datei gesetzt werden. Auf die gleiche Weise können auch Abkürzungen in der Liste ausgeschrieben werden.
  • Anzeige von beliebigen Werten Zur Laufzeit kann im Ereignis EvtLstGroupInit die Eigenschaft Caption... mit dem jeweiligen Typ direkt gesetzt werden. Somit werden keine Hilfsfelder mehr benötigt.

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

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

  • **** Ziehen eines Feldes aus der Datenstruktur in das View .
  • **** Ziehen eines Teildatensatzes aus der Datenstruktur in das View.
  • **** Mit Betätigung der Strg - und der Umschalt -Taste beim Ziehen wird automatisch ein RecView erstellt.
  • **** Über den RecView-Editor .

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