The
setcapturetype function modifies the
capture type currently associated with a field on a form. The
symbol_name may refer to a field, group, form, or an entire dictionary. The numeric expression
capture_type refers to a capture type code, listed in the table below. If specifying a date, the format can be specified with the optional string expression
date_format.
The function returns the number of items that were successfully changed to the specified capture type. An item's capture type can be successfully changed if the current value set associated with the item supports the requested capture type. For instance, if an item's value set contains ranges, the capture type cannot be changed to a radio button. The success of changing a field to a date picker does not depend on the date format, so if the date format is not valid for the field the capture type will be changed to the default date format for the item.