AddResetField (set a field to monitor for changes)

Top  Previous  Next

 

AddResetField( resetfield )

AddResetField

Specifies a field that resets the browse list when the contents of the field changes.

resetfield

The label of the field to monitor for changes.

For the active sort order (defined by the preceding call to the AddSortOrder or SetSort method), the AddResetField method specifies a field that the browse object monitors for changes, then, when the contents of the field changes, refreshes the browse list. Typically, you call the AddResetField method immediately after the AddSortOrder method.

You may call AddResetField multiple times to establish multiple reset fields for a sort order.

Implementation:

The specified resetfield is sort order specific--it is enabled only when the associated sort order is active. The SetSort method sets the active sort order for the browse. SetSort also calls ApplyRange to monitor the reset fields for changes and SetSort resets the browse when a change occurs.

The WindowManager.Reset method also initiates an evaluation of the reset fields and a subsequent browse reset if needed for any browse objects registered with the WindowManager.

Example:

BrowseSt.AddSortOrder(BrowseSt:Step,StFile:ByCode)  !add sort order

BrowseSt.AddLocator(BrowseSt:Locator)         !and associated locator

BrowseSt.AddResetField(Local:StFilter)        !and associated reset field

See Also:     AddSortOrder, SetSort, WindowManager.Reset