The Field_GetRequiredStatus() function ascertains the current status of the Show Required Fields menu item. If the item is checked, required fields are being displayed.
The boolean value denotes the status of the Show Required Fields menu item. When the Show Required Fields menu item is checked, the prompts linked to required fields in a window will be displayed as defined by the Field_SetRequiredFormat() function.
This function can be used in the Main Menu post script to ascertain whether the Show Required Fields menu item was checked, so that the information can be saved in a user preferences table.