Click or drag to resize

DataBrowser.Clear Method

X#
If one or more cells in the data browser are selected, clear their contents; if only some characters in a cell are selected, remove only those characters.

Namespace:  VO
Assembly:  VOGUIClasses (in VOGUIClasses.dll) Version: 2.19
Syntax
 VIRTUAL METHOD Clear() AS USUAL
Request Example View Source

Return Value

Type: Usual
Remarks
The current selection can be a few characters in a cell, an entire cell's contents, several cells, several records, or nothing at all.
Tip Tip
Clear() is not allowed if more than one record is selected.
Note that this method changes the fields to which this data browser's cells are linked and, therefore, the changes are subject to validation. The operation leaves the cells blank, but required fields or other validation rules can mark the record as invalid. The operation performed by this method is the same action as is normally performed in standard GUI applications by the Edit Clear menu command (note that under Windows, this menu command is typically linked to the Delete key). This standard behavior is automatically provided by X# and, therefore, there is no need to provide a special method for this (in fact, the Delete key works even if there is no menu command). Systems like spreadsheets (which provide both clear and delete operations) link the Delete key to the Edit Clear menu command, not to the Edit Delete menu command.
Tip Tip
Do not confuse clearing with deleting. Clearing a structure (such as a cell or field) removes its contents. Deleting a structure, on the other hand, removes the actual structure.
See Also