Data.DB.TDataSet.Cancel

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

procedure Cancel; virtual;

C++

virtual void __fastcall Cancel();

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet

説明

Cancel は,アクティブレコードに対する変更がまだ登録されていない場合,その変更を取り消します。

Cancel メソッドを呼び出すと,アクティブレコードに属する 1 つまたは複数の項目に対して加えられた変更を取り消すことができます。変更がまだ登録されていないければ,Cancel はそのレコードを以前の状態に戻し,データセットの State プロパティを dsBrowse に設定します。

一般に Cancel は,ユーザーの要求に応答して変更を取り消したり,不正な項目値を取り消す項目検証ルーチンで変更を取り消したりするときに使用します。TDBNavigator オブジェクトには,Cancel メソッドを呼び出す Cancel ボタンがあります。

メモ:  データセットが編集状態(dsEdit または dsInsert)になっていない場合,Cancel は何もしません。

関連項目