RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TDataSet.FreeBookmark Method

Frees the resources allocated for a specified bookmark.

Pascal
procedure FreeBookmark(Bookmark: TBookmark); virtual;
C++
virtual __fastcall FreeBookmark(TBookmark Bookmark);

Call FreeBookmark to free an existing bookmark before reassigning it. FreeBookmark releases the memory allocated for a specified bookmark when the bookmark is no longer needed.  

Delphi Examples: 

 

{
This example uses a button to copy the value of a field in
the previous record into the corresponding field in the
current record.
}
procedure TForm1.Button1Click(Sender: TObject);
var
   SavePlace: TBookmark;
   PrevValue: Variant;
begin
   with Customers do
   begin
    { get a bookmark so that we can return to the same record }
    SavePlace := GetBookmark;
    try
      { move to prior record}
      FindPrior; 
      { get the value }
      PrevValue := Fields[1].Value;
      {Move back to the bookmark
      this may not be the next record anymore 
      if something else is changing the dataset asynchronously }
      GotoBookmark(SavePlace);
      { Set the value }
      Edit;
      Fields[1].Value := PrevValue;
      { Free the bookmark }
    finally
      FreeBookmark(SavePlace);
    end;
  end;
end;

{
To ensure that the button is disabled when there is no
previous record, the OnDataChange event of the DataSource
detects when the user moves to the beginning of file (BOF
property becomes true), and disables the button.  Detection
occurs on scrolling and editing, not selection with the mouse.
} 
procedure TForm1.DS2DataChange(Sender: TObject; Field: TField);
begin
  if Customers.Bof then
    Button1.Enabled := False
  else
    Button1.Enabled := True;
end;

 

Bookmark 

GetBookmark 

GotoBookmark 

Marking and Returning to Records

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!