Navigation: ABC Library Reference > WindowManager > WindowManager Methods >====== WindowManager Functional Organization–Expected Use  ====== |    |
As an aid to understanding the WindowManager, it is useful to organize its various 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 WindowManager 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:
| Run (v) | run this procedure | |
| Init (v) | initialize the WindowManager object | |
| AddHistoryField | add restorable control and field | |
| AddHistoryFile | add restorable history file | |
| AddItem | program the WindowManager object | |
| AddUpdateFile | register batch add files | |
| Kill (v) | shut down the WindowManager object |
Mainstream Use:
None
Occasional Use:
| Run (v) | run another procedure | |
| SaveHistory | save history fields for later restoration | |
| PostCompleted | a virtual to prime fields |
(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.
| Init | initialize the WindowManager object | |
| Ask | display window and process its events | |
| Kill | shut down the WindowManager object | |
| Open | a virtual to execute on EVENT:OpenWindow | |
| PrimeFields | a virtual to prime fields | |
| PrimeUpdate | update or prepare for update | |
| Reset | reset the window and registered items | |
| RestoreField | restore field to last saved value | |
| Run | run this procedure or another procedure | |
| SetAlerts | alert window control keystrokes | |
| SetResponse | OK or Cancel the window | |
| TakeAccepted | a virtual to process EVENT:Accepted | |
| TakeCompleted | a virtual to complete an update form | |
| TakeCloseEvent | a virtual to Cancel the window | |
| TakeEvent | a virtual to process all events | |
| TakeFieldEvent | a virtual to process field events | |
| TakeNewSelection | a virtual to process EVENT:NewSelection | |
| TakeRejected | a virtual to process EVENT:Rejected | |
| TakeSelected | a virtual to process EVENT:Selected | |
| TakeWindowEvent | a virtual to process non-field events | |
| Update | prepare records for writing to disk |