EIPManagerClass - Functional Organization - Expected Use


Top  Previous  Next

As an aid to understanding the EIPManagerClass, 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 EIPManagerClass 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

run this procedure

 

InitD

initialize the EditClass object

 

InitControls

initialize edit-in-place controls

 

KillD

shut down the EditClass object

Mainstream Use:

 

TakeEvent (d)

handle events for the edit control

 

TakeNewSelection (d)

handle Event:NewSelection

Occasional Use:

 

AddControl

register edit-in-place controls

 

ClearColumn (v)

reset column property values

 

CreateContol (v)

a virtual to create the edit control

 

GetEdit (v)

identify edit-in-place field

 

Next

get the next edit-in-place field

 

ResetColumn (v)

reset edit-in-place object to selected field

 

SetAlerts (v)

alert appropriate keystrokes for the edit control

 

TakeAction (v)

process end user actions

 

TakeCompleted (v)

process completion of edit

 

TakeFocusLoss (v)

process loss of focus

 

TakeFieldEvent (d)

handle field specific events

(d) These methods are also derived.

(v) These methods are also virtual.

Virtual and Derived 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 either derived or virtual, they are very easy to override. These methods do provide reasonable default behavior in case you do not want to override them.

 

InitD

initialize the EditClass object

 

Kill (d)

shut down the EditClass object

 

TakeEvent (d)

handle events for the edit control

 

TakeNewSelection (d)

handle Event:NewSelection

 

ClearColumn (v)

reset column property values

 

CreateContol (v)

a virtual to create the edit control

 

GetEdit (v)

identify edit-in-place field

 

ResetColumn (v)

reset edit-in-place object to selected field

 

SetAlerts (v)

alert appropriate keystrokes for the edit control

 

TakeAction (v)

process end user actions

 

TakeCompleted (v)

process completion of edit

 

TakeFocusLoss (v)

process loss of focus

 

TakeFieldEvent (d)

handle field specific events