Programmieren mit dBASE PLUS: Funktionen: atFirst

Aus Wikibooks


Liefert True, wenn sich der Cursor in der ersten Zeile des Datensatzbereichs befindet.

Syntax[Bearbeiten]

<oReferenz>.atFirst( )

<oReferenz>

Der Datensatzbereich, bei dem die Cursorposition geprüft werden soll.

Eigenschaft von[Bearbeiten]

Rowset

Beschreibung[Bearbeiten]

Mit atFirst( ) läßt sich feststellen, ob sich der Cursor in der ersten Zeile eines Datensatzbereichs befindet. Dies ist der Fall, wenn atFirst( ) den Wert True liefert. In den meisten Fällen ist mit der Verwendung von atFirst( ) kein besonderer Aufwand verbunden. Dabei wird üblicherweise die aktuelle Zeile (d.h. der aktuelle Datensatz) mit einer Positionsmarke verglichen, die beim erstmaligen Öffnen der Abfrage der ersten Zeile zugeordnet wird. Dennoch kann die Ausführung von atFirst( ) bei manchen Datentreibern einige Zeit beanspruchen.

Die Methode atFirst( ) wird gewöhnlich verwendet, um ein Zurücksetzen des Datensatzcursors zu verhindern. Wenn Sie nämlich wissen, daß sich der Cursor in der ersten Zeile befindet, ist ein Zurücksetzen über den Anfang des Datensatzbereichs hinaus nicht mehr möglich. Um dem Benutzer diese Situation vor Augen zu führen, können Sie das entsprechende Steuerelement in den Deaktiviert-Status versetzen.

Das Ende des Datensatzbereichs ist anders definiert als die erste Zeile. So kann endOfSet keineswegs True sein, wenn atFirst( ) den Wert True liefert. Vielmehr ist endOfSet genau dann True, wenn sich der Datensatzcursor vor der ersten (oder hinter der letzten) Zeile des Datensatzbereichs befindet.