Purpose

.StartNavigationField specifies where the cursor is placed when you enter a Paging Cycle in Change mode.

Syntax

Setting:            ObjectReference.StartInNavigation = Value

Retrieving:       Variable = ObjectReference.StartInNavigation
 

Operation

ObjectReference is the Tag Name of the Paging Cycle object. It cannot be a variable and it is case sensitive.
Variable is numeric variable or property statement.
Value is a variable with value of TRUE or 1, FALSE or 0
 

Remarks

This value of this property can be both set and retrieved.

When you enter a Paging Cycle in Change mode, the cursor is placed in the editable field of the current record, which may be determined by the .StartPagingSequence and .CurPagingSequence properties, or in the navigation field of the record.

If the value of the property is set to FALSE, or is left unset, the cursor is placed on the first editable field of the current record.

If the value of the property is set to TRUE under the same circumstances, the cursor is placed in the navigation field of the current record.

This property applies to the specified Paging Cycle, and once set it remains in place until a new value is set for this property. The property is only valid in Change mode.
 

Example

To place the cursor in the navigation field of the current record in a Paging Cycle called "OrderScreen":

OrderScreen.StartInNavigation = TRUE
 

To place the cursor in the first editable field of the current record in a Paging Cycle called "OrderScreen":

OrderScreen.StartInNavigation = FALSE

To retrieve the value (either 0 or 1) of OrderScreen.StartNavigation

#STARTINNAV = OrderScreen.StartInNavigation