JYACC FORMAKER C Programmer's Guide Contents 1 ... - Prolifics

NAMESYNOPSISsm_aunprotect - unprotect an array#include "smdefs.h"int sm_aunprotect (field_number, mask)int field_number;int mask;DESCRIPTIONsm_aunprotect clears protection bits for every field in the array containingfield_number, and for scrolling items if the array is scrolling. The fields arethen unprotected from some combination of data entry, tabbing into, clearing, orvalidation, according to the mask.Mnemonics for mask are defined in YY, and are listed below. Multiple sets can bedone by oring the mnemonics.MnemonicEPROTECTTPROTECTCPROTECTVPROTECTMeaningprotect from data entryprotect from tabbing into (or fromentering via any other key)protect from clearingprotect from validation routinessm_aprotect sets protection bits. sm_protect and related functions set allprotect bits for a single field. sm_1protect sets protection bits for a singlefield; such changes will supersede the array protection for onscreen elements,but the array protection will remain in effect for offscreen items.RETURNS-1 if the field is not found, 0 otherwise.VARIANTS AND RELATED FUNCTIONSEXAMPLEsm_n_aunprotect (field_name, mask);sm_aprotect(field_number);sm_1unprotect(field_number);sm_unprotect(field_number);#include "smdefs.h"/* open all fields in array number 14 to data entry and clearing */sm_aunprotect (14, EPROTECT | CPROTECT);