User Tools

Site Tools


viewmanager_functional_organization_expected_use.htm
Navigation:  ABC Library Reference > ViewManager > ViewManager Methods >====== ViewManager Functional Organization–Expected Use C6H0009.jpg ====== Previous pageReturn to chapter overviewNext page

As an aid to understanding the ViewManager, it is useful to organize its methods into two large categories according to their expected use–the primary interface and the virtual methods. This organization reflects what we believe is typical use of the ViewManager methods.

Non-Virtual Methods

The Non-Virtual Methods, which you are likely to call fairly routinely from your program, can be further divided into three categories:

Housekeeping (one-time) Use:

Init initialize the ViewManager object
AddRange add a range limit to the active sort order
AddSortOrder add a sort order
AppendOrder refine the active sort order
Kill (v) Shut down the ViewManager object

Mainstream Use:

Open (v) open the VIEW
Next (v) get the next element
Previous (v) get the previous element
PrimeRecord prepare a record for adding
ValidateRecord (v) validate the current element
SetFilter (v) specify a filter for the active sort order
SetSort (v) set the active sort order
Close (v) close the VIEW

Occasional Use:

SetOrder (v) replace the active sort order
UseView use LazyOpen files

(v) These methods are also Virtual.

Virtual Methods

Typically, you will not call these methods directly–the Non-Virtual Methods call them. However, we anticipate you will often want to override these methods, and because they are virtual, they are very easy to override. These methods do provide reasonable default behavior in case you do not want to override them.

Open open the VIEW
Next get the next element
Previous get the previous element
Reset reset the VIEW position
SetSort set the active sort order
SetFilter specify a filter for the active sort order
SetOrder replace the active sort order
ApplyFilter range limit and filter the result set
ApplyOrder sort the result set
ApplyRange range limit & filter the result set
ValidateRecord validate the current element
GetFreeElementName return the free element field name
GetFreeElementPosition return the free element field position
Close close the VIEW
Kill shut down the ViewManager object
viewmanager_functional_organization_expected_use.htm.txt · Last modified: 2021/04/15 15:57 by 127.0.0.1