Bde.DBTables.TBDECallback.Create

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

constructor Create(AOwner: TObject; Handle: hDBICur; CBType: CBType;  CBBuf: Pointer; CBBufSize: Integer; CallbackEvent: TBDECallbackEvent; Chain: Boolean);

C++

__fastcall TBDECallback(System::TObject* AOwner, Bde::hDBICur Handle, Data::Dbcommontypes::CBType CBType, void * CBBuf, int CBBufSize, TBDECallbackEvent CallbackEvent, bool Chain);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
constructor public
Bde.DBTables.pas
Bde.DBTables.hpp
Bde.DBTables TBDECallback


Beschreibung

Erzeugt eine Instanz von TBDECallback und registriert die angegebene Callback-Funktion bei der Borland Database Engine (BDE).

Mit Create wird eine Callback-Funktion bei der BDE registriert. Erzeugen Sie mit Create ein TBDECallback-Objekt, bevor eine BDE-Funktion aufgerufen wird, die bei der Reaktion auf Ereignisse auf diese Callback-Funktion zugreift.

Sobald die BDE auf den Ereignistyp stößt, der mit dem Parameter CBType bezeichnet ist, wird die vom Parameter CallbackEvent vorgegebene Funktion aufgerufen. Diese empfängt einen Zeiger auf den Deskriptor einer Callback-Funktion. Der Typ des Deskriptors richtet sich nach CBType. Die Delphi-Anwendung muß für den Callback-Deskriptor Speicher zuweisen. Ein Zeiger auf diesen Speicher wird im Parameter CBBuf übergeben, und seine Größe wird von CBBufSize festgelegt.

Der Parameter Chain steuert, ob diese Callback-Funktion andere Callbacks des Typs CBType ersetzen soll. Wenn Chain den Wert false hat, ersetzt die CallbackEvent-Funktion alle Callback-Funktionen, die als CBType registriert sind. Wenn Chain den Wert true hat, wird die Callback-Funktion zusätzlich zu anderen registrierten Funktionen aufgerufen.

Der Parameter Handle ist optional. Er bezeichent den Datenbank-Cursor, der mit der BDE-Funktion verknüpft ist, die den Callback genrerieren kann. Stellen Sie einen Handle-Wert bereit, wenn ein Callback speziell für Funktionsaufrufe dieses Cursors erfolgen soll.

Der Parameter CBType definiert verschiedene Deskriptoren für die Callback-Funktion (siehe Tabelle). Weitere Informationen finden Sie in der BDE-Dokumentation.

CBTypeUsagecallback-Deskriptor


CBType Bedeutung Deskriptor

cbGENPROGRESS

Auswertung von Informationen über umfangreichere Batch-Operationen. Dazu kann beispielsweise eine Fortschrittsanzeige oder eine Abbruch-Schaltfläche implementiert werden. Für den Abbruch muss cbrABORT zurückgegeben werden, für die Fortsetzung cbrCONTINUE.

CBPROGRESSDesc

cbRESTRUCTURE

Festlegen, wie die BDE Situationen verarbeitet, die während der Umstrukturierung einer Tabelle auftreten. Für die Fortsetzung der Standardverarbeitung muss cbrYES zurückgegeben werden.

Die Fortsetzung ohne Standardverhalten wird mit cbrNO signalisiert. Der Abbruch der Umstrukturierung wird mit cbrABORT ausgelöst.

cbBATCHRESULT

Festlegen, wie die BDE bestimmte Situationen verarbeitet, die während einer Batch-Operation auftreten. Für die Fortsetzung der Standardverarbeitung muss cbrYES zurückgegeben werden. Die Fortsetzung ohne Standardverhalten wird mit cbrNO signalisiert. Der Abbruch der Batch-Operation wird mit cbrABORT ausgelöst.

RESTCbDesc

cbTABLECHANGED

Auf Benachrichtigungen reagieren, die besagen, daß sich die Tabelle geändert hat. Der Rückgabewert wird ignoriert.

Wird nicht verwendet

cbCANCELQRY

Eine längere Abfrage mit cbrABORT abbrechen oder mit cbrCONTINUE fortsetzen. Die Callback-Funktion wird in regelmäßigen Abständen aufgerufen, während die Abfrage ausgeführt wird.

Wird nicht verwendet

cbINPUTREQ

Festlegen, wie die BDE auf fehlende Dateien, z.B. eine fehlende Lookup-Tabelle, reagieren soll. Das gewählte Verhalten wird in CBInputDesc angegeben, und cbrCONTINUE wird zurückgegeben.

CBInputDesc

cbDBASELOGIN

Kennwort für eine verschlüsselte dBASE-Tabelle übergeben und cbrCONTINUE zurückgeben.

CBLoginDesc

cbFIELDRECALC

Auf Benachrichtigungen reagieren, daß Felder neu berechnet werden müssen. Der Rückgabewert wird ignoriert.

Wird nicht verwendet

cbTRACE

Auf Protokollinformationen reagieren, die nach BDE-Aktionen angefertigt wurden. Der Rückgabewert wird ignoriert.

TRACEDesc

cbDBLOGIN

Anmelden bei einem Datenbank-Server. Rückgabewert cbrCONTINUE.

Wird nicht verwendet

cbDELAYEDUPD

Auf Benachrichtigungen reagieren, wenn während des Eintragens von zwischengespeicherten Aktualisierungen ein geänderter Datensatz nicht in die Datenbank geschrieben werden kann. Mit dem Rückgabewert cbrABORT wird die Aktualisierung abgebrochen, mit cbrSKIP oder cbrCONTINUE wird die fehlgeschlagene Aktualisierung verworfen und mit dem Eintragen fortgefahren. Der Rückgabewert cbrRETRY löst einen erneuten Commit-Versuch aus.

DELAYUPDCbDesc


Anmerkung: Die VCL verwendet viele BDE-Callback-Funktionen. Wenn Create aufgerufen wird und Chain den Wert false hat, verhalten sich einige Objekte eventuell nicht so wie gewünscht.

Siehe auch