home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 17
/
CD_ASCQ_17_101194.iso
/
vrac
/
ptgenr2.zip
/
PTG_REF.DOC
< prev
next >
Wrap
Text File
|
1994-08-01
|
51KB
|
2,069 lines
C O N T E N T S
───────────────────────────────────────────────────────────────────────────────
Introduction 1 Chapter 7 Commands 19
What's in this manual ................. 1
Chapter 8 HelpTexts 21
Chapter 1 The Application object 3 Helpconstants ........................ 21
Creating a new application............. 3 Statusline helptext ....................21
Loading an application ................ 3 HelpWindow text..................... 22
Application configuration.............. 3 Help dialog box ...................... 22
Editing an application ................. 4
Chapter 9 The Objects Dialog box 23
Saving an application ................. 4
Creating objects ......................23
Chapter 2 The Menubar object 5 Editing objects ....................... 23
Editing the menubar .................. 5 Deleting objects ...................... 24
Creating a Seperator ................ 5 Cloning objects ....................... 24
Creating a Submenu ................ 5
Appendix A The Files created by
Creating a Menu entry .............. 5
PtGen 25
Editing menuitems.................. 6
The Source File ....................... 25
Deleting menuitems................. 6
DEFINES.DEF........................ 25
The Menu local menu ................. 6
STRRESFS.TVR....................... 26
Lines................................ 6
STRINGS.TVR ....................... 26
Creating Links ..................... 6
STRINGS.INC........................ 26
Deleting Links...................... 6
PTGRES.INC......................... 27
Chapter 3 The StatusLine object 7 .LOG............................... 27
Chapter 4 The DeskTop object 9 Appendix B PtGen Techical
Desktop Local Menu .................. 9 Information 29
Chapter 5 The Dialog box object 11 Appendix C Error codes 31
The Dialog Local Menu................ 11
Appendix D File list 33
Dialog settings ....................... 11
The Dialog subviews .................. 12
Button............................. 12
Static text ..........................12
Label.............................. 12
Inputline .......................... 13
Memo ............................. 13
Checkboxes ........................ 13
Radiobuttons....................... 13
Spinbuttons ........................ 14
ListViewer ......................... 14
Moving and Resizing subviews......... 14
Changing the Tab-order of the subviews . 14
Creating a record ..................... 15
Code button ......................... 15
Chapter 6 The Popup menu object 17
i
ii
I N T R O D U C T I O N
───────────────────────────────────────────────────────────────────────────────
This manual is a reference guide for PtGen, the TurboVision
application generator. This manual describes all the objects PtGen
can create, their attributes and the operations on that objects. See
the user's manual for a description how to use PtGen.
What's in this manual
───────────────────────────────────────────────────────────────────────────────
This manual has six reference chapters and four appendixes.
Chapter 1: The Application object describes the application
PtGen creates.
Chapter 2: The Menubar object describes how to build a
menubar.
Appendix C: Error codes lists most of the error codes PtGen can
create.
Introduction 1
2 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
1
The Application object
PtGen is application oriented, that it: it assumes that you develop
complete applications with PtGen. Although it is possible just to
use the dialog box editing features alone, you won't take full
advantage of PtGen possibilities.
This chapter discusses the application object and its properties.
Creating a new application
───────────────────────────────────────────────────────────────────────────────
If you want to create a new application, select File |New from the
menubar. The application configuration dialog box pops up. See
the section about Application configuration for further details.
Next you can edit your application.
Loading an application
───────────────────────────────────────────────────────────────────────────────
Select File |Open to load a previous saved application. From the
File dialog box choose the file with the application you want to
load.
Application configuration
───────────────────────────────────────────────────────────────────────────────
For every application you have to specify:
1. Its name. PtGen will automatically prefix the name (and any
name) with a 'T'
2. The language to use: English or Dutch.
3. If it uses a helpfile and if yes, the name of the ascii version of
that helpfile. Do not specify the TVHC compiled file, with
extension .HLP, but the text file, usually .TXT.
Chapter 1, The Application object 3
4. If it uses the editor. If yes, than the commands from
EDITORS.PAS are added to the standard available commands
which can be used when creating menus. The added
commands are cmNew, cmOpen, cmSave, cmSaveAs, cmPrint
The background printing option is not available in public releases.
That option is for use within NederWare only.
Editing an application
───────────────────────────────────────────────────────────────────────────────
Press Ctrl+F8 (Edit) or select Edit from the menubar to edit your
application. You can now edit the menubar (see chapter Object
MenuBar) and statusline (see chapter Object Statusline) and create
various objects (see chapter Creating Objects).
After you have edited an application, pressing Alt+X (Exit) brings
you back in PtGen. You can now save your application, see
chapter Saving an application.
Saving an application
───────────────────────────────────────────────────────────────────────────────
Select File |Save or File |Save as to save your application. If you
don't specify an extension, .PAS will be added.
4 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
2
The Menubar object
PtGen allows you to quickly define menuitems. The parameters
you can give to a menuitem are the same as the TMenuItem type,
which is described in the Turbo Vision manual plus some more.
The following sections describe the various menuitems you can
create. See the section Creating Links to read about linking an
object to a certain menuitem.
Editing the menubar
───────────────────────────────────────────────────────────────────────────────
In this section the creation, editing and deleting of menuitems is
treated.
───────────────────────────────────────────────────────────────────────
Creating a
Select the menubar and press Ins. Leave the popped up dialog box
Seperator
blank by pressing Enter. A selectable line appears, indicating the
line your users will see.
The reason that you do not get the normal line as you would
expect is that such lines are not selectable so you won't be able to
delete such lines. When saving your application as source code,
PtGen puts this right.
───────────────────────────────────────────────────────────────────────
Creating a
Select the menubar and press Ins. You create a submenu by only
Submenu
specifying a Name and leave the Command and Param fields
empty. Helptexts can be defined. See chapter Helptexts for a full
explanation.
───────────────────────────────────────────────────────────────────────
Creating a
Select the menubar and press Ins. You must specify a Name and a
Menu entry
Command. The other fields can be empty. To a normal menuitem
code can be linked. This code will be executed when you select
this menuitem. This code is linked to the Command you specify.
PtGen will assign a unique value to every command you will
create. This is different from handcoding Turbo Vision
Chapter 2, The Menubar object 5
applications. You don't have to assign/remember values for your
names nor be aware of them. Just specify a name. You can specify
helptexts if you want. See chapter Helptexts for a full explanation.
───────────────────────────────────────────────────────────────────────
Editing
All menu entries can be edited by selecting them and pressing
menuitems
Ctrl+F8 (Edit).
───────────────────────────────────────────────────────────────────────
Deleting
All menu entries can be deleted by selecting them and pressing Del .
menuitems
There is no mouse equivalent.
The Menu local menu
───────────────────────────────────────────────────────────────────────────────
The menubar or popup has a local menu too. Press Alt+F10 to pop it
up. You can insert some predefined menus as a file menu, edit
menu or window menu. You can also rename the menubar or
popup, or sort its entries.
Lines
───────────────────────────────────────────────────────────────────────────────
Links are certain objects which are activated when you select a
menu item or press a button.
───────────────────────────────────────────────────────────────────────
Creating Links
If you press Ctrl+F9 (Link) the Objects Menu popups up. Select the
kind of object you want to link to this menuitem. This object will
be executed when this menu item is selected. See chapter 9, section
creating objects, for all the objects you can link to a menuitem.
If you specified a new object (for example a Dialog box) you can
edit that object before returning to your menuitem.
───────────────────────────────────────────────────────────────────────
Deleting Links
Pressing Ctrl+F9 (Link) again will delete the link, but the associated
object is not deleted. To delete an object: see chapter Object
DeskTop, section DeskTop Local Menu.
6 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
3
The StatusLine object
Change the global statusline by pressing Alt+F10 (DeskTop Local
Menu) or just clicking on the background with the left mouse
button. Then select Statusline.
■ Mouse users: Use the New, Edit and Delete buttons to insert,
edit and delete statusline items.
■ Keyboard users: You can insert items by pressing Ins, delete
items by pressing Del and edit items by pressing Ctrl+F8 (Edit).
Chapter 3, The StatusLine object 7
8 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
4
The DeskTop object
Desktop Local Menu
───────────────────────────────────────────────────────────────────────────────
Pressing the left mouse button when the mouse cursor is on the
desktop will popup the Desktop Local Menu. From this popup
you can gain acces to the statusline edit dialog box, the Objects
Dialog box, the helptexts menu and the Units Dialog box.
The Reporter menu selection is and will not be not available for
public release.
Chapter 4, The DeskTop object 9
10 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
5
The Dialog box object
Dialog box objects can be created when creating an application. It
is possible to create a standalone dialog box too.
To create a standalone dialog box object choose Dialog |New
from PtGen's main menu. Choose Dialog |Open to read a
previously saved standalone dialog box. After the standalone
dialog box is created, you are prompted to specify a filename to
save the code for this dialog box to.
Dialog box objects for use within a complete application are
created when you select Define |Dialog box from the Available
Objects Popup.
This chapter describes how a dialog box object can be constructed.
The Dialog Local Menu
───────────────────────────────────────────────────────────────────────────────
You can place objects on the dialog box by pressing Alt+F10 (Local
Menu) and selecting an object. Or, for mouse users, click with the
left mouse button on the background in the location where you
want your object to appear. The local menu will popup at that
location.
From this local menu you can either place an object into the dialog
box or acces the settings for this dialog box. See the next sections
for details. If you popped up the local menu with the mouse, after
selecting an object, that object will be put at the position your
mouse was before the dialog box local menu popped up.
Dialog settings
───────────────────────────────────────────────────────────────────────────────
Select settings from the Dialog Local Menu to edit the dialog box.
The same dialog box pops up as when first creating a dialog box.
Chapter 5, The Dialog box object 11
You can change the name of the dialog box, its title and set the
helptexts for this dialog box.
The Dialog subviews
───────────────────────────────────────────────────────────────────────────────
The next sections comment on the objects you can place on a dialog
box. Select the appropriate subview from the Dialog Local Menu to
place that subview on the dialog box. See the section titled Moving
and Resing subviews on how to change the position of a subview.
───────────────────────────────────────────────────────────────────────
Button
Some buttons you use so often that they are predefined. If you
select Button from the Local Menu the first entry is for customized
buttons. The other entries, under the seperator, are predefined
buttons.
For customized buttons you can specify its Title and the Command
it generates when it is selected. You can also specify various
button flags. The default is bfNormal (no options selected) but you
can make a certain button the Default one if you click on the
default option. All bfXXXX constants are supported.
You can create a helpconstant (see the chapter Helptexts, section
helpconstants, you don't have to specify this one), a helptext
which should be displayed on the statusline when this object is
selected, and a window help text which is displayed when a user
presses Help (F1). Helptexts are optional, so you don't have to
specify these three subviews.
───────────────────────────────────────────────────────────────────────
Static text
Select Static Text from the Local Menu and enter the text. Specify
the control characters ÇM (new line) and ÇC (center text) by
entering first a 'Ç' and then a 'M' or 'C'. PtGen replaces them with
the appropriate control characters.
If you leave the text empty and press OK the text view will be
deleted.
───────────────────────────────────────────────────────────────────────
Label
You can place a label only if there is some object/view which can
be labeled. So you insert the view to be labeled first, then the
Label. To create a label Select label from the Dialog Local Menu,
enter some text and next select an object to link to this label by
either using the arrow keys and/or Tab/Shift+Tab or by clicking
on the to-be-labeled view/object with your mouse.
If you leave the label text empty and press OK the label view will
be deleted.
12 PtGen Reference Guide
When you label a view, the record identifier (see the subsection
Creating a record below) will change to the label you specified.
Note that once a label is attached to a view, it can't be attached to
another view. If you want a label to reference another view, first
delete it, then insert a new label with the same name.
───────────────────────────────────────────────────────────────────────
Inputline
The Inputline menu option shows many InputLines. Each of these
has different characteristics. The online help will tell you more. In
this section only the standard InputLine is covered.
After you've selected Inputline, you're prompted to specify the
maximum length of the inputline, if this inputline is selectable or
not (not selectable inputlines can be used to display information a
user may not change) and if you want to validate the contents of
the inputline before the inputline looses its focus.
If you want to use a validator for this inputline select the validator
you want from the SpinButtons. Press Ctrl+F8 (Edit) to edit the
validator if the Validator spinbuttons are selected. You can specify
the parameters for the validator and (optionally) the string
resource identifer which this identifier should use when Error is
called. If you don't specify an identifier the default sFilterError,
sRangeError, sRealError and sPictureError are used for
TFilterValidator, TRangeValidator, TRealValidator and
TPXPictureValidator respectively.
You can also specify the usual helpconstant (see the section
helpconstants in the chapter about helptexts, you don't have to
specify one), the helptext which should be displayed on the
statusline when this object is selected and the help window text
which should be displayed when a user presses Help (F1). The last
three items don't have to be specified.
───────────────────────────────────────────────────────────────────────
Memo
The Memo view is the TMemo object as found in the EDITORS.PAS
unit. You can specify the same parameters as with InputLine
except that you can specify a Horizontal or Vertical ScrollBar too.
───────────────────────────────────────────────────────────────────────
Checkboxes
After selecting checkboxes you have to specify a list of strings. In
the dialog box you will see, press Ins to insert an item, Del to
delete one and Ctrl+F8 to edit an item.
For every text you can specify a different statusline helptext.
───────────────────────────────────────────────────────────────────────
Radiobuttons
See Checkboxes.
Chapter 5, The Dialog box object 13
───────────────────────────────────────────────────────────────────────
Spinbuttons
Spinbuttons are one line radiobuttons. Press left or right to change
to display a different text in a spinbutton. See Checkboxes for how
to enter a list of strings for Spinbuttons.
───────────────────────────────────────────────────────────────────────
ListViewer
A dummy ListViewer object is placed on the dialog box. This
object is only for layout. Press the code button to specify the
descendent of ListViewer which you want to insert in the dialog
box.
Moving and Resizing subviews
───────────────────────────────────────────────────────────────────────────────
The subviews in a dialog box can be moved and resized. Keyboard
users should press Shift+F5 (Local resize) to move and resize the
currently selected subview.
If you want to center the subview horizontally or vertically press
Alt+F5 to popup the Keyboard positioning menu and choose
X-Center of Y-Center respectivily.
Mouse users should press the Right mouse button on the to be
resized subview and hold that button down. The Mouse Local
Popup pops up. Choose Move or Resize to move or resize the
subview.
If you want to center the subview horizontally or vertically choose
X- Center of Y-Center respectivily from the Mouse Local Popup.
You can also move multiple views at one. Hold down the right
mouse button on an empty area and move the mouse to the right
and down to let a rectangle grow. Every view covered completely
or partially by this rectangle can be moved if you release the
button.
If you press Del, all these views are deleted.
Changing the Tab-order of the subviews
───────────────────────────────────────────────────────────────────────────────
The Tab-order or Z-order of the subviews can be changed.
Keyboard users should press Alt+F5 to popup the Keyboard
Position menu. Choose First to make this subview the first view in
the dialog box. Choose Next when you want to specify the next
subview from this subview. After choosing Next you should select
the subview that should be the next one by tabbing to that
subview and pressing Enter.
14 PtGen Reference Guide
Mouse users should press the Right mouse button on the to be
repositioned subview and hold that button down. The Mouse
Local Popup pops up. Choose now First to make this subview the
first view in the Tab-order sequence. Choose Next to specify the
next subview after this one. If you choose Next you can now select
the subvew that should be the next one by clicking on it with
either mouse button.
REMARK 1: Esc cancels the operation of choosing the next
subview for both mouse and keyboard users.
REMARK 2: Labels can't be repositioned. They insert themselves
always after their link, so you don't have to worry about them.
Creating a record
───────────────────────────────────────────────────────────────────────────────
For each dialog box a record can be created. Enable the Record
option in the dialog settings dialog box (popup the Dialog Local
Menu and select settings). The created record will have the name
of the dialog box prefixed by 'T' and suffixed by 'Rec'.
Each subview (except of course subviews like TStaticText) has its
own entry in the record for the dialog box. Each subview defaults
to some suitable variable name and type.
The variable will be equal to the label of that subview. If the
subview has no label you have to manually specify the variable
name.
To change the record entry of a subview, see the section Code
button below.
Code button
───────────────────────────────────────────────────────────────────────────────
Most subview dialog boxes have a Code button. PtGen lets you
change the generated code. The Code Dialog box shows you the
variable the allocated subview is assigned to (usually P), which
subview to allocate (PInputLine for example), the parameters for
this subview (except R, the first parameter which can't be
changed), and the entry in the record for this dialog box.
You can change the variable name and the type of the variable.
Chapter 5, The Dialog box object 15
16 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
6
The Popup menu object
The popup object can be edited in the same way as the menubar
object. See chapter Menubar for all the details on editing.
Press Ctrl+F5 (Resize) to move the popup to a different location.
Press Alt+F10 (Local Menu) to change the name of this popup.
Chapter 6, The Popup menu object 17
18 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
7
Commands
PtGen assigns numbers to the commands you specify when
creating or editing menuitems, statusbaritems and dialogbuttons.
They range from 2000..2999. Their number is not important and
can change. So refer not to the number but to the command itself
as usual in Turbo Vision programming.
Chapter 7, Commands 19
20 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
8
HelpTexts
There are three things of interest when discussing helptext within
PtGen:
1. hcConstant, the identifier name of a certain helptext
2. Statusline helptext, the text which will appear on the statusline
when this context is selected
3. HelpWindow text, the help text that will appear when you
press F1.
All three types of information are discussed below.
Helpconstants
───────────────────────────────────────────────────────────────────────────────
PtGen assigns numbers to the helptexts you create. Numbers
range from 2000..2999. They are not static but change whenever
needed. If you have to refer to a helpconstant specify a name in
the hcConstant field. When PtGen writes the text file to be
compiled with TVHC, a proceeding 'hc' if any will be stripped,
because TVHC will output a .PAS file with the names you specify
prefixed with `hc'.
For menuitems the default hcConstant is equal to the specified
command except that the preceeding `cm' is replaced by 'hc'. So if
the command in your menuitem was cmFile the hcConstant will
be hcFile.
All hcConstants are listed in the interface section of the unit PtGen
creates.
Statusline helptext
───────────────────────────────────────────────────────────────────────────────
All the helptext which you've specified are saved in the string
resource file STRINGS.TVR. The Hint method of the PtGen created
Chapter 8, HelpTexts 21
statusline object uses the current HelpCtx to search and displays
the text in STRINGS.TVR.
HelpWindow text
───────────────────────────────────────────────────────────────────────────────
If you want to use HelpWindows you have enable the option in
the Options section of the Application settings dialog box. You can
change the settings of your application by selecting App from the
menubar. You also have to specify a helpfile which will be used to
save the HelpWindow text in.
This helpfile is a plain ascii text file, formatted in topics, that you
can edit yourself. You can even add text by hand to this file
although you might find the Help dialog box more convenient to
do this.
To convert the helptexts in this file to a .HLP file you need TVHC,
the helpfile compiler that came with your package.
Help dialog box
───────────────────────────────────────────────────────────────────────────────
The Help dialog box can be accessed by popping up the Desktop
Local Menu and selecting Helptext. The Helptext dialog box
comes up. You can now add, edit or delete helptexts. You can even
change the values PtGen has assigned although this is not
recommended. If you change a value to an already existing one,
your input is ignored.
If you delete a helptext that is used by PtGen (numbers 2000..2999)
and that helptext is still used by a certain view be aware that PtGen
will complain about this when you for example acces that view or
write it to disk. Doing this is therefore not recommended too.
From this dialog box you can also compile the help texts you
entered, so you don't need to run TVHC. Press the Compile to
compile the helptexts. If there are errors, the compilation process
will halt and an error will be displayed.
22 PtGen Reference Guide
C H A P T E R
───────────────────────────────────────────────────────────────────────────────
9
The Objects Dialog box
The Objects Dialog box appears when you select Objects from the
See chapter 4 for more Desktop Local Menu. Press the left mouse button on the desktop
information about the to popup the Desktop Local Menu or press Alt+F10 (Desktop Local
desktop and the desktop Menu) when there are no other objects on the desktop.
local menu
The Objects Dialog box shows you all the previously created
objects. From this dialog box you can create new objects or edit,
delete or clone existing objects.
Creating objects
───────────────────────────────────────────────────────────────────────────────
You always create objects by selecting an object type from the
Available Objects Popup. This popup can appear in two ways:
when you press Ctrl+F9 (Link) to link an object to a menuitem or
button, or when you press the New button from the Objects Dialog
Box. Anyway, all objects you create will appear in the Objects
Dialog Box where they are available for editing and deleting.
When the Available Objects Popup has appeared you can select
between predefined and user defined objects.
The predefined objects are: calculator, change directory dialog box
and editor. (REMARK: not all predefined objects may currently be
implemented or included).
The user defined objects are: dialog box, menubar, popup menu
and user code. See the chapters Dialog box and Popup for details
about the dialog box and popup..
Editing objects
───────────────────────────────────────────────────────────────────────────────
Select an object and press the Edit button to edit it. You an also
press the right mouse button on a visible object to edit it. Keyboard
users may press Ctrl+F8 (Edit) to edit the currently selected object.
Chapter 9, The Objects Dialog box 23
Deleting objects
───────────────────────────────────────────────────────────────────────────────
Select an object and press Del button to delete it. You're asked for
confirmation, just to be sure.
Cloning objects
───────────────────────────────────────────────────────────────────────────────
Select the object to be cloned and press Clone. Currently only
dialog boxes can be cloned. Every attribute of the subviews in the
dialog box is cloned.
24 PtGen Reference Guide
A P P E N D I X
───────────────────────────────────────────────────────────────────────────────
A
The Files created by PtGen
In this section all files that PtGen creates are described.
The Source File
───────────────────────────────────────────────────────────────────────────────
As already said, PtGen creates normally, compilable Turbo Pascal
source code. PtGen can read that source code back if you want to
re-edit or change the created menubar, statuslines, dialog boxes or
helptexts.
The form of the source code is a unit which you can use in your
program. The main object defined in this unit is a descendent of
TPreApp, which is a descendent of TApplication. The Application
object PtGen creates does not descent directly from TApplication
in this way. The parent object is TPreApp, which is defined in
PREAPP.PAS This allows you to place common code for your
objects in PREAPP.PAS.
DEFINES.DEF
───────────────────────────────────────────────────────────────────────────────
Besides this source code file, PtGen creates several other files. The
first file to mention is DEFINES.DEF. PREAPP.PAS is also used to
define the conditional code, code that the applications you create
may need. For example if you specified that you want to create
online help a special file with directives is created which in turn
enables certain parts in PREAPP.PAS to be compiled.
The file in which the directives are placed is called DEFINES.DEF.
This file is included with $I into PREAPP.PAS. Because the
compilation of PREAPP.PAS is application dependent, it is
recommended that for every application you create, a separate
directory is created to which PREAPP.PAS (and PREAPP.INC) are
copied.
Appendix A, The Files created by PtGen 25
The possible conditional symbols that can be created in
DEFINES.DEF are:
■ {$DEFINE Help} When you specified that you wanted to use
the Help Window Option (Note that the context-sensitive
statusline help can always be used.) If you enabled this option
you can create help windows, including cross-references, much
like the online Help of TP7.
■ {$DEFINE Editors} if you specified that you wanted to make
use of the Editors unit in your program.
■ {$DEFINE BufferedPrinter} if you specified that you
wanted to use the background printing unit.
STRRESFS.TVR
───────────────────────────────────────────────────────────────────────────────
PtGen lets you use various string resources for your application. If
you have defined seperate string resources for one or for a cluster
of releated units, you can add such string resources to your
application. When writing the source file for your application all
string resource files and identifier files are read and put in one file,
called STRINGS.TVR (see below). PtGen stores the filenames of all
these string resource files and identifier files in STRRESFS.TVR.
This file is only created if you have specified string resources
above the standard one (see STRINGS.TVR).
STRINGS.TVR
───────────────────────────────────────────────────────────────────────────────
After you have specified which string resources to use, they
should be accumulated in one file. That file is called
STRINGS.TVR. All statusline helpstrings and all language
dependent strings (in ENGLISH.TVR, DUTCH.TVR or other) are
saved in STRINGS.TVR. If you specified other string resources in
STRRESFS.TVR they will be saved to STRINGS.TVR too.
The BBSTRRES unit gives you easy acces to strings stored in this
file.
STRINGS.INC
───────────────────────────────────────────────────────────────────────────────
In STRINGS.INC all resource string identifiers are accumulated for
this application. STRINGS.INC should correspondent with
STRINGS.TVR
26 PtGen Reference Guide
PTGRES.INC
───────────────────────────────────────────────────────────────────────────────
PTGRES.INC is an include file for a resource file creating program.
See the user's manual for how to turn PtGen's Pascal code into a
resource file.
.LOG
───────────────────────────────────────────────────────────────────────────────
PtGen creates a log file called PTGEN.LOG. You can remove this
file anytime you wish.
Appendix A, The Files created by PtGen 27
28 PtGen Reference Guide
A P P E N D I X
───────────────────────────────────────────────────────────────────────────────
B
PtGen Techical Information
This chapter contains information about PtGen internals,
especially about the source file it outputs.
When you view the source file PtGen creates, you will frequently
see the {@#..#@} structure. The information inside this comment
is used by PtGen to speed up file reading and to distinguish
between certain parts of the created application.
You can edit the source file PtGen creates, but you should conform
to the format PtGen outputs and expects when reading such a file.
If you want to change code parts, copy them to a unit or program
of your own and change them there. Leave the PtGen created code
intact.
Appendix B, PtGen Techical Information 29
30 PtGen Reference Guide
A P P E N D I X
───────────────────────────────────────────────────────────────────────────────
C
Error codes
PtGen will sometimes give strange error messages. Usually the to
be readed file is corrupt or an internal error in PtGen occured.
PtGen does a lot of checking mainly for speeding up development
by catching errors early. They are generally not meaningfull for
ordinary users. Send your log file (PTGERR.LOG) to NederWare if
you think an internal error occured.
Below an alphabetic list of error messages (not yet complete).
Resource file *.TVR could not be found
Check if DEFAULT.TVR, ENGLISH.TVR or DUTCH.TVR can be
found depending on the language you have choosen (Default,
English or Dutch). If DEFAULT.TVR could not be found, you can
copy ENGLISH.TVR or DUTCH.TVR to DEFAULT.TVR.
You can also set the environment variable PTGINPUT to the
directory where these files reside.
Appendix C, Error codes 31
32 PtGen Reference Guide
A P P E N D I X
───────────────────────────────────────────────────────────────────────────────
D
File list
The READ.ME file contains a complete list of the files included on
the distribution diskette. A partial list is included below.
Appendix D, File list 33
Table D.1
Partial file list File name Description
PTGENX.EXE Extended mode version of PtGen (DPMI).
PTGEN.EXE Real mode version of PtGen.
PTGEN.OVR The PtGen overlay file (for real mode version
only).
PTGHELP.HLP Help file.
PTG USER.DOC This manual.
PTG REF.DOC The reference manual.
CHANGES.DOC Overview of latest changes and additions.
READ.ME Latest information and complete list of files in this
distribution.
TUTORIAL.* Texts for the build-in tutorials.
REGISTER.FRM Registration form.
PREAPP.PASDefinition of the application object from which the
PtGen created application object is derived. A
copy of this file is needed for every application.
PREAPP.INC Identifier include file for PREAPP.PAS. Use
PREAPP.INC to change the string resource file
DEFAULT.TVR, ENGLISH.TVR and DUTCH.TVR
DEFAULT.TVR Default language strings for all provided units.
DUTCH.TVR Dutch resource strings for all provided units.
ENGLISH.TVR English resource strings for all provided units.
BBDLG.PAS TVision dialog boxes and views, see the reference
manual or online help for details.
BBFILE.PAS File I/O primitives, see the reference manual or
online help for details.
BBSTRRES.PAS Resource string handling, see the reference
manual or the online help for details.
BBUTIL.PASPrimitives, see the reference manual or online help
for details.
BBVALIDATE Validators, overriding the ones provided in
VALIDATE.PAS. The validators in the Validate
unit gave an english error message. The validators
in this unit do not, but retreive a resource string so
you can internationalize your validation.
PTGEN.TPH Online help which you can include directly in
your Turbo Pascal IDE or Borland Pascal IDE. It
covers all supplied units like BBUTIL and
BBSTRRES.
34