Vcl.DBCtrls.TNavigateBtn

From RAD Studio API Documentation
Jump to: navigation, search

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.

See Also