FBHF` Do you really need help ? Files | Save table This Save command saves the current view definition on disk. If the current file definition name is 'UNTITLED.*', it opens a 'Save Table As' dialog to determine the new file name under which will the definition be stored on disk. ) See also: Save table as... , Load table Files | Save table as... This command opens up the Save Table As dialog and lets you save the current view definition table under a different name, in a different directory and/or on a different drive. W The current definition file name displayed in the lower right corner is also updated. " See also: Load table, Save table Files | Load table This command opens up the Load Table dialog where you can locate and select the file you want to open as a view definition table. If there is another definition in memory, TVGen prompts you to save it first. The file must have a pre-defined extension set in the System Options dialog and must be a view definition table. No other file will be loaded into memory. ( See also: Save table, Save table as... Files | Exit This command exits TVGen, removes it from memory and returns you to DOS. If you have modified any file or definition without saving it, TVGen prompts you to do so before exiting. See also: Save table Files | ChangeDir Command ChangeDir changes the current work directory. You cannot change directory when building application. Files | DosShell This command lets you temporarily exit to DOS. The command is not available in real-mode version due to the memory reasons. When shelling to DOS, TVGen saves it's current work directory and restores it after return. Files | About This menu item brings up the 'About' dialog showing copyright and version information. ; Choose CONTINUE button or press Esc key to close the box. Files This menu contains file management and view table commands as loading and saving menu definition tables and exiting TVGen. > Save table Save table as... Load table ChangeDir Shell About Exit Main | Menu Bar This command brings up the Menu Builder dialog, where you can create, modify and try to execute a menu definition. ) See also: Menu Box, Status Line, Dialog Main | Menu Box This command brings up the Menu Builder dialog, where you can create, modify and try to execute a menu definition. ) See also: Menu Bar, Status Line, Dialog Main | Status Line This command brings up the Status Builder dialog, where you can create and modify the status line definition. & See also: Menu Bar, Menu Box, Dialog Main | Dialog This command sets up the Dialog Definition Mode. In this mode you can define dialog size and position, insert subviews into the dialog window, change subview chain order and so on. + See also: Menu Bar, Menu Box, Status Line Main | Close view This command terminates the definition session and disposes the of definition table. If some changes to this table were made, the program prompts you to save it first. 4 See also: Save table, Save table as..., Load table Main | Message Box This command brings up the dialog providing the standard Message Box dialog definition. These dialogs can be used only within snippets. They are not stand-alone objects. " See also: Input Box, Application Main | Input Box This command brings up the dialog providing the standard Input Box dialog definition. These dialogs can be used only within snippets. They are not stand-alone objects. $ See also: Message Box, Application Main | Application This menu item sets up the application builder system. Using this system you can define all objects contained in the application and specify the relations between them using the HandleEvent method. You can write whole parts of procedures and then generate the source for the entire application. Main | Load Picture Using this command you can load any dialog definition table and display the corresponding dialog on the desktop. The table is then released, so only the picture of the dialog remains in memory. It is useful when making a new dialog for an application since it allows you to see how the objects look together. There can be several pictures on the desktop at one time. % Enabled only when building dialogs. See also: Clear Pictures Main | Clear Pictures This command closes all picture dialogs created using Load Picture command in this submenu. . Enabled only when building dialogs or menus. Main This menu contains all the main actions available in TVGen ver. 3.0 " You can do the following things: Define stand-alone objects Menu Menu Status Dialog Define standard MessageBox and InputBox dialogs. < Define entire Application, load and close picture dialogs. There is a command Close view in this menu. It allows you to terminate the view definition session and clear the memory for another actions. Dialog This submenu contains all of the subview classes you can put into the dialog window in the Dialog Definition Mode. These classes are defined in ODF files (See User's guide) Data dialog This dialog is created according to the content of an appropriate ODF file. Here you can specify all parameters needed to build up the new object. The layout of the dialog can be changed from within ODFC compiler. Cluster content dialog This dialog contains the cluster hidden under the button you just pressed. The layout is defined in appropriate ODF file. Snippet list This dialog contains the list of all snippets that can be open for the object. If the snippet is physically defined there is an asterisk icon (*) displayed near the snippet name. Using button New you can create new snippet definition. Tools | Reordering This submenu contains commands for dialog object reordering - both automatic and manual. Tools | Reordering | Horizontal automatic This command automatically changes order of views in the dialog so that the focus moves from one to another row by row. Tool | Reordering | Vertical automatic This command automatically changes order of views in the dialog so that the focus moves from one to another column by column. New snippet Here you can define the parameters of the new snippet - the name (appears in snippet list), the file name (up to eight characters) and the mask. The mask specifies the initial content of the snippet. Dialog | List Boxes Dialog | Clusters Dialog | Clusters | Radio Buttons Dialog | Clusters | Check Boxes Dialog | Clusters | Multi Check Boxes Dialog | Static Texts Dialog | Labels Dialog | Memos Object | Frame Using this command you can insert a frame into the dialog. It is a TView object with set ofFramed bit in Options flag. Frames can be moved and resized like the other subviews. The resizing icon is in the lower-right corner of the frame. x Frames are always inserted at the beginning of the subview queue to ensure that all other objects will appear "above". Object to dialog The command lets you insert the object into the dialog. All parameters are defined in appropriate ODF file, the way the object will be generated is described in its "template". Objects to dialog This submenu contains classes with common ancestor. All object are defined in ODF file. Methods | Init Methods | Done Window | Close all This command closes all open windows. Window | Minimize This menu item minimizes the active edit window. The same function has the icon [ ] in window frame. If the acive window is currently minimized it restores its's original size before minimalization. Methods | GetPalette Methods | SetState Methods | Draw Tools This menu contains some useful tools for dialog building. They are available in Dialog Definition Mode and provide all common actions with objects which have already been inserted into the dialog window: ] Dialog parameters Center Reordering Free Delete Tools | Copy Line Tools | Function name Tools | Reordering | Manual This command activates the manual ordering mode. All selectable objects will display their order number. Click on the objects in the order you want, then press right mouse button or the ESC key. Tools | Free Hot Keys This command opens the window containing the list of letters to be used as hotkeys with objects in the dialog definition table. All used hotkeys are dim. The list refreshes every time the new object is inserted or the old object is deleted. Window | Minimize All This command minimizes and docks all open windows on the desktop. Window | Maximize All The command maximizes and cascades all minimized and open windows. Application | New item This command creates the new item in the selected list - new application item or new snippet. Application | Delete item This command erases the focused item in the selected list - new application item or new snippet. Application This submenu contains the commands for snippet and app item list maintenance Tools | Center This command centers the dialog box within the desktop. This menu item corresponds to the [C] icon on the dialog's frame. Tools | Dialog parameters This command brings the data editing window for the dialog being built. The content and layout of the window is defined in appropriate ODF file. Application | Edit item This comand opens editor for the focused item in selected list. If the selected list is the list of app items, the item is opened in the appropriate editor. Tools | Delete view This command lets you to delete any of the inserted subviews from the dialog window. If the Label, History or another related object is associated with the deleted object, it is removed from definition, too. Application | Item attributes This command displays the dialog with the attributes of selected application item. Application | New application This command clears memory and makes the new empty application table. Tools | Open All Snippets This command opens edit window for all changed snippets. Tools | Close All Snippets This command closes all snippet edit windows. Main | Generate This command will cause source code generation for current view stored in memory. The menu item 'Generate' is enabled only when you are building the single object or if you are in Application Builder dialog. Windows This menu contains commands for manipulating windows in the desktop: [ Size/Move Zoom Tile Cascade Next Previous Minimize Minimize Maximize cascade Close Close Window | Size/Move Using this command you can move the active window by pressing the arrow keys and resize it by pressing the Shift + arrow keys. Fix the new position and/or size by pressing Enter, or discard any changes by using the Esc key. r You can also move the window by dragging the window title, and you can change its size by using the resize icon. Window | Zoom You can use the Zoom command to resize the active window to the maximum size. _ If the window has already been zoomed, you can use this command to restore its previous size. I You can click on the zoom icon instead of calling up this menu command. Window | Tile Tiled windows. Window | Cascade Cascaded windows. Window | Next This command makes the next window active. Window | Previous This command makes the previous window active. Options This menu contains commands that let you view and change various system default settings in TVGen. J Colors Toggle video System options Language These settings affect the environment and generator behaviour. Setup | Toggle video This command toggles between 25 and 43 line mode. Setup | System options This command opens up a System Options dialog and lets you specify system parameters as file extensions, your company name (used in source codes), screen blank delay, source code options, etc. Setup | Language This submenu contains all languages available within this program. It can operate in English, Czech in Kamenickych code (CS Standard), Czech in Latin 2 code (for compatibility with MS-DOS 5.0) and Czech without diacritic (for Czech users with MDA). Setup | Language | English Display all texts in English now. Setup | Language | Czech (Kamenickych) Display all texts in Czech under Kamenickych code (the most common in Czech Republic). Setup | Language | Czech (Latin 2) Display all texts in Czech under Latin 2 code (for the DOS 5.0 users). Setup | Language | Czech Display all texts in Czech without diacritic. Useful for users with a MDA video adapter. Editor This submenu contains the commands for a simple text editor. You can edit your generated code immediately without exiting and using an external editor. Editor | Open This command brings up the Open File dialog and lets you locate and select the file to be edited. The F3 key is associated with this command. Editor | Save This command saves the file in the active edit window on disk. The F2 key is associated with this command. Window | Close This command closes the active window. Menu Box / Menu Bar Builder dialog You can define a menu bar or menu box object in this dialog. Simply click on Append button and then type the menu item parameters into input lines: Menu field text Menu parameters text (hot-keys,...) Keyboard shortcut (kbXXXX constants) Help context (hcXXXX constants) Associated command (cmXXXX constants) Parameters marked ' ' are ignored when defining the submenu heading. When defining the divider line, all parameters are ignored. The parameter lines with data to be ignored will disappear, so only the important controls remain on the screen. * If you are building a whole application: ( - There is not a "Command" input line in the dialog box. There is a button labelled "Command" instead. Push this button to choose a command from a command list. When you choose a command, the button's label changes to the selected command name. $ - The input line "Help Context" is substituted by three buttons: "Help Context" will open a snippet for help text for the current item; " " will clear that text, so it seems not to have a help context again; the "Hint" button brings up a dialog to edit a text which appears on a status line when the item is selected. The item is considered to have a help context if it has a help text in snippet or the hint text specified. Otherwise it is assumed that it has the value of hcNoContext. When ready, push the Ok button to send these parameters into the definition tree. If you want to cancel the parameters definition, press the Cancel button. To insert a menu item between other items, select the one to place the new item in front of and then press the Insert button. After filling up the input lines, the item will be placed at the desired position. When you set the menu item type to 'Submenu', you will create the submenu and then, if it's highlighted in the items list, you can step down into it by pressing the button. To return back one level up, press the button. The submenu itself can contain next submenus, and so on... j When you want to remove a line from the definition, highlight this one and then press the Delete button. To change the order of items, click on a double-headed arrow ( ) in front of an item you want to move and drag it holding the mouse button down. Users without mouse can move items using the arrow keys and keeping the Shift key pressed. To try to execute your menu, press the Test button. This feature shows only the menu. The help and associated dialog calls (in application builder) are NOT provided here. G The button Import is used to import standard sequences of menu items. j The button End will terminate the menu definition session and prompt you to save the table if necessary. Status Line Builder dialog You can define a status line object in this dialog. Simply click on the Append button and then type the menu item parameters into the input lines: M Minimum help context number Maximum help context number If you are building a whole application, there is one button "Help Context Range" instead of the two input lines. If you push it, the Help Contexts dialog will appear to specify the range of help context for the current status line part. The minimal and maximal help context numbers are chosen automatically. When ready, push the Ok button to send these parameters into the definition tree. If you want to cancel the parameters definition, press the Cancel button. To insert an item between other items, select the item you will place the new item in front of and then press the Insert button. After you fill the input lines, the item will be placed at desired position. g When you want to remove a line from the definition, highlight the line and then press the Delete key. After each update (except of deletion), the Status Builder dialog is brought up to define the associated status line keys. q The button End will terminate the status line definition session and prompt you to save the table if necessary. Status Key Builder dialog You can define status keys for the status line object in this dialog. Simply click on the Append button and then type the menu item parameters into the input lines: Status key field text Keyboard shortcut (kbXXXX constants) Associated command (cmXXXX constants) When you are building a whole application, there is not a "Command" input line in the dialog box. There is a button labelled "Command" instead. Push this button to choose a command from a command list. When you choose a command, the buttons label changes to the selected command name. When ready, push the Ok button to send these parameters into the definition tree. If you want to cancel the parameters definition, press the Cancel button. To insert an item between other items, select the item you will place the new item in front of and then press the Insert button. After you fill the input lines the item will be placed at the desired position. g When you want to remove a line from the definition, highlight the line and then press the Delete key. u The button END will terminate the status keys definition session and return to the main Status Builder dialog. OK button If you press this button, the settings you have made in the dialog box are sent to TVGen. CANCEL button If you press this button, nothing changes and no action occurs. Only the program returns to its previous state. CLEAR button If you press this button, all input lines in the dialog box will be cleared or set to their default values. APPEND button Pressing this button makes some input lines in the dialog box active and ready to accept input. The Ok, Cancel and Clear buttons are activated, too. DELETE button If you press this button, the highlighted item in the list is removed ( if possible ). INSERT button Pressing this button will cause an action similar to what happens when the Append button is pressed. However the new item is not appended at the end of the list. It is inserted at the position of the highlighted item in the list instead. DOWN button If you press this button, you will step one level down into the submenu tree. Since the submenu can contain any number of submenus, too, the current level number is displayed at the top of the list of items. The topmost level is 1. UP button If you press this button, you will move one level up in the menu tree. When you get to the root menu, the button is disabled. TRY IT button If you press this button, your current menu definition will appear on the screen to show its functionality. You can specify whether or not you want to clear the desktop first or if you don't. All menu items generate blank commands. } This action shows only the menu's appearance. The associated hints are not displayed and the linked methods are not called. END button Pressing this button will terminate the definition of the actual object. END button Pressing this button will terminate the definition of the actual object. IMPORT button This button invokes the dialog with the list of available import sets. These sets are located in MNU directory and have the same structure as the menu tables. See User's guide for further information. Add Button dialog Add Input Line dialog Add History dialog Add List Box dialog Add Cluster dialog Add Memo dialog T V G e n ver. 3.0 Welcome to the world of generated applications! [ This is the tool making your programming in Turbo Vision and Turbo Pascal more efficient. $ Copyright (c) 1994 BOCIAN Software See also: File notes Dialog Definition Mode In this mode you can resize and move the dialog window, add and delete subviews, rearrange the focus order, change their attributes, etc. You can drag, resize and repair the objects you have already inserted into the dialog box. See these topics for more details. Subview Selecting Mode Click the mouse on an object on which you want to perform an action. C To cancel this mode, press the right mouse button or the Esc key. The OPTIONS Flag Setting File Dialog Here you can locate or type in the file name for the next action. If you are creating a view definition table, note that the file must have the pre-defined extension. System Options You can specify important system options within this dialog: All file extensions Your name and your company name Screen blank delay Generator options Other environment options The file extensions must be unique and valid. The names are inserted into the source code. l The screen delay keeps your monitor from becoming damaged when the picture doesn't change for a long time. / The next control is the "Internal font" radio buttons. If the value is other than "None", the appropriate Czech national character set will be loaded into the graphics adaptor. The character set is under Kamenickych code. This control is not available in the version running in the DOS-Protected mode. The "Other Options" checkboxes set contents several system setting values. The boxes near the topics show the default setting. [X] Beep [X] Logo [ ] Enhanced Colors [ ] Zoomed [ ] Help Position [X] Safety [X] Auto [X] Source [X] Template highlight ] Desktop character The combo-box autoordering determines the autoorder function for Dialog Definition Mode. When other than "None" value is set, the automatic ordering is applied everytime the object is inserted or moved. Desktop character checkbox This checkbox allows you to choose one of seven characters that will appear on the desktop as the background. Shaded MenuBar checkbox Source Dir checkbox This checkbox tells the generator to generate code into the subdirectory SOURCE. If the current directory does not have the subdirectory, a new one is created. It is a good idea to leave it checked in order to avoid mixing the tables and sources. Include Headings checkbox TP/BP 7.0 Syntax checkbox Include Comments checkbox AutoSave checkbox If the AutoSave checkbox is on, the table you are editing will be saved every five minutes. It is useful when you are editing a complicated dialog box or menu bar, especially in application. Safety checkbox When checked, all operations which do some destructive changes such as removing, deleting and overwriting, are preceded by a message box which asks you to confirm the destructive changes. When the checkbox is not checked, the operation is done immediately. It's faster, but somewhat dangerous. Turn it off only if you are familiar with TVGen 2.0. Help Position checkbox When this checkbox is on, the help window memorizes its last position. Beep checkbox The computer will beep in some cases to attract your attention Logo checkbox This checkbox shows/hides the sign that ensures you that you are really working with TVGen ver. 3.0 Enhance Colors checkbox This checkbox allows you to use bright colors in the background instead of blinking letters. Template highlight This checkbox toggles on and off the syntax highlight feature for built-in text editor. If the checkbox is on and the extension of the edited file is one of the following: ?TF, SDF and all snippets ,the syntax tokens of the file are displayed in various colors. These colors can be changed within Color Picker. Zoomed Help checkbox When this checkbox is on, the called help window will appear, covering the entire screen. When it is off, the help window will be of the standard size, centered on the desktop. ? This option takes precedence over the Help Position checkbox. Dialog call specification Sorry, I don't know, too. Something's wrong? There should not be any need to ask about something. Please, watch your screen carefully. If you still don't know how to continue, read the Turbo Pascal or BC++ User's guide for more details about controlling the Turbo Vision-like environment. Object dragging Active in Dialog Definition Mode only. To drag the view, click on it and move the mouse while holding down the left mouse button. Release the button to fix the new position. T When you drag the input line object, the linked objects icon will be dragged, too. S If you want to move several objects at one time, click with the mouse outside the objects, then drag over them. TVGen will display dotted rectangle. When you release the mouse button, all object that are inside the rectangle will be highlighted. Then click on any of these objects and drag it. All highlighted objects will move together. # See also: Repairing and Resizing. Object repairing Active in Dialog Definition Mode only. \ To repair the view (bring up the appropriate dialog box), simply double-click on the view. " See also: Dragging and Resizing. Object resizing Active in Dialog Definition Mode only. To resize a view, just click on the lower-right corner of the view and then move the mouse with the left button held down. Release the button to fix the new size. h Object resizing can be applied on any object in the dialog box, except the history and the scroll bar. 7 The size limits are defined in appropriate ODF files. When resizing the static text, the icon will appear in the lower-right corner of the defined rectangle. This is necessary because the static text has the same color as the dialog itself, so you could "loose" the resizing corner. The icon can be following: @ - the rectangle is too big. Move the icon upwards. - the rectangle is too small. Move the icon right. - the rectangle is too long. Move the icon left. (One line text only) - the rectangle size is accurate. If there is no icon character, the rectangle is guaranteed to be one line high and punctually long. ) Frames have the resizing icon, too ( See also: Dragging and Repairing. Application Builder Now you are in the Application Builder. This dialog lets you build and generate a whole application source - that means the skeleton of the user's interface. The input line contains the application type identifier. All identifiers are considered to be valid because TVGen doesn't provide any syntax checking. The "Application items" list contains the objects used by application. You can insert an object in the application using INS key or from within "Application" menu. As soon as the You also can delete defined items by pressing the key DEL. The Snippet list contains defined types of snippets. You can add and remove the items using INS and DEL keys. If you want to save the current snippet list to be standard for all other applications, press "Save as default" buton. To open the snippet just double click on the item. Note: the snippet list contains the list of snippets you can open for the appliaction, not the list of physically defined snippets. Add Item Into Application Here you can choose which item you want to insert into an application. Fill in the input line with the symbolic name you want to appear in Application items list. Then choose the type of item: Dialog, Method, MenuBar or StatusLine. If there is the "Command" button in the dialog you can specify the command that will invoke the item from app's HandleEvent method. If there is the "Snippet" button (only for dialog items), press it to open the snippet of application method that calls the dialog. Snippets Snippet is a part of a source code written directly using the TVGen's snippet editor. This text will be placed into generated code. R The local menu is available with the snippet editor. It simplifies code writing. Syntax checking is not provided with the snippet technology, so everything you type in will be copied into the resulting code. Snippet files are not available for use with the ordinary text editor because they contain some codes and markers which are important for text seeking. Any changes made to these files other than by using TVGen's snippet windows may result in data loss. Snippet windows are not modal (with exception of menubar help snippets), so you can open multiple snippet windows, minimize, cascade, tile them and so on. General TView-descendant object Message and Input Boxes You can define the standard message and input boxes within this dialog. When the SHOW button is pressed, the highlighted object in the list will be shown on cleared desktop. The EDIT button calls the editing dialog with the data of highlighted command. The NEW button calls the same dialog with empty input objects. Only the OK button will accept all changes made. Pressing the CANCEL button or clicking on the close icon or pressing the Esc key will abandon the changes. ' This dialog works in two basic modes: W To make new dialogs or edit old dialogs To choose one of them (and edit, too) When it is in editing mode ( called from submenu Main ), the EDIT button is the default, so pressing the Enter key or selecting an item in a list box will automatically call the editing dialog for a highlighted item. When it is in choosing mode ( called from Application builder or snippet), the OK button is the default, so the selection of an object is very fast and simple. Edit Existing Special Dialog Make some changes to the data of the special dialog, and then press the OK button to accept the new values or CANCEL to close the dialog without saving the changes. Edit New Special Dialog Write the new data for the special dialog, and then press the OK button to accept the values or CANCEL to close the dialog without making a new item. Command Set This dialog holds all commands you can use in the application. To select any of them just highlight it, then press Enter, Space Bar, the Ok button or double-click on the command name. If there is not a command you want to use, press the NEW button and insert a new command name. This command set will be later saved into the application table ( *.APP file ). This dialog is used in two ways: to make the command list and to choose one command from the list. When you are choosing the command while adding new item into application, the command list content depends on the calling object. If the item is called from within menubar, only commands used in menubar are diaplayed. If the item is called by application, all available commands will appear. TVGen ver. 3.0 files The source and table extensions can be changed in the options setting dialog called up by "Setup | System options" menu. If you are starting to build a new application, it's a good idea to make a new directory because TVGen will generate a lot of files. When you work only in one directory, the files will not overwrite each other if you give them different names. However, the directory will be quite busy after a while, and it will be very hard to separate the right files for further use. H For the same reason, do not generate anything in TVGen home directory. Color picker dialog In this dialog you can change the default colors for the environment. In addition, you can save and load color schemes. The active color scheme can be used optionally as a default color set of the generated application. Application code options This dialog allows you to specify application code options. These options are user-defined, feel free to add new options or delete old ones. The option setting is then tested in templates by using the directive @IFOPTION