Programming Guide

sm_cl_unprot

Clears data from unprotected widgets 

void sm_cl_unprot(void);

Description

sm_cl_unprot erases onscreen and offscreen data from all widgets (with the exception of list boxes) that are unprotected from clearing—that is, their clearing_protect property is set to PV_NO. Date and time fields that take system values are reinitialized. Fields whose null_field property are set to PV_YES are reset to their null indicator values.

This function is normally bound to the CLR key.

To clear data from list box widgets, refer to sm_clear_array.

Example

/* The following code clears all unprotected fields
	 * and puts the cursor into the first one. */

	sm_cl_unprot();
	sm_home();