| **Navigation:**  [[abc library reference.htm|ABC Library Reference]] > ViewManager > ViewManager Methods >====== ViewManager Functional Organization--Expected Use {{c6h0009.jpg|C6H0009.jpg}} ====== | [[viewmanager methods.htm|{{btn_prev_n.gif|Previous page}}]][[abc library reference.htm|{{btn_home_n.gif|Return to chapter overview}}]][[addrange add a range limit .htm|{{btn_next_n.gif|Next 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 |