Purpose

.CurPagingSequence allows you to specify or retrieve the currently selected Paging Sequence record number in a Paging Cycle.
 

Syntax

Setting:             ObjectReference.CurPagingSequence= Value

Retrieving:         Variable = ObjectReference.CurPagingSequence
 

Operation

ObjectReference is the Tag Name of the Paging Cycle object
Value is a numeric variable with value of 1 or greater
Variable is a numeric variable
 

Remarks

Retrieving the value of this property will retrieve the value in @PSEQ, the Paging Sequence record number in the Paging Cycle.

Setting this property will select the corresponding record, and a subsequent inquiry on @PSEQ will return the same value.

This property can be used in any logic.  It should be set prior to entering the Paging Cycle, where it will take effect, or it can be used just prior to explicitly refreshing the screen by using the RefreshPage() method.

If the initial display of the Paging Cycle does not include the record specified, the value will be ignored and cleared.  If there is a value set in the property when you enter ADD mode, it will be ignored and cleared.

Once the value has been used to select a record, the value of the property will be cleared.  Therefore if you set the property value and, in the same logic, retrieve the value, the two values will not match because the screen has not yet been repainted.  The RefreshPage() method cannot help, as it can only be executed in File Write No Error logic.
 

Example

To retrieve the Paging Sequence record number of the currently selected record in the Paging Cycle whose Tag Name is "OrderScreen":

#CurOrder = OrderScreen.CurPagingSequence

To set the first Paging Cycle record to be displayed in the same screen before the screen has been displayed:

OrderScreen.CurPagingSequence = #CurOrder