DP Tool Club 17

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