Vcl.DBCtrls.TNavigateBtn
Delphi
TNavigateBtn = (nbFirst, nbPrior, nbNext, nbLast,
nbInsert, nbDelete, nbEdit, nbPost, nbCancel, nbRefresh, nbApplyUpdates,
nbCancelUpdates);
C++
enum DECLSPEC_DENUM TNavigateBtn : unsigned char { nbFirst, nbPrior, nbNext, nbLast, nbInsert, nbDelete, nbEdit, nbPost, nbCancel, nbRefresh, nbApplyUpdates, nbCancelUpdates };
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
enum | public | Vcl.DBCtrls.pas Vcl.DBCtrls.hpp |
Vcl.DBCtrls | Vcl.DBCtrls |
Description
TNavigateBtn defines values identifying different possible buttons on a TDBNavigator object.
Each TNavigateBtn value identifies a different button that can appear on a TDBNavigator object. The following table lists all the button types, their corresponding TNavigateBtn values, and the action associated with each button:
Value | Button | Purpose |
---|---|---|
nbFirst |
First |
Sets the current record to the first record in the dataset, disables the First and Prior buttons, and enables the Next and Last buttons if they are disabled. |
nbPrior |
Prior |
Sets the current record to the previous record and enables the Last and Next buttons if they are disabled. |
nbNext |
Next |
Sets the current record to the next record and enables the First and Prior buttons if they are disabled. |
nbLast |
Last |
Sets the current record to the last record in the dataset, disables the Last and Next buttons, and enables the First and Prior buttons if they are disabled. |
nbInsert |
Insert |
Inserts a new record before the current record and sets the dataset into Insert and Edit states. |
nbDelete |
Delete |
Deletes the current record and makes the next record the current record. |
nbEdit |
Edit |
Puts the dataset into Edit state so that the current record can be modified. |
nbPost |
Post |
Writes changes in the current record to the database. |
nbCancel |
Cancel |
Cancels edits to the current record, restores the record display to its condition prior to editing, and turns off Insert and Edit states if they are active. |
nbRefresh |
Refresh |
Refreshes the buffered data in the associated dataset. |
nbApplyUpdates |
ApplyUpdates |
Writes changes for all the changed records (inserted, deleted or edited) to the database. |
nbCancelUpdates |
CancelUpdates |
Cancels edits for all edited records, restores the record display to its condition prior to editing, and turns off Insert and Edit. |