Skip to content

Skipfound Field Property

Obsolete

Refer to the Field Options property in the DataDictionary class.

See Also

Purpose

To prevent data entry to an item if the buffer for the database file has an active record in it.

Syntax

set field_options field file.field to dd_skipfound

or

entry_item file.field [
    {skipfound
    [..., option]
    }
]

What It Does

When skipfound is on an entry_item and a record is already in the file buffer (has been found), the cursor skips the item. This enables programs to prohibit changes to certain fields in existing records.

If the buffer for the file is clear (as after the Clear Panel accelerator key has been pressed), the cursor will stop at the item and allow data entry. A subsequent save will create a new record.

entry_item photo.photographer {skipfound}

In this example, the item is skipped when an active record is in the buffer for the database file photo. When no active record is in the buffer, the cursor stops there.

Field properties can be applied directly to fields in DataDictionary objects using the field_options property.

set field_option photo.photographer to dd_skipfound

This example would apply dd_skipfound to every item addressing field photographer in file photo from a DEO using the DataDictionary containing it. This option can be suspended in individual DEOs by provision of an item_options ... skipfound message in them, as:

item_options item 8 skipfound false

This example would suspend dd_skipfound for the ninth item of the DEO containing it.

Notes

  • Skipfound positively prohibits entry to an item when an active record is in the buffer. Users cannot get into the item with the Previous accelerator key when an active record is in the buffer.

  • Skipfound operates according to the state of the Predefined Indicator found. It skips when found is true.

  • Noenter is a similar field property. However, it skips the item in all cases, regardless of whether an active record is in the buffer.