Navigation: ABC Library Reference > ToolbarClass > ToolbarClass Methods >====== ToolbarClass Functional Organization–Expected Use  ====== |    |
As an aid to understanding the ToolbarClass, 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 ToolbarClass methods.
Non-Virtual Methods
The Non-Virtual Methods, which you are likely to call fairly routinely from your program, can be further divided into two categories:
Housekeeping (one-time) Use:
| Init | initialize the ToolbarClass object |
| AddTarget | register toolbar driven entity |
| Kill (v) | shut down the ToolbarClass object |
Mainstream Use:
| SetTarget | set active target & appropriate toolbar state |
| TakeEvent (v) | process toolbar event for active target |
Occasional Use:
| DisplayButtons (v) | enable appropriate toolbar buttons |
(v) These methods are also Virtual.
Virtual Methods
Typically you will not call these methods directly–other base class 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.
| DisplayButtons | enable appropriate toolbar buttons |
| TakeEvent | process toolbar event for active target |
| Kill | shut down the ToolbarClass object |