Some ActiveX controls in TheRaiser’s Edge are very convenient for displaying certain types of information. For
example, all of the different types of attributes are displayed in a specific control, called the Attributes grid. In
your program, if you need to display a list of attributes, you can use the same control TheRaiser’s Edge
developers use to display attributes.
Data Entry Forms
Because your end-users are already familiar with data entry forms, you can drastically simplify your programming
by using the same forms as those used by TheRaiser’s Edge developers. All the top-level objects have UI forms.
When a form appears, it is fully functional and contains all toolbars and menu bars so end-users can perform the
same operations they normally do within the program.
Showing a Standard Form
You can use many different UI forms in the program. Although different forms may have some different methods
and properties depending on their use, forms do have some things in common.
• They always have an Init method which accepts a SessionContext and a CloseDown method.
• They have a property that accepts a data object that “matches” the form. For example, the
CCampaignForm.CampaignObject needs a CCampaign object. This is important because the UI form needs to
have a reference to a data object so that it can make changes or create a new record based on the actions of the
user. If the data object passed is a new data object, then a new record is created if the user chooses to save
while using the form. If an existing data object is passed, then changes the end-user makes are saved to the
existing record if the end-user chooses to save while using the form. By using the Fields property of the data
object, you can fill in some of the fields on the form before it is displayed to the end-user.
• They always have the ShowForm method. This is what actually displays the form. ShowForm accepts the
following four optional parameters.
Determines whether the form displays modally,
defaults to False.
The UI Form displays itself centered over the form
If set to True, the data object passed to the form is
still initialized and able to used after the user has
closed the form.
This establishes how the “VCR” buttons on the form
function. This is covered in detail in Programming