Purpose

.NoClearOnAdd allows you to specify the screen clearing mode when adding or inserting records in a Paging Cycle.
 

Syntax

ObjectReference.NoClearOnAdd = Value
 

Operation

ObjectReference is the Tag Name of the object
Value is the no clear setting (TRUE or 1, FALSE or 0)
 

Remarks

The value of this property can only be set, not retrieved.  It can be set either as the default value during Screen Definition or in Function In logic.

Add Mode

If this property is set to FALSE , the classic behaviour of clearing the screen and starting the first new record at the top of the Paging Record is seen.

If this property is set to TRUE , the last few records in the file will be displayed in the top half of the Paging Cycle, and new records will be added in the bottom half.  As the page fills, and a new page is needed, the last set of new (added) records is shifted to the top of the Paging Area, and adding continues in the bottom half.

If Add mode is selected when the last record in the file is already displayed, any empty records will be filled before re-displaying the page.

If the screen has an odd number of rows, the number of existing records displayed is rounded down, so as to provide more space for new records.

Insert Mode

The screen is cleared below the input position.  When new record entry fills the page, the page is cleared, and records re-displayed using the same algorithm as for Add mode.
 

Example

Setting .NoClearOnAdd in a Paging Cycle whose Tag Name is OrderScreen:

OrderScreen.NoClearOnAdd = True