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.21

Syntax

Copy

 VIRTUAL METHOD Clear() AS USUAL

public virtual Usual Clear()

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
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
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.

Reference

DataBrowser Class

VO Namespace