ClearControl

Definition:

ClearControl([control])

 

Description:

Clears the contents of a specified control or all controls.

 

Platforms:

All

 

Parameters:

control - optional

Name of the control you want to clear. If you omit this parameter all controls on the current form will be cleared.

 

Returns:

nothing

 

Notes:

The result of this Method depends upon the type of control:

 

Edit Control, Static Text, Button, Group Box - Blank.

 

Edit Control set to numeric values only - Blank.

 

Combo Box

Dropdown Combo - The Edit Control is set to blank and no item is selected (i.e. the index of the currently selected item is set to -1).

Droplist Combo - Selects the first item in the list.

 

List Box, ListView Control - Selects the first item in the list. Note that this Method doesn't scroll to the top to display the selected item.

 

Radio Button, Check Box - Unchecked.

 

Date Picker - Resets the control to an indeterminate state. The control will change to read Select Date or Select Time as appropriate.

 

Timer - Disabled.

 

Slider Control, Progress Control, Edit Control with spinner enabled - Minimum value.

 

Ink Picture - Ink strokes cleared.

 

Picture & Video Control - Clears the image or video from the control.

 

Other Controls - No action.