A VCL implementation requires
the use of Borland Delphi
or Builder.
Note, if developing with Delphi 8 and .NET, you will use the WinForm interfaces for clientside development, and WebForm interfaces for serverside development. Refer to the .NET documentation as the Pascal syntax will be the only difference as combared to VB or C# development.
The ProEssentials VCL files
are:
These files are located in
the Delphi and Builder sub-directories.
If using Builder, there are
also some additional files:
|
File Name |
Description |
|
"PEGCPP.CPP" |
Graph |
|
"PESGCPP.CPP" |
Scientific Graph |
|
"PE3DCPP.CPP" |
3D Scientific Graph |
|
"PEPCCPP.CPP" |
Pie Chart |
|
"PEPSCPP.CPP" |
Polar Smith Rose |
Object Model
The VCL interfaces have a simple object model that closely resembles
our DLL interface. Within
the property reference material, at the top of each property topic, you'll
see a table with various property attributes. For
example, the property FontSize has such an entry.
|
Scope |
All ProEssentials Objects. |
|
Type |
Int32 |
|
Default |
PEFS_MEDIUM |
|
.NET |
PeFont.FontSize |
|
Ocx|Vcl |
FontSize |
|
DLL |
PEP_nFONTSIZE |
If developing with either VCL or OCX interfaces, you'll refer to this
property via the OCX|VCL row heading.
For a control named PEGrap1, to programmatically control the FontSize
property within code, you'll write...
|
PEGraph1.Fontsize := gLarge; |
DLL Declarations and Constants
If you need to call ProEssentials DLL functions from within Delphi,
be sure to add "Pegrpapi" to your uses clause.
In Builder, you can include the standard "C" header file "PEGRPAPI.H"
as needed.
Don't use
property windows!
We recommend that you set only a few properties (if any) in the property
window/object browser. This has many advantages: 1) If you have problems,
you can email/fax us your code and we have a record of what properties
you are setting; 2) If you go back to your code a couple months later,
or someone else inherits your project, they have a documented list of
properties you have set; 3) If you ever port your code to another IDE,
its very easy to just reformat your current code; 4) In the case where
a VB or Delphi form-file gets corrupted (this does happen occasionally)
you won't lose your property adjustments; and 5) You will avoid potentially
hard-to-find bugs due to setting a property both in the property window
and in code.
The bottom line is that property windows may seem to be faster, yet,
in the long run, coding your property settings will definitely result
in the safest, and most maintainable implementation.
|