DataBrowser.Clear Method (Typed) | |
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:
XSharp.VO.SDK
Assembly:
XSharp.VOGUIClasses (in XSharp.VOGUIClasses.dll) Version: 2.21
Syntax 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. |
See Also