FHSWADRS - Form for Address Record Display/Update

---

This is the form that is displayed when you click the "Res" button on form FHSWUPDT or FHSWSPSE, or the "Address" button on FHSWMISC.

The form consists of three parts: An area for displaying or entering address record information at the top of the form, a "navigation" area containing four buttons for moving backward and forward through multiple addresses in the upper right part of the form, and a line of command buttons at the bottom. The address record viewing area is similar to the one that has been used in earlier versions of FHS. When entering information into a new address record or updating an existing record, date fields are treated as "Masked" fields in which the formatting characters in the date do not have to be entered. Only the numbers in the month, day and year portions of the date must be entered. The fields shown, and the length of information that can be entered into the text fields, varies according to the style of address record that is being kept. "Long" addresses will include a "Country" field

The "Navigation" portion of the form shows the number of the currently displayed address record among all address records for the individual, family or "miscellaneous information" record. They are numbered chronologically, though records are stored from most recent to least recent in the file and the most recent address record will be the one displayed when the form first appears. Buttons labeled "<-" and "->" can be used to move to the next earlier or later record if there are multiple addresses. The button labeled "<<" will move to the earliest address and the button labeled ">>" will move to the most recent address.

The bottom line of the form has several "command buttons". These serve the same purpose as the "Function Key" options in earlier versions of FHS. The command options as identified by the caption on the button are:

• Update - which replaces the command buttons with another set of buttons with the labels:
  • Change - which allows you to make changes to the currently displayed address record
  • Add - which allows you to enter information into a new address record
  • Delete - which allows you to delete the current address record (you will be prompted to confirm the deletion of the record)
  • Cancel - which restores the Main Command Line
• Notes - which opens form FHSWNOTE for displaying/updating/entering descriptive text about the address;
• Return - which closes form FHSWADRS, returning control to the calling form

While information for an existing or new address record is being entered, the command line consists of three buttons with captions:

• Save - which will write the changed information to the family file and restore the main command line
• Cancel - which will terminate the update of the address record and redisplay the previous information; if there are no existing address records, the form is closed and control is returned to the calling form (Note: pressing the ESCape key has the same effect as clicking the Cancel button); and
• Restore - which will restore the contents of the field containing the cursor to the value that it had before the update of the (existing or new) record began.

If there are no addresses for the individual or family at the time that the form is selected for showing address information, it will automatically be set up to enter a new (first) address record. Also, if the last of the existing address records is deleted, the form will again be set up to enter a new address record.