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

NAMESYNOPSISsm_aprotect - protect an array#include "smdefs.h"int sm_aprotect (field_number, mask)int field_number;int mask;DESCRIPTIONsm_aprotect sets protection bits for every field in the array containingfield_number. The fields are then protected from some combination of data entry,tabbing into, clearing, or validation, according to mask. If the field isscrolling, all offscreen items are protected as well.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_aunprotect clears protection for an array. sm_protect and variants 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_aprotect (field_name, mask);sm_aunprotect(field_number, mask);sm_1protect(field_number, mask);sm_protect(field_number, mask);#include "smdefs.h"/* Postpone calculations by protecting the totals column from* validation; this will prevent execution of its math edit. */sm_n_aprotect ("subtotals", VPROTECT);