home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / chip / tvgencpp / demo3cpp.exe / TVGEN3_E.HLP (.txt) < prev    next >
Borland Turbo Vision Help  |  1994-12-17  |  52KB  |  626 lines

  1.  Do you really need help ?
  2.  Files | Save table
  3. 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. )
  4. See also: Save
  5. table
  6. as...
  7. , Load
  8. table 
  9.  Files | Save table as...
  10. 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
  11. The current definition file name displayed in the lower right corner is also updated. "
  12. See also: Load
  13. table, Save
  14. table 
  15.  Files | Load table
  16. 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. 
  17. 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. (
  18. See also: Save
  19. table, Save
  20. table
  21. as... 
  22.  Files | Exit
  23. 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. 
  24. See also: Save
  25. table 
  26.  Files | ChangeDir
  27. Command ChangeDir changes the current work directory. You cannot change directory when building application. 
  28.  Files | DosShell
  29. 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. 
  30.  Files | About
  31. This menu item brings up the 'About' dialog showing copyright and version information. ;
  32. Choose CONTINUE button or press Esc key to close the box. 
  33.  Files
  34. This menu contains file management and view table commands as loading and saving menu definition tables and exiting TVGen. >
  35.      
  36.  Save
  37. table
  38.      
  39.  Save
  40. table
  41. as...
  42.      
  43.  Load
  44. table
  45.      
  46.  ChangeDir
  47.      
  48. Shell
  49.      
  50.  About
  51.      
  52.  Exit
  53.  Main | Menu Bar
  54. This command brings up the Menu
  55. Builder dialog, where you can create, modify and try to execute a menu definition. )
  56. See also: Menu
  57. Box, Status
  58. Line, Dialog 
  59.  Main | Menu Box
  60. This command brings up the Menu
  61. Builder dialog, where you can create, modify and try to execute a menu definition. )
  62. See also: Menu
  63. Bar, Status
  64. Line, Dialog 
  65.  Main | Status Line
  66. This command brings up the Status
  67. Builder dialog, where you can create and modify the status line definition. &
  68. See also: Menu
  69. Bar, Menu
  70. Box, Dialog 
  71.  Main | Dialog
  72. This command sets up the Dialog
  73. Definition
  74. Mode. In this mode you can define dialog size and position, insert subviews into the dialog window, change subview chain order and so on. +
  75. See also: Menu
  76. Bar, Menu
  77. Box, Status
  78. Line 
  79.  Main | Close view
  80. 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
  81. See also: Save
  82. table, Save
  83. table
  84. as..., Load
  85. table 
  86.  Main | Message Box
  87. 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. "
  88. See also: Input
  89. Box, Application 
  90.  Main | Input Box
  91. 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. $
  92. See also: Message
  93. Box, Application 
  94.  Main | Application
  95. 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. 
  96.  Main | Load Picture
  97. 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. %
  98. Enabled only when building dialogs. 
  99. See also: Clear
  100. Pictures 
  101.  Main | Clear Pictures
  102. This command closes all picture dialogs created using Load
  103. Picture command in this submenu. .
  104. Enabled only when building dialogs or menus. 
  105.  Main
  106. This menu contains all the main actions available in TVGen ver. 3.0 "
  107. You can do the following things: 
  108.  Define stand-alone objects
  109.  Menu
  110.  Menu
  111.  Status
  112.  Dialog
  113. Define standard MessageBox and InputBox dialogs. <
  114. Define entire Application, load and close picture dialogs. 
  115. There is a command Close
  116. view in this menu. It allows you to terminate the view definition session and clear the memory for another actions. 
  117.  Objects
  118. This submenu contains all of the subview classes you can put into the dialog window in the Dialog
  119. Definition
  120. Mode. These classes are defined in ODF files (See User's guide) 
  121.  Data dialog
  122. 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. 
  123.  Cluster content dialog
  124. This dialog contains the cluster hidden under the button you just pressed. The layout is defined in appropriate ODF file. 
  125.  Snippet list
  126. 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. 
  127.  Tools | Reordering
  128. This submenu contains commands for dialog object reordering - both automatic and manual. 
  129.  Tools | Reordering | Horizontal automatic
  130. This command automatically changes order of views in the dialog so that the focus moves from one to another row by row. 
  131.  Tool | Reordering | Vertical automatic
  132. This command automatically changes order of views in the dialog so that the focus moves from one to another column by column. 
  133.  New snippet
  134. 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. 
  135.  Dialog | List Boxes
  136.  Dialog | Clusters
  137.  Dialog | Clusters | Radio Buttons
  138.  Dialog | Clusters | Check Boxes
  139.  Dialog | Clusters | Multi Check Boxes
  140.  Dialog | Static Texts
  141.  Dialog | Labels
  142.  Dialog | Memos
  143.  Object | Frame
  144. 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
  145. Frames are always inserted at the beginning of the subview queue to ensure that all other objects will appear "above". 
  146.  Object to dialog
  147. 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". 
  148.  Objects to dialog
  149. This submenu contains classes with common ancestor. All object are defined in ODF file. 
  150.  Methods | Init
  151.  Methods | Done
  152.  Window | Close all
  153. This command closes all open windows. 
  154.  Window | Minimize
  155. This menu item minimizes the active edit window. The same function has the icon [
  156. ] in window frame. If the acive window is currently minimized it restores its's original size before minimalization. 
  157.  Methods | GetPalette
  158.  Methods | SetState
  159.  Methods | Draw
  160.  Tools
  161. This menu contains some useful tools for dialog building. They are available in Dialog
  162. Definition
  163. Mode and provide all common actions with objects which have already been inserted into the dialog window: ]
  164.  Dialog
  165. parameters
  166.  Center
  167.  Reordering
  168.  Free
  169.  Delete
  170.  Tools | Copy Line
  171.  Tools | Function name
  172.  Tools | Reordering | Manual
  173. 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. 
  174.  Tools | Free Hot Keys
  175. 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. 
  176.  Window | Minimize All
  177. This command minimizes and docks all open windows on the desktop. 
  178.  Window | Maximize All
  179. The command maximizes and cascades all minimized and open windows. 
  180.  Application | New item
  181. This command creates the new item in the selected list - new application item or new snippet. 
  182.  Application | Delete item
  183. This command erases the focused item in the selected list - new application item or new snippet. 
  184.  Application
  185. This submenu contains the commands for snippet and app item list maintenance 
  186.  Tools | Center
  187. This command centers the dialog box within the desktop. This menu item corresponds to the [C] icon on the dialog's frame. 
  188.  Tools | Dialog parameters
  189. 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. 
  190.  Application | Edit item
  191. 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. 
  192.  Tools | Delete view
  193. 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. 
  194.  Application | Item attributes
  195. This command displays the dialog with the attributes of selected application item. 
  196.  Application | New application
  197. This command clears memory and makes the new empty application table. 
  198.  Tools | Open All Snippets
  199. This command opens edit window for all changed snippets. 
  200.  Tools | Close All Snippets
  201. This command closes all snippet edit windows. 
  202.  Main | Generate
  203. 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
  204. Builder dialog. 
  205.  Windows
  206. This menu contains commands for manipulating windows in the desktop: [
  207.       
  208.  Size/Move
  209.       
  210.  Zoom
  211.       
  212.  Tile
  213.       
  214.  Cascade
  215.       
  216.  Next
  217.       
  218.  Previous
  219.       
  220.  Minimize
  221.       
  222.  Minimize
  223.       
  224.  Maximize
  225. cascade
  226.       
  227.  Close
  228.       
  229.  Close
  230.  Window | Size/Move
  231. 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
  232. You can also move the window by dragging the window title, and you can change its size by using the resize icon. 
  233.  Window | Zoom
  234. You can use the Zoom command to resize the active window to the maximum size. _
  235. If the window has already been zoomed, you can use this command to restore its previous size. I
  236. You can click on the zoom icon instead of calling up this menu command. 
  237.  Window | Tile
  238.                
  239.                
  240.                
  241.                
  242.                
  243.                
  244.                
  245.                
  246.                
  247.                
  248.                
  249.                
  250.                
  251.                
  252.                
  253.                
  254.               Tiled windows.
  255.  Window | Cascade
  256.                          
  257.                          
  258.                          
  259.                          
  260.                          
  261.          Cascaded windows.
  262.  Window | Next
  263. This command makes the next window active. 
  264.  Window | Previous
  265. This command makes the previous window active. 
  266.  Setup
  267. This menu contains commands that let you view and change various system default settings in TVGen. J
  268.  Colors
  269.  Toggle
  270. video
  271.  System
  272. options
  273.  Language
  274. These settings affect the environment and generator behaviour. 
  275.  Setup | Toggle video
  276. This command toggles between 25 and 43 line mode. 
  277.  Setup | System options
  278. 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. 
  279.  Setup | Language
  280. 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). 
  281.  Setup | Language | English
  282. Display all texts in English now. 
  283.  Setup | Language | Czech (Kamenickych)
  284. Display all texts in Czech under Kamenickych code (the most common in Czech Republic). 
  285.  Setup | Language | Czech (Latin 2)
  286. Display all texts in Czech under Latin 2 code (for the DOS 5.0 users). 
  287.  Setup | Language | Czech
  288. Display all texts in Czech without diacritic. Useful for users with a MDA video adapter. 
  289.  Editor
  290. This submenu contains the commands for a simple text editor. You can edit your generated code immediately without exiting and using an external editor. 
  291.  Editor | Open
  292. 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. 
  293.  Editor | Save
  294. This command saves the file in the active edit window on disk. The F2 key is associated with this command. 
  295.  Window | Close
  296. This command closes the active window. 
  297.  Menu Box / Menu Bar Builder dialog
  298. 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: 
  299.      
  300.  Menu field text
  301.  Menu parameters text  (hot-keys,...)
  302.  Keyboard shortcut     (kbXXXX constants)
  303.      
  304.  Help context          (hcXXXX constants)
  305.  Associated command    (cmXXXX constants)
  306. Parameters marked '
  307. ' 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. *
  308. If you are building a whole application: (
  309.  - There is not a "Command" input line
  310. 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. $
  311.  - The input line "Help Context" is
  312. substituted by three buttons: "Help Context" will open a snippet for help text for the current item; "
  313. " 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. 
  314. 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. 
  315. 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. 
  316. 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 
  317.  button. To return back one level up, press the 
  318.  button. The submenu itself can contain next submenus, and so on... j
  319. When you want to remove a line from the definition, highlight this one and then press the Delete button. 
  320. To change the order of items, click on a double-headed arrow (
  321. ) 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. 
  322. 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
  323. The button Import is used to import standard sequences of menu items. j
  324. The button End will terminate the menu definition session and prompt you to save the table if necessary. 
  325.  Status Line Builder dialog
  326. 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
  327.         
  328.  Minimum help context number
  329.         
  330.  Maximum help context number
  331. 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
  332. 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. 
  333. 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. 
  334. 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
  335. When you want to remove a line from the definition, highlight the line and then press the Delete key. 
  336. After each update (except of deletion), the Status
  337. Builder dialog is brought up to define the associated status line keys. q
  338. The button End will terminate the status line definition session and prompt you to save the table if necessary. 
  339.  Status Key Builder dialog
  340. 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: 
  341.         
  342.  Status key field text
  343.         
  344.  Keyboard shortcut  (kbXXXX constants)
  345.         
  346.  Associated command (cmXXXX constants)
  347. 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. 
  348. 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. 
  349. 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
  350. When you want to remove a line from the definition, highlight the line and then press the Delete key. u
  351. The button END will terminate the status keys definition session and return to the main Status
  352. Builder dialog. 
  353.  OK button
  354. If you press this button, the settings you have made in the dialog box are sent to TVGen. 
  355.  CANCEL button
  356. If you press this button, nothing changes and no action occurs. Only the program returns to its previous state. 
  357.  CLEAR button
  358. If you press this button, all input lines in the dialog box will be cleared or set to their default values. 
  359.  APPEND button
  360. 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. 
  361.  DELETE button
  362. If you press this button, the highlighted item in the list is removed ( if possible ). 
  363.  INSERT button
  364. 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. 
  365.  DOWN button
  366. 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. 
  367.  UP button
  368. 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. 
  369.  TEST button
  370. 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. }
  371. This action shows only the menu's appearance. The associated hints are not displayed and the linked methods are not called. 
  372.  END button
  373. Pressing this button will terminate the definition of the actual object. 
  374.  END button
  375. Pressing this button will terminate the definition of the actual object. 
  376.  IMPORT button
  377. 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. 
  378.  Add Button dialog
  379.  Add Input Line dialog
  380.  Add History dialog
  381.  Add List Box dialog
  382.  Add Cluster dialog
  383.  Add Memo dialog
  384.  T V G e n  ver. 3.0
  385. Welcome to the world of generated applications! [
  386. This is the tool making your programming in Turbo Vision and Turbo Pascal more efficient. $
  387. Copyright (c) 1994 BOCIAN Software 
  388. See also: File
  389. notes 
  390.  Dialog Definition Mode
  391. In this mode you can resize and move the dialog window, add and delete subviews, rearrange the focus order, change their attributes, etc. 
  392. You can drag, resize and repair the objects you have already inserted into the dialog box. See these topics for more details. 
  393.  Subview Selecting Mode
  394. Click the mouse on an object on which you want to perform an action. C
  395. To cancel this mode, press the right mouse button or the Esc key. 
  396.  The OPTIONS Flag Setting
  397.  File Dialog
  398. 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. 
  399.  System Options
  400. You can specify important system options within this dialog: z
  401.  All file extensions
  402.  Your name and your company name
  403.  Screen blank delay
  404.  Other environment options
  405. The file extensions must be unique and valid. The names are inserted into the source code. l
  406. The screen delay keeps your monitor from becoming damaged when the picture doesn't change for a long time. 
  407. The "Other Options" checkboxes set contents several system setting values. The boxes near the topics show the default setting. 
  408.   [X] Beep
  409.   [X] Logo
  410.   [ ] Enhanced
  411. Colors
  412.   [ ] Zoomed
  413.   [ ] Help
  414. Position
  415.   [X] Safety
  416.   [X] Auto
  417.   [X] Source
  418.   [X] Template
  419. highlight
  420. ] Desktop
  421. character
  422. The combo-box autoordering determines the autoorder function for Dialog
  423. Definition
  424. Mode. When other than "None" value is set, the automatic ordering is applied everytime the object is inserted or moved. 
  425.  Desktop character checkbox
  426. This checkbox allows you to choose one of seven characters that will appear on the desktop as the background. 
  427.  Shaded MenuBar checkbox
  428.  Source Dir checkbox
  429. 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. 
  430.  Include Headings checkbox
  431.  TP/BP 7.0 Syntax checkbox
  432.  Include Comments checkbox
  433.  AutoSave checkbox
  434. 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. 
  435.  Safety checkbox
  436. 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. 
  437. 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. 
  438.  Help Position checkbox
  439. When this checkbox is on, the help window memorizes its last position. 
  440.  Beep checkbox
  441. The computer will beep in some cases to attract your attention 
  442.  Logo checkbox
  443. This checkbox shows/hides the sign that ensures you that you are really working with TVGen ver. 3.0 
  444.  Enhance Colors checkbox
  445. This checkbox allows you to use bright colors in the background instead of blinking letters. 
  446.  Template highlight
  447. 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: 
  448.  ?TF, SDF and all snippets 
  449.  ,the syntax tokens of the file are displayed in various colors. These colors can be changed within Color
  450. Picker. 
  451.  Zoomed Help checkbox
  452. 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. ?
  453. This option takes precedence over the Help
  454. Position checkbox. 
  455.  Dialog call specification
  456.       Sorry, I don't know, too.
  457.  Something's wrong?
  458. 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. 
  459.  Object dragging
  460. Active in Dialog
  461. Definition
  462. Mode only. 
  463. 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
  464. When you drag the input line object, the linked objects icon will be dragged, too. S
  465. 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. #
  466. See also: Repairing and Resizing. 
  467.  Object repairing
  468. Active in Dialog
  469. Definition
  470. Mode only. \
  471. To repair the view (bring up the appropriate dialog box), simply double-click on the view. "
  472. See also: Dragging and Resizing. 
  473.  Object resizing
  474. Active in Dialog
  475. Definition
  476. Mode only. 
  477. 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
  478. Object resizing can be applied on any object in the dialog box, except the history and the scroll bar. 7
  479. The size limits are defined in appropriate ODF files. 
  480. 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: @
  481.  - the rectangle is too big.
  482.         Move the icon upwards.
  483.  - the rectangle is too small.
  484.         Move the icon right.
  485.  - the rectangle is too long.
  486.         Move the icon left.
  487.         (One line text only)
  488.  - the rectangle size is accurate.
  489. If there is no icon character, the rectangle is guaranteed to be one line high and punctually long. )
  490. Frames have the resizing icon, too (
  491. See also: Dragging and Repairing. 
  492.  Application Builder
  493. 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. 
  494. The input line contains the application type identifier. All identifiers are considered to be valid because TVGen doesn't provide any syntax checking. 
  495. 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. 
  496. 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. 
  497. Note: the snippet list contains the list of snippets you can open for the appliaction, not the list of physically defined snippets. 
  498.  Add Item Into Application
  499. 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. 
  500.  Snippets
  501. 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
  502. The local
  503. menu is available with the snippet editor. It simplifies code writing. 
  504. Syntax checking is not provided with the snippet technology, so everything you type in will be copied into the resulting code. 
  505. 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. 
  506. 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. 
  507.  General TView-descendant object
  508.  Message and Input Boxes
  509. 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. 
  510. The EDIT button calls the editing dialog with the data of highlighted command. The NEW button calls the same dialog with empty input objects. 
  511. 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. '
  512. This dialog works in two basic modes: W
  513.  To make new dialogs or edit old dialogs
  514.  To choose one of them (and edit, too)
  515. 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. 
  516. When it is in choosing mode ( called from Application
  517. builder or snippet), the OK button is the default, so the selection of an object is very fast and simple. 
  518.  Edit Existing Special Dialog
  519. 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. 
  520.  Edit New Special Dialog
  521. 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. 
  522.  Command Set
  523. 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 ). 
  524. 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. 
  525.  TVGen ver. 3.0 files
  526. The source and table extensions can be changed in the options setting dialog called up by "Setup | System options" menu. 
  527. 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. 
  528. 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
  529. For the same reason, do not generate anything in TVGen home directory. 
  530.  Color picker dialog
  531. 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. 
  532.  Application code options
  533. 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 
  534.            @IFOPTION <option>
  535. The list of code options is saved in application file *.APP. If you want to change the standard options set for all further aplications, press the "Save as default" button. 
  536.  HandleEvent method builder
  537.  Item Info Dialog
  538.  Dialog parameters
  539.  EventMask field setting
  540.  Help range dialog
  541. This dialog contains the list of all used help-context constants (hcXXXX) within the application. Now you can specify which values make the range of values for NewStatusDef call. All constants you see in list box are available for use. The constants with a marker have been already chosen for use with the actual NewStatusDef call. To toggle markers on/off just double-click on the desired identifier or press space bar. If you press button "ALL", all available identifiers will be chosen (the markers will appear). If you press button "NONE", all constants will be deselected (markers will disappear). Button "OK" will hand the selected group to Status
  542. Builder dialog. G
  543. When you are editing a help context range for another part of status line, the items you selected will not be displayed in list box, because the ranges of the status line parts should not overlap. So if you want to include some already used constant in another part, you must remove it from that one first ( make it unused ). n
  544. The list box shows only that items, which are unused or which are used by currently edited status line part. 
  545. NOTE: If you select at least one constant from the list, the "OK" button in Status
  546. Builder dialog will become enabled, otherwise it will be disabled. 
  547.  Message Box parameters
  548. This dialog lets to define message box parameters. You can type in the message box text, specify the dialog title and buttons, which will appear in final dialog. 
  549. When defining text, you can use commands \3 or \N as a "Ctrl-C" and "Ctrl-N" static text control codes. You can also use format specifiers known from C language's vsprintf function. ~
  550. When you display message box containing such format specifiers using button SHOW, the following assignments will take place: -
  551. %s specifier is replaced by string 'BOCIAN' 4
  552. %d and %x specifiers are replaced by random number /
  553. %c specifier is replaced by the character '
  554. In the generated code the params pointer is set to NIL. It is up to you to replace it by valid value. 
  555. \C must be at the beginning of the text or after \N code - it specifies that the text will be centered. \N can be at any position in the text - it marks the new line. ?
  556. The letters following the backslash (\) are case insensitive. 
  557.  Set Command Origin
  558.  Setup | Colors
  559. This command brings up the Color
  560. Picker
  561. dialog, where you can select colors for individual objects and their parts. The dialog contains two additional buttons SAVE and LOAD, so you can store and retrieve color schemes to/from disk. 
  562.  Editor | New
  563. This command opens the new Editor 'Untitled' window and makes it active. 
  564.  Editor | Save As
  565. Save As opens up the Save File As dialog where you can save the file in active editor window under different name, directory and/or drive. 
  566.  Editor | Undo
  567. Undo cancels edits to the current line. This Undo command doesn't work as the Undo command in TP/BP 7.0 IDE. It cancels only the last edits, not all. 
  568.  Editor | Cut
  569. Cut moves the selected text in the Clipboard. You can then use Paste to place the text to any other document ( or somevhere else in the same document ). 
  570.  Editor | Copy
  571. Copy leaves the selected text intact but places the exact copy of it in the Clipboard. You can then use Paste to place the text to any other document ( or somevhere else in the same document ). 
  572.  Editor | Paste
  573. The Paste command inserts the text from the Clipboard into the active editor window at the current cursor position. 
  574.  Editor | Clear
  575. This command clears the selected text from the editor window. It does NOT place it onto the Clipboard. 
  576.  Editor | Find
  577. This command opens up the Find dialog box where you can specify the text you want to search for. The shortcut for this command is Ctrl+Q F. 
  578.  Editor | Replace
  579. This command opens up the Replace dialog box where you can specify the text you want to search for and the text you want to replace it with. The shortcut for this command is Ctrl+Q A. 
  580.  Editor | Search Again
  581. This command repeats the last Find or Replace command. All options you made in Find dialog box remain in effect when you choose Search Again. The shortcut for Search Again is Ctrl+L. 
  582.  Input line validator
  583.  Add Label dialog
  584.  Add Static Text dialog
  585.  List Of Used Hotkeys
  586.  Insert call to OpenFile function
  587. This local menu items inserts the call to OpenFile function at the cursor position. The syntax is defined in file OPENFILE.TXT 4
  588. The source for the OpenFile function is in SUPPLY3 
  589.  Insert call to ChangeDir procedure
  590. This local menu items inserts the call to ChangeDir procedure at the cursor position. The syntax is defined in file CHDIR.TXT 6
  591. The source for the ChangeDir procedure is in SUPPLY3 
  592.  Import ASCII file
  593. This item displays the 'OpenFile' dialog to let you specify the name of file to be imported. The file content is then copied to the snippet at the cursor position. 
  594.  Insert call to MessageBox
  595. This local menu item displays the dialog to let you choose the MessageBox to be inserted into the snippet. This dialog is identical to that available using command Main
  596. MessageBox. Then the call of the MessageBox you have chosen appears at the cursor position. The syntax is defined in file MSGBOX.TXT 
  597.  Insert call to InputBox
  598. This local menu item displays the dialog to let you choose the InputBox to be inserted into the snippet. This dialog is identical to that available using command Main
  599. InputBox. Then the call of the InputBox you have chosen appears at the cursor position. The syntax is defined in file INPUTBOX.TXT 
  600.  Insert call to dialog
  601. This item lets you to insert a call to the dialog which is a member of the application list. The calls of AppDialogCall and AppDialogType template procedures are inserted. 
  602.  Erase snippet
  603. This command erases the snippet. All changes to it will be lost and the snippet will not appear in the generated code. 
  604.  Local Menu
  605. The snippet local menu simplifies process of creating method bodies. You can insert a call to message
  606. box, input
  607. box, dialog, OpenFile function and ChangeDir procedure using this menu, or you can erase the method as well. J
  608. Importing the text from ASCII file to the snippet is also available now. Z
  609. The local menu is accessible by Alt-F10 keystroke or by pressing the right mouse button. 
  610.  User-defined method
  611.  Add Outline dialog
  612.  Function Name
  613.  Copy Input Line
  614.  New Dialog Type
  615.  New Dialog Title
  616.  Item's Hint Text
  617. This input box allows user to specify the text which appears at the status line as 'Hint' when the menu item is chosen. 
  618.  User-defined method
  619.  File Editor
  620. This is the editor window. Here you can watch and modify the generated code or create another text files. If the editor contains the template file, the syntax tokens can be displayed in different colors. 
  621.  Free Hot Keys
  622. This window shows the list of all available hot keys you can use within the dialog. If you insert new object or delete the old one from the dialog, the list will be updated immediately. 
  623.  The snippet already exists
  624.  Button command
  625. BPFQF%N*N+N,N-N.N/N0N1N2N3N4N5N6N7N@
  626.