ComponentOne True DataControl 8.0

GetBookmarkName Event

Occurs when Bookmarks Dialog is being opened. Allows you to specify the current bookmark name.

Syntax

TData_GetBookmarkName (BookmarkName As String)

Remarks

Arguments: BookmarkName is a string variable. It can be set to the name you want to assign to the current row bookmark.

The GetBookmarkName event is fired before opening the Bookmarks Dialog. The purpose of this event is to make bookmark names appear automatically, so the end-user won't have to enter a name for each bookmark manually. If you prefer to leave naming bookmarks to the end-user, don’t implement this event.

Setting the BookmarkName argument to a string makes that string appear as the default bookmark name for the current row. The end-user is still allowed to change this name in the Bookmarks dialog.

Usually, you will find useful to set it to the value of a recordset field that allows the user to identify the record. For example,

Private Sub TData1_GetBookmarkName(BookmarkName As String)

BookmarkName = TData1("LastName")

End Sub

For more information, see Bookmarks Dialog.

See Also

TData Control