Bde.DBTables.TBDECallback.Create
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);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| constructor | public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TBDECallback |
Description
Create crée une instance de TBDECallback et recense le callback spécifié dans le moteur de Database Borland (BDE).
Appelez Create pour recenser une fonction de rappel dans le BDE. Créez un objet TBDECallback avant d'appeler une fonction BDE pouvant utiliser ce callback pour répondre aux événements.
Quand le BDE rencontre le type d'événement spécifié par le paramètre CBType, la fonction spécifiée par le paramètre CallbackEvent est appelée. La fonction CallbackEvent reçoit un pointeur sur un descripteur de callback. Le type de descripteur de callback varie en fonction de CBType. C'est à l'application Delphi d'allouer la mémoire du descripteur de callback. Un pointeur désignant ce tampon mémoire est transmis dans le paramètre CBBuf, ainsi que sa taille dans le paramètre CBBufSize.
Le paramètre Chain indique si la fonction de callback doit remplacer les autres callback de même type (CBType). Si Chain a la valeur false, la fonction CallbackEvent remplace tous les rappels recensés antérieurement pour le type CBType. Si Chain a la valeur true, la fonction CallbackEvent est appelée ainsi que les autres rappels recensés.
Le paramètre Handle est un paramètre facultatif décrivant le curseur de base de données associé à la fonction BDE pouvant générer le callback. Spécifiez le paramètre Handle pour rendre la fonction de callback spécifique à un appel de fonction BDE portant sur ce curseur.
Les types de descripteurs de callback associés à chaque valeur de CBType sont décrits dans le tableau suivant. Pour davantage d'informations, voir la documentation du BDE.
CBType Utilisation Descripteur de rappel
| CBType | Utilisation | Descripteur de callback |
|---|---|---|
|
cbGENPROGRESS |
Répondre aux informations sur le degré d'avancement dans les opérations groupées longues. Permet d'implémenter une barre d'avancement ou un bouton Annuler. Renvoyer cbrABORT pour annuler, cbrCONTINUE pour continuer. |
CBPROGRESSDesc |
|
cbRESTRUCTURE |
Indiquer au BDE comment gérer les problèmes liés à la restructuration d'une table. |
Renvoyer cbrYES, pour effectuer le traitement par défaut, cbrNO pour ne pas effectuer le traitement par défaut et cbrABORT pour annuler la restructuration. |
|
cbBATCHRESULT |
Indiquer au BDE comment gérer les problèmes dans les opérations groupées. Renvoyer cbrYES, pour effectuer le traitement par défaut, cbrNO pour ne pas effectuer le traitement par défaut et cbrABORT pour annuler l'opération groupée. |
RESTCbDesc |
|
cbTABLECHANGED |
Répondre à une notification de modification de table. La valeur renvoyée n'est pas prise en compte. |
inutilisé |
|
cbCANCELQRY |
Renvoyer cbrABORT pour annuler une requête d'exécution longue ou cbrCONTINUE pour poursuivre. La fonction de callback est appelée à intervalles réguliers durant l'exécution de la requête. |
inutilisé |
|
cbINPUTREQ |
Indiquer au BDE comment répondre à l'absence d'un fichier (par exemple, une table de recherche). Indiquer le comportement à adopter dans CBInputDesc et renvoyer cbrCONTINUE. |
CBInputDesc |
|
cbDBASELOGIN |
Entrer un mot de passe pour une table dBASE cryptée et renvoyer cbrCONTINUE. |
CBLoginDesc |
|
cbFIELDRECALC |
Répondre aux notifications demandant le recalcul d'un champ. La valeur renvoyée n'est pas prise en compte. |
inutilisé |
|
cbTRACE |
Répondre aux demandes d'information de suivi sur les actions effectuées par le BDE. La valeur renvoyée n'est pas prise en compte. |
TRACEDesc |
|
cbDBLOGIN |
Se connecter à un serveur de base de données. Renvoie cbrCONTINUE. |
inutilisé. |
|
cbDELAYEDUPD |
Répondre à une notification informant de l'échec de l'écriture d'un enregistrement du cache des mises à jour dans la base de données. Renvoyer cbrABORT pour annuler toutes les mises à jour du cache, cbrSKIP ou cbrCONTINUE pour abandonner la mise à jour ayant échoué et poursuivre l'expédition des enregistrements ou cbrRETRY pour recommencer l'expédition ayant échoué. |
DELAYUPDCbDesc |
Remarque : La VCL utilise de nombreuses fonctions de callback BDE. L'appel de Create en affectant la valeur false à la propriété Chain risque donc de désactiver le comportement normal de certains objets.