TBeAdsQuery
TBeAdsQuery
Die Klasse TBeAdsQuery kapselt Eigenschaften und Funktionen für die Verwendung des BeAdsQuery.
Eigenschaften:
Eigenschaften | Bescreibung |
---|---|
CbFilter:C | Liefert den aktuellen Filter zurück oder setzt ihn. |
CbFiltered:L | Aktiviert oder deaktiviert die Filterung der Tabelle. |
CbFieldCount:N | Liefert die Anzahl der Felder zurück. |
CbBoF:L | "Begin of File". Gibt an, ob sich der Zeiger auf dem ersten Datensatz befindet. |
CbEoF:L | "End of File". Gibt an, ob sich der Zeiger auf dem letzten Datensatz befindet. |
CbRecordCount:N | Liefert die Anzahl der Datensätze zurück. |
CbRecNo:N | Liefert die Nummer des aktuellen Datensatzes zurück. |
CbBookmark:C | Speichert die Position des aktuellen Datensatzes in einem Bookmark-String und kann die Position wieder auf diesen Datensatz setzen. |
CbDataAvailable:L | Die Eigenschaft ist True, wenn Datensätze sichtbar sind |
CbNoDataAvailable:L | Die Eigenschaft ist True, wenn keine Datensätze sichtbar sind (z.B. wenn die Tabelle gefiltert ist) |
CbPermFilterCount:N | Gibt die Anzahl der in der Tabelle gesetzten permanenten Filter zurück. |
CbRowsAffected | Liefert die Anzahl der betroffenen Zeilen (nur für UPDATE/DELETE Statement) |
Funktionen | Beschreibung | |
---|---|---|
CbField():O | Die Funktion ermittelt ein Feld-Objekt anhand des Feldindexes und liefert es zurück. Result - Feld-Objekt vom Typ TField | |
Parameter | Beschreibung | |
nIndex:N | Index des Feldes | |
CbFieldByName():0 | Die Funktion ermittelt ein Feld-Objekt anhand des Feldnamens und liefert es zurück. Result - Feld-Objekt vom Typ TField | |
Parameter | Beschreibung | |
cFieldName:C | Name des Feldes | |
CbLocate():L | Die Funktion sucht in der Datenmenge nach einem bestimmten Datensatz und macht diesem zum aktive Datensatz. Result - Datensatz gefunden | |
Parameter | Beschreibung | |
cKeyFields:C | Feldnamen der Felder die durchsucht werden sollen. Durch Semikolon getrennt: 'Feld1;Feld2' | |
cKeyValues:C | Suchbegriffe als Array: {Wert1, Wert2} | |
nOptions:N | Suchoptionen: loCaseInsensitive - Schlüsselfelder und Schlüsselwerte werden ohne Berücksichtigung der Groß-/Kleinschreibung verglichen loPartialKey - Schlüsselwerte müssen nicht vollständig übereinstimmen | |
CbDisplayText():C | Die Methode repräsentiert den Feldwert, wie er in einem datensensitiven Steuerelement angezeigt werden kann. Result - Anzeigetext | |
Parameter | Beschreibung | |
cFieldName:C | Name des Feldes, dessen Anzeigetext ermittelt werden soll | |
CbGoTo():L | Die Funktion sucht in der Datenmenge nach einem bestimmten Datensatz und macht diesem zum aktive Datensatz. Result - Datensatz gefunden | |
Parameter | Beschreibung | |
nRecordNo:N | RecordNumber des Datensatzed, auf den positioniert werden soll | |
CbGetRecAsArray():O | Die Funtkion ermittelt den aktuellen Datensatz als Array. Jedes Feld ist ein Element des Arrays. Result - Datensatz als Array | |
Parameter | Beschreibung | |
keine | keine | |
CbIsNoRecordMove():L | Die Funktion liefert True zurück wenn NoRecordMove für die Tabelle aktiv ist, ansonsten liefert sie False zurück Result - NoRecordMove aktiv | |
Parameter | Beschreibung | |
keine | keine |
Methoden | Beschreibung | |
---|---|---|
CbFirst() | Die Methode positioniert den Zeiger auf den ersten Datensatz. | |
Parameter | Beschreibung | |
keine | keine | |
CbLast() | Die Methode positioniert den Zeiger auf den letzten Datensatz. | |
Parameter | Beschreibung | |
keine | keine | |
CbEnableControls() | Die Methode aktiviert die Benachrichtigungen von datensensitiven Steuerelementen, die mit dem Query verbunden sind, falls diese zuvor mit CbDisableControls() deaktiviert wurden. | |
Parameter | Beschreibung | |
keine | keine | |
CbDisableControls() | Die Methode verhindert die Benachrichtigungen von datensensitiven Steuerelementen, die mit dem Query verbunden sind. Es werden beispielsweise die Browser, welche auf das Query zugreifen nicht mehr automatisch aktualisiert. Dies kann die Geschwindigkeit erheblich erhöhen. Es muss durch ein startseq - always - stopseq sichergestellt werde, das CbEnableControls() ausgeführt wird. | |
Parameter | Beschreibung | |
keine | keine | |
CbNext() | Die Methode verschiebt den Zeiger um einen Datensatz nach unten. | |
Parameter | Beschreibung | |
keine | keine | |
CbPrior() | Die Methode verschiebt den Zeiger um einen Datensatz nach oben. | |
Parameter | Beschreibung | |
keine | keine | |
CbMove() | Die Methode verschiebt den Zeiger um die Anzahl der Datensätze aus nRecordCount in die gewünschte Richtung. Wenn nRecordCount negativ ist wird der Zeiger nach oben verschoben, wenn nRecordCount positiv ist, wird der Zeiger nach unten verschoben | |
Parameter | Beschreibung | |
nRecordCount:N | Anzahl der Datensätze um die der Zeiger verschoben werden soll. | |
CbSetFilter() | Setzt einen Filter auf das Query und aktiviert diesen. | |
Parameter | Beschreibung | |
cFilter:C | Logischer Filter-Ausdruck. | |
CbRefresh() | Die Methode aktualisiert die Datenmenge durch erneutes Abrufen der Daten aus der Datenbank. | |
Parameter | Beschreibung | |
keine | keine | |
CbExecSQL() | Die Funktion führt das SQL Statement aus, das vorher über die Eigenschaft "SQL" des Queries gesetzt wurde. Diese Methode ist für SQL-Statements gedacht, die keine Rückgabemenge erzeugen, also z.B. ein "UPDATE"-Statement. | |
Parameter | Beschreibung | |
keine | keine | |
CbBeginNoRecordMove() | Die Methode aktivert die NoRecordMove-Logik für die Tabelle. Währen NoRecordMove aktiv ist, kann die Tabelle nicht umpositioniert werden. | |
Parameter | Beschreibung | |
cNoRecordMoveFormName:c | Name des Formulars, in dem die Tabelle die gesperrt werden soll, verwendet wird. | |
CbEndNoRecordMove() | Die Methode deaktivert die NoRecordMove-Logik für die Tabelle wieder. Wenn die Methode aufgerufen wird wenn die NoRecordMove-Logik nicht aktiv ist, wird eine Exception ausgelöst | |
Parameter | Beschreibung | |
cNoRecordMoveFormName:c | Name des Formulars, in dem die Tabelle die entsperrt werden soll, verwendet wird. | |
CbAddPermFilter() | Fügt einen permanenten Filter hinzu. | |
Parameter | Beschreibung | |
aFilter:c | Filterbedingung | |
CbRemovePermFilter() | Hebt alle permanente Filter auf. | |
Parameter | Beschreibung | |
keine | keine | |
CbGetPermFilter() | Liefert einen bestimmten Filterausdruck zurück. Falls der eingegebene Index in der Liste der Filter nicht vorhanden ist (z.B. -1), liefert die Funktion alle permanente Filterausdrücke zurück. | |
Parameter | Beschreibung | |
aFilter:N | Filterindex |
Verfügbare Ereignisse | Beschreibung |
---|---|
NoRecordMoveChanged | Nach dem Umschalten der NoRecordMoveLogik |
NoRecordMoveChanging | Beim Umschalten der NoRecordMove-Logik |