home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 30 fixes_v / 30-fixes_v.zip / vxrx101.zip / VRXEDIT.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-09-07  |  73KB  |  2,007 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. VXΓêÖREXX online help ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. ΓòÉΓòÉΓòÉ 1.1. Using VXΓêÖREXX ΓòÉΓòÉΓòÉ
  6.  
  7. The VXΓêÖREXX main menu bar contains the following menus. Double click on any 
  8. highlighted item for more information: 
  9.  
  10. Project        The Project menu contains items that allow you to manipulate 
  11.                projects and project files. 
  12.  
  13. Tools          The Tools menu contains items which represent the available user 
  14.                interface objects that can be added to a window. 
  15.  
  16. Windows        The Windows menu provides items for controlling auxiliary 
  17.                windows for managing files, windows and code sections, and 
  18.                aiding project design and debugging. 
  19.  
  20. Run            The Run menu allows you to test and debug project code. 
  21.  
  22. Options        The Options menu allows you to configure some aspects of 
  23.                VXΓêÖREXX. 
  24.  
  25. Help           The Help menu provides access to information about VXΓêÖREXX. 
  26.  
  27. See also: 
  28.  
  29. o A list of functions 
  30. o A list of methods 
  31. o A list of objects 
  32. o A list of properties 
  33. o A list of events 
  34. o A list of predefined routines 
  35. o A summary of help topics 
  36. o A summary of the REXX language 
  37.  
  38. For an in-depth introduction to VXΓêÖREXX, see either Introduction or A simple 
  39. program in the VXΓêÖREXX Programmer's Guide. 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 1.2. The Tools menu ΓòÉΓòÉΓòÉ
  43.  
  44. Use the Tools menu to select the type of object you wish to add to your window. 
  45. Once an object type has been selected, position the mouse pointer at the 
  46. upper-left corner of the intended location for the object, and drag the mouse 
  47. pointer down and to the right to outline the shape of the object. When the 
  48. mouse button is released, the new object will appear. 
  49.  
  50. When an object has been selected the mouse pointer will change to a cross-hair 
  51. when over your window. After you have drawn the object it will return to an 
  52. arrow pointer. The Pointer  tool can be used to reset the mouse pointer without 
  53. inserting an object. 
  54.  
  55. For a complete list of all objects see Summary of objects in the VXΓêÖREXX 
  56. Reference. For more information about adding objects in your project, see 
  57. Adding objects to a window in the VXΓêÖREXX Programmer's Guide. 
  58.  
  59. See also: 
  60.  
  61. o Pointer 
  62. o CheckBox 
  63. o ComboBox 
  64. o DescriptiveText 
  65. o DropDownComboBox 
  66. o EntryField 
  67. o GroupBox 
  68. o ImagePushButton 
  69. o ImageRadioButton 
  70. o ListBox 
  71. o MultiLineEntryField 
  72. o PictureBox 
  73. o PushButton 
  74. o RadioButton 
  75. o SpinButton 
  76.  
  77.  
  78. ΓòÉΓòÉΓòÉ 1.2.1. Pointer ΓòÉΓòÉΓòÉ
  79.  
  80. Use the Pointer tool to select objects on the program window. With the Pointer 
  81. tool selected, click on an object in the program window with mouse button 1. 
  82. Black handles will appear around the object. This indicates that the object has 
  83. been selected. 
  84.  
  85. To select multiple objects in the program window: 
  86.  
  87.  1. Select the Pointer tool from the Tools  menu, or the Pointer icon from the 
  88.     Tool palette. 
  89.  
  90.  2. Click on the first object to be selected with mouse button 1. 
  91.  
  92.  3. Press the Ctrl key and click on subsequent objects with mouse button 1 to 
  93.     select them. 
  94.  
  95. All selected objects will appear with gray handles. 
  96.  
  97. Another way to select multiple objects is to press down mouse button 1 above 
  98. and to the left of the objects you want to select. Then, still holding down the 
  99. mouse button, move the mouse below and to the right of the objects you want to 
  100. select, and let go of the mouse button. All objects in this rectangle will be 
  101. automatically selected. 
  102.  
  103. See the Tools menu  for more information. 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 1.2.2. CheckBox ΓòÉΓòÉΓòÉ
  107.  
  108. Use the CheckBox tool to create a CheckBox object. A check box is used to 
  109. present an on/off option to the user. The option is either selected (a check 
  110. mark appears in the box) or not (the check box is empty). 
  111.  
  112. See the Tools menu  for more information. 
  113.  
  114.  
  115. ΓòÉΓòÉΓòÉ 1.2.3. ComboBox ΓòÉΓòÉΓòÉ
  116.  
  117. Use the ComboBox tool to create a ComboBox object. A combination box is used to 
  118. allow the user to enter information either by selecting an item from a list or 
  119. by typing a value. 
  120.  
  121. See the Tools menu  for more information. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 1.2.4. DescriptiveText ΓòÉΓòÉΓòÉ
  125.  
  126. Use the DescriptiveText tool to create a DescriptiveText object. Descriptive 
  127. text is used to place static text in a window. It is frequently used to label 
  128. other objects. 
  129.  
  130. See the Tools menu  for more information. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 1.2.5. DropDownComboBox ΓòÉΓòÉΓòÉ
  134.  
  135. Use the DropDownComboBox tool to create a DropDownComboBox object. A drop down 
  136. combination box is used to allow the user to enter information either by 
  137. selecting an item from a list or by typing a value. It is the same as a 
  138. combination box (see ComboBox ) except that the list part is only displayed 
  139. when the user opens the drop down list. 
  140.  
  141. See the Tools menu  for more information. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 1.2.6. EntryField ΓòÉΓòÉΓòÉ
  145.  
  146. Use the EntryField tool to create an EntryField object. An entry field 
  147. typically allows the user to enter a single line of text. 
  148.  
  149. See the Tools menu  for more information. 
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ 1.2.7. GroupBox ΓòÉΓòÉΓòÉ
  153.  
  154. Use the GroupBox tool to create a GroupBox object. A group box is used to group 
  155. objects within a window. 
  156.  
  157. Grouped objects move together when the group box is moved, and radio buttons 
  158. (see RadioButton ) within a group box operate together as a set, independent of 
  159. the other radio buttons within the window. 
  160.  
  161. See the Tools menu  for more information. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 1.2.8. ImagePushButton ΓòÉΓòÉΓòÉ
  165.  
  166. Use the ImagePushButton tool to create an ImagePushButton object. The image 
  167. push button is similar to the push button (see PushButton ), except that a 
  168. bitmap image is used instead of a caption. 
  169.  
  170. See the Tools menu  for more information. 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ 1.2.9. ImageRadioButton ΓòÉΓòÉΓòÉ
  174.  
  175. Use the ImageRadioButton tool to create an ImageRadioButton object. An image 
  176. radio button allows the user to choose one of a set of options. The image radio 
  177. button is similar to a radio button (see RadioButton ), except that a bitmap 
  178. image is used instead of a caption. 
  179.  
  180. See the Tools menu  for more information. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 1.2.10. ListBox ΓòÉΓòÉΓòÉ
  184.  
  185. Use the ListBox tool to create a ListBox object. A list box allows the user to 
  186. select one or more items from a list. 
  187.  
  188. See the Tools menu  for more information. 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 1.2.11. MultiLineEntryField ΓòÉΓòÉΓòÉ
  192.  
  193. Use the MutilLineEntryField tool to create a MultiLineEntryField object. 
  194. Multiline entry fields are used where an entry field with two or more lines of 
  195. text is desired. This type of entry field is typically used for long 
  196. descriptions, allowing the user to enter multiple lines of text, and scroll 
  197. through text information. 
  198.  
  199. See the Tools menu  for more information. 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 1.2.12. PictureBox ΓòÉΓòÉΓòÉ
  203.  
  204. Use the PictureBox tool to create a PictureBox object. A picture box displays a 
  205. bitmap image. 
  206.  
  207. See the Tools menu  for more information. 
  208.  
  209.  
  210. ΓòÉΓòÉΓòÉ 1.2.13. PushButton ΓòÉΓòÉΓòÉ
  211.  
  212. Use the PushButton tool to create a PushButton object. A push button allows the 
  213. user to perform an action. Common push buttons are OK and Cancel. 
  214.  
  215. See the Tools menu  for more information. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 1.2.14. RadioButton ΓòÉΓòÉΓòÉ
  219.  
  220. Use the RadioButton tool to create a RadioButton object. A radio button allows 
  221. the user to choose one of a set of options. You can create independent sets of 
  222. radio buttons by placing them in group boxes (see GroupBox ). 
  223.  
  224. See the Tools menu  for more information. 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 1.2.15. SpinButton ΓòÉΓòÉΓòÉ
  228.  
  229. Use the SpinButton tool to create a SpinButton object. A spin button allows the 
  230. user to choose one of a set of values. The values can be a range of numbers, or 
  231. an set of arbitrary strings. 
  232.  
  233. See the Tools menu  for more information. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 1.3. The Object pop-up menu ΓòÉΓòÉΓòÉ
  237.  
  238. The Object pop-up menu allows you to see and change object properties, and to 
  239. cut, copy, paste, delete and align objects. 
  240.  
  241. For information on items in this menu, see: 
  242.  
  243. o Properties 
  244. o Cut 
  245. o Copy 
  246. o Paste 
  247. o Delete 
  248. o Duplicate 
  249. o Align 
  250. o Menu editor 
  251.  
  252. For details on a particular type of object, see: 
  253.  
  254. o CheckBox 
  255. o ComboBox 
  256. o DescriptiveText 
  257. o DropDownComboBox 
  258. o EntryField 
  259. o GroupBox 
  260. o ImagePushButton 
  261. o ImageRadioButton 
  262. o ListBox 
  263. o MultiLineEntryField 
  264. o PictureBox 
  265. o PushButton 
  266. o RadioButton 
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 1.3.1. Properties ΓòÉΓòÉΓòÉ
  270.  
  271. Use the Properties command to display a notebook that lets you set the 
  272. properties for the selected object. If more than one object is selected, a 
  273. separate notebook will appear for each object. The property notebook for a 
  274. single object can also be displayed by double clicking on the object with mouse 
  275. button 1. 
  276.  
  277. Each page in the notebook has a group of properties that you can modify. The 
  278. different pages are opened by clicking with mouse button 1 on the index tabs. 
  279. Each time you change a property, the object will be updated to reflect that 
  280. change. 
  281.  
  282. To close an object's property notebook, double click with mouse button 1 on the 
  283. notebook's system menu, or pull down the notebook's system menu and choose the 
  284. Close item. 
  285.  
  286. For more information about programming with object properties see Changing 
  287. object properties in the VXΓêÖREXX Programmer's Guide. For a complete list of 
  288. properties, see Summary of properties in the VXΓêÖREXX Reference. 
  289.  
  290.  
  291. ΓòÉΓòÉΓòÉ 1.3.2. Cut ΓòÉΓòÉΓòÉ
  292.  
  293. Use the Cut command to copy and delete the currently selected objects. The 
  294. objects are copied to the VXΓêÖREXX clipboard, replacing its previous contents. 
  295.  
  296. Copied objects can be pasted into any window or group box in the current 
  297. project. All routines associated with an object are cut and pasted along with 
  298. the object. 
  299.  
  300. To copy an object from another project use the Load  command in the File  menu 
  301. of the File list  window to temporarily add the window containing the object to 
  302. the project. Copy the object then use the Remove  command in the File  menu of 
  303. the File list  window to remove the file. 
  304.  
  305. See the section on copying and deleting objects in the Adding objects to a 
  306. window chapter of the VXΓêÖREXX Programmer's Guide for more information. 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 1.3.3. Copy ΓòÉΓòÉΓòÉ
  310.  
  311. Use the Copy command to place the currently selected objects to the VXΓêÖREXX 
  312. clipboard. The copied objects replace the previous contents of the clipboard. 
  313.  
  314. Copied objects can be pasted into any window or group box in the current 
  315. project. All routines associated with an object are copied and pasted along 
  316. with the object. 
  317.  
  318. To copy an object from another project use the Load  command in the File  menu 
  319. of the File list  window to temporarily add the window containing the object to 
  320. the project. Copy the object then use the Remove  command in the File  menu of 
  321. the File list  window to remove the file. 
  322.  
  323. See the section on copying and deleting objects in the Adding objects to a 
  324. window chapter of the VXΓêÖREXX Programmer's Guide for more information. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 1.3.4. Paste ΓòÉΓòÉΓòÉ
  328.  
  329. Use the Paste command to copy the contents of the VXΓêÖREXX clipboard into a 
  330. window or group box. All of the objects and code in the clipboard are pasted. 
  331. An object will be given a new unique name when it is pasted if an object with 
  332. the same name already exists in the window file. Paste does not erase the 
  333. contents of the clipboard. 
  334.  
  335. To copy an object from another project use the Load  command in the File  menu 
  336. of the File list  window to temporarily add the window containing the object to 
  337. the project. Copy the object then use the Remove  command in the File  menu of 
  338. the File list  window to remove the file. 
  339.  
  340. See the section on copying and deleting objects in the Adding objects to a 
  341. window chapter of the VXΓêÖREXX Programmer's Guide for more information. 
  342.  
  343.  
  344. ΓòÉΓòÉΓòÉ 1.3.5. Delete ΓòÉΓòÉΓòÉ
  345.  
  346. Delete deletes the currently selected objects and their associated routines. If 
  347. you want to be able to restore the objects after they have been deleted, use 
  348. the Cut  command. 
  349.  
  350. See the section on copying and deleting objects in the Adding objects to a 
  351. window chapter of the VXΓêÖREXX Programmer's Guide for more information. 
  352.  
  353.  
  354. ΓòÉΓòÉΓòÉ 1.3.6. Align ΓòÉΓòÉΓòÉ
  355.  
  356. Use the Align command to move two or more objects in relation to each other so 
  357. that they are aligned. 
  358.  
  359. All selected objects are aligned to the object in which you opened the pop-up 
  360. menu. The alignment options are: 
  361.  
  362. Top            Align the objects by their top edges. 
  363.  
  364. Vertical Center Centers the objects vertically in relation to each other. 
  365.  
  366. Bottom         Align the objects by their bottom edges. 
  367.  
  368. Left           Align the objects by their left edges. 
  369.  
  370. Horizontal Center Centers the objects horizontally in relation to each other. 
  371.  
  372. Right          Align the objects by their right edges. 
  373.  
  374. See the section on aligning objects in the Adding objects to a window chapter 
  375. of the VXΓêÖREXX Programmer's Guide for more information. 
  376.  
  377.  
  378. ΓòÉΓòÉΓòÉ 1.3.7. Duplicate ΓòÉΓòÉΓòÉ
  379.  
  380. Use the Duplicate command to duplicate the selected objects. Duplicated objects 
  381. are independent objects that have the same name and share the same event 
  382. routines. 
  383.  
  384. For more information, see the section on duplicating objects in the Adding 
  385. objects to a window chapter in the VXΓêÖREXX Programmer's Guide. 
  386.  
  387.  
  388. ΓòÉΓòÉΓòÉ 1.4. The Menu editor ΓòÉΓòÉΓòÉ
  389.  
  390. To create or modify a window's menu bar, select Menu editor from the window's 
  391. pop-up menu. 
  392.  
  393. The left half of this dialog provides controls for adding, changing and 
  394. deleting menu entries. The right half displays the window's menu in a 
  395. hierarchical fashion, and provides controls to allow existing items to be moved 
  396. around in the menu. 
  397.  
  398. See the chapter Adding menus to a program in the VXΓêÖREXX Programmer's Guide for 
  399. more information about menus and the menu editor. 
  400.  
  401. See also: 
  402.  
  403. o Caption 
  404. o Name 
  405. o Level 
  406. o Enabled 
  407. o Checked 
  408. o HelpTag 
  409. o HelpText 
  410. o HintText 
  411. o Accelerator 
  412. o Change 
  413. o Insert 
  414. o Delete 
  415. o Edit event 
  416. o OK 
  417. o Arrow push buttons 
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ 1.4.1. Caption ΓòÉΓòÉΓòÉ
  421.  
  422. The Caption property is the text that appears in the menu or on the menu bar. 
  423. Mnemonic keys for the menu items may be specified by preceding a letter in the 
  424. caption with a tilde (~). The mnemonic letter appears underlined at run time. 
  425.  
  426. A horizontal line divider across a menu can be created by specifying a caption 
  427. consisting of a single hyphen (-). 
  428.  
  429. See the Menu editor  for more information. 
  430.  
  431.  
  432. ΓòÉΓòÉΓòÉ 1.4.2. Name ΓòÉΓòÉΓòÉ
  433.  
  434. The Name property is a unique name that identifies the menu item. A name is 
  435. automatically generated by VXΓêÖREXX, but can be changed by editing the text in 
  436. the name field. 
  437.  
  438. See the Menu editor  for more information. 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 1.4.3. Enabled ΓòÉΓòÉΓòÉ
  442.  
  443. The Enabled property specifies whether the menu item is enabled or not. If the 
  444. enabled check box contains a check mark, the menu or menu item will be 
  445. initially enabled at run time. 
  446.  
  447. See the Menu editor  for more information. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ 1.4.4. Checked ΓòÉΓòÉΓòÉ
  451.  
  452. The Checked property specifies whether there will be a check mark beside the 
  453. menu item. If the checked check box contains a check mark, the menu item will 
  454. initially have a check mark beside it at run time. 
  455.  
  456. See the Menu editor  for more information. 
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ 1.4.5. Level ΓòÉΓòÉΓòÉ
  460.  
  461. The Level value indicates the position of a menu or menu item within the menu 
  462. hierarchy: 
  463.  
  464. o Level 1 is on the menu bar. 
  465. o Level 2 is in the pull down menu under a level 1 item. 
  466. o Level 3 is a cascading menu from a level 2 item, and so on. 
  467.  
  468. See the Menu editor  for more information. 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 1.4.6. Change ΓòÉΓòÉΓòÉ
  472.  
  473. Pressing the Change button changes the values of the currently selected menu 
  474. item to the values currently set in the Caption  and Name  entry fields, and 
  475. the Enabled  and Checked  check boxes. 
  476.  
  477. See the Menu editor  for more information. 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 1.4.7. Insert ΓòÉΓòÉΓòÉ
  481.  
  482. Pressing the Insert button inserts a new item into the menu list at the 
  483. position of the currently selected item. 
  484.  
  485. See the Menu editor  for more information. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 1.4.8. Delete ΓòÉΓòÉΓòÉ
  489.  
  490. Pressing the Delete button deletes the currently selected item from the menu 
  491. list. 
  492.  
  493. See the Menu editor  for more information. 
  494.  
  495.  
  496. ΓòÉΓòÉΓòÉ 1.4.9. OK ΓòÉΓòÉΓòÉ
  497.  
  498. Pressing the OK button applies changes made to the menu. Until this button is 
  499. pressed changes made in the menu editor are not reflected in the program 
  500. window. 
  501.  
  502. See the Menu editor  for more information. 
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ 1.4.10. Edit Event ΓòÉΓòÉΓòÉ
  506.  
  507. Pressing the Edit event button opens the Section editor  so that you can edit 
  508. the Click event routine for the currently selected item. This is the only event 
  509. defined for menu items. 
  510.  
  511. See the Menu editor  for more information. 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 1.4.11. Arrow buttons ΓòÉΓòÉΓòÉ
  515.  
  516. The Arrow buttons allow you to move the items within the menu list. The up and 
  517. down arrow buttons change the order in which the items appear. The left and 
  518. right arrow buttons change the nesting level of the item. 
  519.  
  520. See the Menu editor  for more information. 
  521.  
  522.  
  523. ΓòÉΓòÉΓòÉ 1.4.12. HelpTag ΓòÉΓòÉΓòÉ
  524.  
  525. The HelpTag property is the resource identifier of the help panel corresponding 
  526. to the menu or menu item. 
  527.  
  528. See Adding help to a program or the Menu editor  for more information. 
  529.  
  530.  
  531. ΓòÉΓòÉΓòÉ 1.4.13. HelpText ΓòÉΓòÉΓòÉ
  532.  
  533. The HelpText property is the text or the name of a text file to display when 
  534. help is requested for the menu or menu item. 
  535.  
  536. See Adding help to a program or the Menu editor  for more information. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 1.4.14. HintText ΓòÉΓòÉΓòÉ
  540.  
  541. The HintText property is the text that is displayed in the window's status area 
  542. when the item has the input focus, or when the mouse pointer is positioned over 
  543. the item. For this facility to work, the window's StatusArea and ShowHints 
  544. properties must be set to 1. 
  545.  
  546. See Adding help to a program or the Menu editor  for more information. 
  547.  
  548.  
  549. ΓòÉΓòÉΓòÉ 1.4.15. Accelerator ΓòÉΓòÉΓòÉ
  550.  
  551. The Accelerator property is the string representing the key combination which 
  552. activates the menu item. At run time, pressing the keys that make up a menu 
  553. item's accelerator is the same as clicking on that menu item. The menu does not 
  554. have to be open for the accelerator key to take effect. 
  555.  
  556. See Adding help to a program or the Menu editor  for more information. 
  557.  
  558.  
  559. ΓòÉΓòÉΓòÉ 1.5. The Run menu ΓòÉΓòÉΓòÉ
  560.  
  561. The Run menu contains commands to run and debug the current project. This 
  562. allows you to quickly test the project as you create it. 
  563.  
  564. See also: 
  565.  
  566. o Run project 
  567. o Debug project 
  568.  
  569. See Creating and running projects in the VXΓêÖREXX Programmer's Guide for more 
  570. information about running projects. 
  571.  
  572.  
  573. ΓòÉΓòÉΓòÉ 1.5.1. Run Project ΓòÉΓòÉΓòÉ
  574.  
  575. Use the Run Project command to run the current project. This allows seamless 
  576. testing of the project during development. 
  577.  
  578. If VXΓêÖREXX encounters any errors during execution, the program will terminate, 
  579. and you will return to the VXΓêÖREXX programming facility. A list of the errors 
  580. will be displayed in the Error window  allowing you to edit the sections in 
  581. which the errors occurred. 
  582.  
  583. See the Run menu  for more information. 
  584.  
  585.  
  586. ΓòÉΓòÉΓòÉ 1.5.2. Debug project ΓòÉΓòÉΓòÉ
  587.  
  588. Use the Debug project command to run the project using VXΓêÖREXX's interactive 
  589. debugger. Use the debugger to help you find errors in your project. 
  590.  
  591. Refer to the chapter Debugging a project in the VXΓêÖREXX Programmer's Guide, or 
  592. the Debugger help  for information on using the debugger. 
  593.  
  594. See the Run menu  for more information. 
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ 1.6. The Options menu ΓòÉΓòÉΓòÉ
  598.  
  599. The Options menu contains commands to configure the VXΓêÖREXX development 
  600. environment. 
  601.  
  602. See also: 
  603.  
  604. o External editor 
  605. o Run 
  606. o Add object library 
  607. o Remove object library 
  608.  
  609.  
  610. ΓòÉΓòÉΓòÉ 1.6.1. External editor ΓòÉΓòÉΓòÉ
  611.  
  612. The External editor command presents a dialog which allows you to configure the 
  613. external editor used by VXΓêÖREXX. The external editor can be invoked from the 
  614. File list  window or the Section list  window. The default external editor is 
  615. the OS/2 Enhanced editor. 
  616.  
  617. See also: 
  618.  
  619. o Options menu 
  620. o Edit command  field 
  621. o Default  button 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ 1.6.2. Edit command ΓòÉΓòÉΓòÉ
  625.  
  626. Use the Edit command field to specify the editor to be invoked when the 
  627. External editor  command is used. 
  628.  
  629. For more information, see Using an external editor in Adding and modifying 
  630. routines in the VXΓêÖREXX Programmer's Guide. 
  631.  
  632.  
  633. ΓòÉΓòÉΓòÉ 1.6.3. Default ΓòÉΓòÉΓòÉ
  634.  
  635. Pressing the Default button resets the Edit command  field to its default 
  636. value. The default command invokes the OS/2 Enhanced Editor. 
  637.  
  638. For more information, see Using an external editor in Adding and modifying 
  639. routines in the VXΓêÖREXX Programmer's Guide. 
  640.  
  641.  
  642. ΓòÉΓòÉΓòÉ 1.6.4. Run ΓòÉΓòÉΓòÉ
  643.  
  644. Use the Run command in the Options menu to specify command line parameters, 
  645. change the working directory, and set the main window file for your 
  646. application. These settings are used when you choose the Run project  or Debug 
  647. project  command from the Run  menu. 
  648.  
  649. See also: 
  650.  
  651. o Options menu 
  652. o Main file 
  653. o Arguments 
  654. o Working directory 
  655.  
  656.  
  657. ΓòÉΓòÉΓòÉ 1.6.5. Main file ΓòÉΓòÉΓòÉ
  658.  
  659. Use the Main file combination box to specify which file in your project should 
  660. serve as the entry point for your application when it is run. For projects with 
  661. only one file, this option cannot be changed. 
  662.  
  663. See the chapter Multiple file projects in the VXΓêÖREXX Programmer's Guide for 
  664. more information about multiple file projects, and selecting a main file. 
  665.  
  666.  
  667. ΓòÉΓòÉΓòÉ 1.6.6. Arguments ΓòÉΓòÉΓòÉ
  668.  
  669. Use the Arguments field to specify command line options to be passed to your 
  670. project when it is started. These arguments should be entered in a format 
  671. appropriate to the way in which your project receives and interprets command 
  672. line options. 
  673.  
  674. The value that is entered in this field becomes the CommandLine property of 
  675. your application. 
  676.  
  677.  
  678. ΓòÉΓòÉΓòÉ 1.6.7. Working directory ΓòÉΓòÉΓòÉ
  679.  
  680. Use the Working directory field to specify the working directory to use when 
  681. running the project with the Run project  or Debug project  commands. This 
  682. value becomes the WorkingDirectory property of your application. You may need 
  683. to set this property if you project makes assumptions about the current working 
  684. directory. 
  685.  
  686. If you started VXΓêÖREXX by double clicking on a project file then the default 
  687. working directory is the directory that contains the project file. Otherwise it 
  688. is the VXΓêÖREXX install directory. 
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 1.6.8. Add object library ΓòÉΓòÉΓòÉ
  692.  
  693. Use the Add object library command to add a library of extended objects to the 
  694. current project. Object libraries can also be removed from a project, using the 
  695. Remove object library command. 
  696.  
  697. These libraries are available from WATCOM. See Contacting WATCOM in the Read Me 
  698. First document, or the WATCOM VXΓêÖREXX for OS/2 Programmer's Guide and Reference 
  699. for information about contacting WATCOM. 
  700.  
  701. See also 
  702.  
  703. o Options menu 
  704.  
  705.  
  706. ΓòÉΓòÉΓòÉ 1.6.9. Remove object library ΓòÉΓòÉΓòÉ
  707.  
  708. Use the Remove object library command to remove a library of extended objects 
  709. from the current project which was previously added with the Add object library 
  710. command. 
  711.  
  712. These libraries are available from WATCOM. See Contacting WATCOM in the Read Me 
  713. First document, or the WATCOM VXΓêÖREXX for OS/2 Programmer's Guide and Reference 
  714. for information about contacting WATCOM. 
  715.  
  716. See also 
  717.  
  718. o Options menu 
  719.  
  720.  
  721. ΓòÉΓòÉΓòÉ 1.7. The Project menu ΓòÉΓòÉΓòÉ
  722.  
  723. The Project menu allows you to open, save, and create new project files. 
  724.  
  725. See the chapter Creating and running projects in the VXΓêÖREXX Programmer's Guide 
  726. for more information about projects and project management. 
  727.  
  728. See also: 
  729.  
  730. o New 
  731. o Open 
  732. o Save 
  733. o Save as 
  734. o New window file 
  735. o New code file 
  736. o Make EXE file 
  737. o Make macro 
  738.  
  739.  
  740. ΓòÉΓòÉΓòÉ 1.7.1. New ΓòÉΓòÉΓòÉ
  741.  
  742. Use the New command to create a new project. If changes have been made to the 
  743. current project, and you have not saved them, then you will be prompted to do 
  744. so. Should you choose not to save your changes, they will be discarded. 
  745.  
  746. See the Project menu  for more information. 
  747.  
  748.  
  749. ΓòÉΓòÉΓòÉ 1.7.2. Open ΓòÉΓòÉΓòÉ
  750.  
  751. Use the Open command to open an existing project. Selecting Open will cause the 
  752. Open dialog to appear. You may select a drive, directory, and filename of the 
  753. project you wish to open. 
  754.  
  755. Opening a project closes the current project. If you have made changes to the 
  756. current project, then you will be prompted to save them before the Open dialog 
  757. appears. Should you choose not to save your changes, they will be discarded. 
  758.  
  759. See the Project menu  for more information. 
  760.  
  761.  
  762. ΓòÉΓòÉΓòÉ 1.7.3. Save ΓòÉΓòÉΓòÉ
  763.  
  764. Use the Save command to save the current project using the current project 
  765. filenames. If the project is new or contains new files the Save as  dialog 
  766. appears to allow you to specify the required filenames. 
  767.  
  768. See the Project menu  for more information. 
  769.  
  770.  
  771. ΓòÉΓòÉΓòÉ 1.7.4. Save as ΓòÉΓòÉΓòÉ
  772.  
  773. Use the Save as command to save the files in the current project with a new 
  774. path or name. 
  775.  
  776. Each of the source files (extension VRX) and the project file itself (extension 
  777. VRP) is saved separately and requires a path and filename. When you Save a new 
  778. project, or select Save as, you will be prompted for a name for each file, 
  779. starting with the source files and ending with the project file. If you Save a 
  780. project that has been saved before but contains some new files you will be 
  781. prompted to name only the new files. 
  782.  
  783. Although it is not required, the normal organization is to place all project 
  784. files in the same directory and use a different directory for each project. 
  785. This is automatically accomplished if you create new projects by dragging and 
  786. dropping the project template, as described in Creating and running projects in 
  787. the VXΓêÖREXX Programmer's Guide. 
  788.  
  789. See the Project menu  for more information. 
  790.  
  791.  
  792. ΓòÉΓòÉΓòÉ 1.7.5. New window file ΓòÉΓòÉΓòÉ
  793.  
  794. Use the New window file command to create a new window within the project. The 
  795. window that is currently being edited is stored and may be retrieved through 
  796. the File list  window found in the Windows  menu. 
  797.  
  798. See the Project menu  for more information. 
  799.  
  800.  
  801. ΓòÉΓòÉΓòÉ 1.7.6. New code file ΓòÉΓòÉΓòÉ
  802.  
  803. Use the New code file command to create a new code-only file. The new code file 
  804. does not have an association with a window, so no new window is shown on the 
  805. screen. You may create labels for the new code file using the Section list 
  806. window found in the Windows  menu. 
  807.  
  808. See the Project menu  for more information. 
  809.  
  810.  
  811. ΓòÉΓòÉΓòÉ 1.7.7. Make macro ΓòÉΓòÉΓòÉ
  812.  
  813. Use the Make macro command to create a REXX macro from the current project. The 
  814. macros created may be used with REXX-aware Presentation Manager applications 
  815. such as the OS/2 Enhanced Editor. 
  816.  
  817.  The REXX code from each file in the project is saved as a plain text file. The 
  818. corresponding windows are saved in files with the same names as the REXX code 
  819. files but with the extension VRW. The default name for the first file is the 
  820. name of the project; the default name for the rest is their current name. 
  821.  
  822. The VXΓêÖREXX run time libraries must be installed and included in you OS/2 
  823. LIBPATH before you can run a VXΓêÖREXX macro. Also, the application that invokes 
  824. the macro must be running in a Presentation Manager session. 
  825.  
  826. See the Project menu  for more information. 
  827.  
  828.  
  829. ΓòÉΓòÉΓòÉ 1.7.8. Make EXE file ΓòÉΓòÉΓòÉ
  830.  
  831. Use the Make EXE file command to compile your current project into a single 
  832. executable file that can be run from the OS/2 command line or Workplace Shell. 
  833.  
  834. You can specify an icon for the executable program either by using the General 
  835. page in the Settings notebook of the program's object in the Workplace Shell, 
  836. or by placing an icon file (extension ICO) with the same name as the program in 
  837. the same directory as the program. The program's icon will be used for the 
  838. Workplace Shell, for the system menu on the program's windows, and for the 
  839. minimized representation of the program's windows. 
  840.  
  841. The VXΓêÖREXX run time libraries must be installed and included in you OS/2 
  842. LIBPATH before you can run a VXΓêÖREXX executable file. The VXΓêÖREXX executable is 
  843. a Presentation Manager program and runs in a Presentation Manager session. 
  844.  
  845. See the Project menu  for more information. 
  846.  
  847.  
  848. ΓòÉΓòÉΓòÉ 1.8. The Windows menu ΓòÉΓòÉΓòÉ
  849.  
  850. The Windows menu commands open and activate the VXΓêÖREXX secondary windows. If a 
  851. window is not already opened it is opened. Otherwise it is brought to the front 
  852. of the display and activated. 
  853.  
  854. See also: 
  855.  
  856. o Errors 
  857. o File list 
  858. o Section list 
  859. o Tool palette 
  860. o Window list 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 1.8.1. The Errors window ΓòÉΓòÉΓòÉ
  864.  
  865. Use the Errors command to display the Error window. The Error window contains 
  866. information on any errors that occurred during the most recent run of the 
  867. project. 
  868.  
  869. If you run your project and there is an error, this window is displayed 
  870. automatically. Closing and reopening the Error window does not change its 
  871. contents. It is only updated the next time the project is run. 
  872.  
  873. The window displays the error, the name of the section that it occurred in, and 
  874. a traceback of the calls that lead to the error. You can edit any of the code 
  875. shown in the traceback list by double clicking in the list or by selecting an 
  876. item and choosing Open for the section editor or External editor for the editor 
  877. configured in the Options  menu. 
  878.  
  879. See the chapter Debugging a project in the VXΓêÖREXX Programmer's Guide for more 
  880. information about finding and fixing errors in your projects. 
  881.  
  882.  
  883. ΓòÉΓòÉΓòÉ 1.9. The Tool palette window ΓòÉΓòÉΓòÉ
  884.  
  885. Use the Tool palette command to display the Tool palette window. The tool 
  886. palette is opened automatically when VXΓêÖREXX is started, but you can close if 
  887. you are not using it. 
  888.  
  889. The Tool palette provides easy access to all of the items in the Tools  menu. 
  890. Pressing a button in the Tool palette is the same as selecting the 
  891. corresponding item from the Tools  menu. To find out which item each button 
  892. represents, simply click on the button and press F1. 
  893.  
  894. For more information about adding objects to a project and using the Tool 
  895. palette, see the chapter Adding objects to a window in the VXΓêÖREXX Programmer's 
  896. Guide. 
  897.  
  898. See also: 
  899.  
  900. o Pointer 
  901. o CheckBox 
  902. o ComboBox 
  903. o DescriptiveText 
  904. o DropDownComboBox 
  905. o EntryField 
  906. o GroupBox 
  907. o ImagePushButton 
  908. o ImageRadioButton 
  909. o ListBox 
  910. o MultiLineEntryField 
  911. o PictureBox 
  912. o PushButton 
  913. o RadioButton 
  914. o SpinButton 
  915.  
  916.  
  917. ΓòÉΓòÉΓòÉ 1.10. The File list window ΓòÉΓòÉΓòÉ
  918.  
  919. Use the File list command to open the File list window. This window lists all 
  920. of the source files in the project. Each file is either a window file or a code 
  921. file. Double clicking on a file in the list opens the file so it can be edited. 
  922.  
  923. Using the file list's File menu. you can create, open, and save project files. 
  924. You can also edit all of the code in a source file at once using the External 
  925. editor command. 
  926.  
  927. You can share files with another project using the Add command, or you can make 
  928. a copy of an existing file with the Load command. The Remove command removes 
  929. files from the project (but does not delete the file). 
  930.  
  931. The Save as text command saves a project file in plain text form (including all 
  932. window information). The text file can be printed, or it can be edited with a 
  933. text editor and reloaded with the Load command. 
  934.  
  935. See also: 
  936.  
  937. o New window file 
  938. o New code file 
  939. o Open 
  940. o Add 
  941. o Remove 
  942. o Save 
  943. o Save as 
  944. o Load 
  945. o Save as text 
  946. o External editor 
  947.  
  948. See the chapter Multiple file projects in the VXΓêÖREXX Programmer's Guide for 
  949. more information about using multiple files. 
  950.  
  951.  
  952. ΓòÉΓòÉΓòÉ 1.10.1. New window file ΓòÉΓòÉΓòÉ
  953.  
  954. Use the New window file command to create a new file and primary window within 
  955. the project. The file that is currently being edited is closed and can be 
  956. reopened using the Open  command. 
  957.  
  958. See the File list window  for more information. 
  959.  
  960.  
  961. ΓòÉΓòÉΓòÉ 1.10.2. New code file ΓòÉΓòÉΓòÉ
  962.  
  963. Use the New code file command to create a new file that does not have a window 
  964. associated with it. 
  965.  
  966. The new code file will contain a Main section. You can create other sections 
  967. using the Section list  window in the Windows  menu. 
  968.  
  969. See the File list window  for more information. 
  970.  
  971.  
  972. ΓòÉΓòÉΓòÉ 1.10.3. Open ΓòÉΓòÉΓòÉ
  973.  
  974. Use the Open command to open the selected file for editing. The file currently 
  975. being edited is closed, but can be reopened with this command. 
  976.  
  977. See the File list window  for more information. 
  978.  
  979.  
  980. ΓòÉΓòÉΓòÉ 1.10.4. Add ΓòÉΓòÉΓòÉ
  981.  
  982. Use the Add command to add a file into the current project. The file can be 
  983. part of an existing project, either a window or code file, or it can be a text 
  984. file containing REXX routines. The file is not copied, the Add command only 
  985. creates a reference to the file. This allows files to be shared between 
  986. projects. 
  987.  
  988. See the File list window  for more information. 
  989.  
  990.  
  991. ΓòÉΓòÉΓòÉ 1.10.5. Remove ΓòÉΓòÉΓòÉ
  992.  
  993. Use the Remove command to remove the selected file from the current project. 
  994. New, unsaved files are removed completely. Only the reference to saved files is 
  995. removed; the file is not deleted. 
  996.  
  997. See the File list window  for more information. 
  998.  
  999.  
  1000. ΓòÉΓòÉΓòÉ 1.10.6. Save ΓòÉΓòÉΓòÉ
  1001.  
  1002. Use the Save command to save the selected file with its current filename. The 
  1003. old contents of the file are overwritten. If you have not saved the file 
  1004. before, the Save as  dialog will appear and prompt you for a filename. 
  1005.  
  1006. See the File list window  for more information. 
  1007.  
  1008.  
  1009. ΓòÉΓòÉΓòÉ 1.10.7. Save As ΓòÉΓòÉΓòÉ
  1010.  
  1011. Use the Save as command to save the selected file with a new filename. The Save 
  1012. as dialog will appear and prompt you for a new filename. 
  1013.  
  1014. See the File list window  for more information. 
  1015.  
  1016.  
  1017. ΓòÉΓòÉΓòÉ 1.10.8. Load ΓòÉΓòÉΓòÉ
  1018.  
  1019. Use the Load command to copy an existing source file into the current project. 
  1020. The source file can be a window file, a code file, a file that has been saved 
  1021. as text, or a plain text file that contains REXX code. Loading a file creates a 
  1022. new copy of the original file. The new file only exists in the current 
  1023. environment until you save it, at which time you will need to give it a path 
  1024. and filename. A file with extension VRX is assumed to be a VXΓêÖREXX source file. 
  1025. If a file with the same name but extension VRY exists in the same directory the 
  1026. pair of files is assumed to be a VXΓêÖREXX window file. 
  1027.  
  1028. A file with the extension VRT is assumed to be a VXΓêÖREXX file that was created 
  1029. with the Save as text command. You can save a file in text format, edit the 
  1030. file using a text editor, then load the modified file. 
  1031.  
  1032. A file with any other extension is assumed to contain plain REXX code. You can 
  1033. use the Load command to copy your existing REXX source into a VXΓêÖREXX project. 
  1034. All the code in the original file will be placed into the Main section of the 
  1035. new file. 
  1036.  
  1037. To copy an object from another project you can load the window file containing 
  1038. the object, copy the object into the VXΓêÖREXX clipboard, and then remove the 
  1039. window file. 
  1040.  
  1041. See the File list window  for more information. 
  1042.  
  1043.  
  1044. ΓòÉΓòÉΓòÉ 1.10.9. Save as text ΓòÉΓòÉΓòÉ
  1045.  
  1046. Use the Save as text command to save the current file as text (including the 
  1047. window information). You can modify the text file using a text editor, and then 
  1048. load the file back into your project with the Load  command. 
  1049.  
  1050. See the File list window  for more information. 
  1051.  
  1052.  
  1053. ΓòÉΓòÉΓòÉ 1.10.10. External editor ΓòÉΓòÉΓòÉ
  1054.  
  1055. Use the External editor command to edit all of the routines in the selected 
  1056. file at once. The editor specified using the  External editor  command dialog 
  1057. in the Options  menu is invoked by this command. 
  1058.  
  1059. You cannot use this command on the current file. If the file selected is the 
  1060. current file, you will be given a chance to close the file so you can edit its 
  1061. code, or to cancel the selection. 
  1062.  
  1063. See the File list window  for more information. 
  1064.  
  1065.  
  1066. ΓòÉΓòÉΓòÉ 1.11. The Section list window ΓòÉΓòÉΓòÉ
  1067.  
  1068. Use the Section list command to open the Section list window. The Section list 
  1069. window displays the sections of the file that you are working on. Double click 
  1070. on a section label to edit the code for that section using the Section editor. 
  1071.  
  1072. See the chapter Adding and modifying routines in the VXΓêÖREXX Programmer's Guide 
  1073. for more information on using the Section editor   , and on adding routines to 
  1074. your project. 
  1075.  
  1076. The Section menu of the section list contains commands to create, delete and 
  1077. edit the sections of the current file. As a section is only a part of a file, 
  1078. there are no commands to add, save, or load sections. These operations can only 
  1079. be performed on entire files. 
  1080.  
  1081. See also: 
  1082.  
  1083. o New 
  1084. o Open 
  1085. o Delete 
  1086. o External editor 
  1087.  
  1088.  
  1089. ΓòÉΓòÉΓòÉ 1.11.1. New ΓòÉΓòÉΓòÉ
  1090.  
  1091. Use the New command to create a new section within a file. Unlike files, 
  1092. sections are named when they are created. 
  1093.  
  1094. See the Section list  window for more information. 
  1095.  
  1096.  
  1097. ΓòÉΓòÉΓòÉ 1.11.2. Open ΓòÉΓòÉΓòÉ
  1098.  
  1099. Use the Open command to open the selected section for editing using the Section 
  1100. editor. 
  1101.  
  1102. See the Section list   window for more information. 
  1103.  
  1104.  
  1105. ΓòÉΓòÉΓòÉ 1.11.3. External editor ΓòÉΓòÉΓòÉ
  1106.  
  1107. Use the External editor command to open the selected section for editing using 
  1108. an external editor. As VXΓêÖREXX cannot control the external editor you must be 
  1109. careful to save the section before saving or running the project. 
  1110.  
  1111. See the Section list  window for more information. 
  1112.  
  1113.  
  1114. ΓòÉΓòÉΓòÉ 1.11.4. Delete ΓòÉΓòÉΓòÉ
  1115.  
  1116. Use the Delete command to delete the selected section from the current source 
  1117. file. 
  1118.  
  1119. See the Section list  window for more information. 
  1120.  
  1121.  
  1122. ΓòÉΓòÉΓòÉ 1.12. The Window list window ΓòÉΓòÉΓòÉ
  1123.  
  1124. Use the Window list command to open the Window list window. This window lists 
  1125. the primary and secondary windows associated with a single window file. The 
  1126. window list and multiple windows within a single file are normally only used in 
  1127. projects that feature multiple modeless windows (i.e. multiple windows enabled 
  1128. at the same time, such as in VXΓêÖREXX itself). For modal windows, where only one 
  1129. window is enabled at a time, you should use multiple files and the File list 
  1130. window. 
  1131.  
  1132. The Window menu of window list contains commands to create, open, close, and 
  1133. delete the windows within one window file. 
  1134.  
  1135. For more information on working with multiple windows, see the chapter Multiple 
  1136. modeless windows in the VXΓêÖREXX Programmer's Guide. 
  1137.  
  1138. See also: 
  1139.  
  1140. o New window 
  1141. o Open 
  1142. o Close 
  1143. o Delete 
  1144.  
  1145.  
  1146. ΓòÉΓòÉΓòÉ 1.12.1. New window ΓòÉΓòÉΓòÉ
  1147.  
  1148. Use the New window command to create a new secondary window. Secondary windows 
  1149. are not loaded automatically when a file is loaded. They must be loaded by 
  1150. calling the VRLoadSecondary function at run time. 
  1151.  
  1152. See the Window list window  for more information. 
  1153.  
  1154.  
  1155. ΓòÉΓòÉΓòÉ 1.12.2. Open ΓòÉΓòÉΓòÉ
  1156.  
  1157. Use the Open command to display the selected window. 
  1158.  
  1159. See the Window list window  for more information. 
  1160.  
  1161.  
  1162. ΓòÉΓòÉΓòÉ 1.12.3. Close ΓòÉΓòÉΓòÉ
  1163.  
  1164. Use the Close command to hide the selected window. Closed windows can be 
  1165. redisplayed with the Open  command. 
  1166.  
  1167. See the Window list window  for more information. 
  1168.  
  1169.  
  1170. ΓòÉΓòÉΓòÉ 1.12.4. Delete ΓòÉΓòÉΓòÉ
  1171.  
  1172. Use the Delete command to delete a secondary window from the current file. All 
  1173. objects in the window, and all code associated with the window and its objects 
  1174. are also deleted. 
  1175.  
  1176. See the Window list window  for more information. 
  1177.  
  1178.  
  1179. ΓòÉΓòÉΓòÉ 1.13. The Section editor ΓòÉΓòÉΓòÉ
  1180.  
  1181. To simplify the creation and maintenance of programs, VXΓêÖREXX divides REXX code 
  1182. files into sections. Each section of a file contains one or more REXX routines 
  1183. that can be edited together. Sections have no effect at run time: all the 
  1184. sections in a file appear to REXX as a single program file. 
  1185.  
  1186.  The VXΓêÖREXX section editor is a full-featured text editor provided to edit 
  1187. sections. The section editor is opened from the Section list  or Error  window 
  1188. by double clicking on the name of a section, or from the Event page of a 
  1189. Properties  notebook by double clicking on the name of an event. The section 
  1190. editor automatically starts with the selected section loaded. Any number of 
  1191. Section editor windows can be open at the same time, so you can edit several 
  1192. sections at once. It is not necessary to save or close a section before running 
  1193. or saving a project, as the contents of a section editor always reflect the 
  1194. current value of the section. 
  1195.  
  1196. For more information on the Section editor, see the chapter Adding and 
  1197. modifying routines in the VXΓêÖREXX Programmer's Guide. 
  1198.  
  1199. The Section editor has two menus: 
  1200.  
  1201. Edit           The Edit menu contains commands to edit the text in the 
  1202.                section.. 
  1203.  
  1204. Help           The Help menu provides access to information about the Section 
  1205.                editor. 
  1206.  
  1207. The section editor includes a status area under the menu bar and above the text 
  1208. area. In this area it displays the current line number and column position, and 
  1209. indicates whether new text will replace the text under the cursor (Overstrike) 
  1210. or will be inserted at the cursor (Insert). Press the Insert key to toggle 
  1211. between insert and overstrike mode. 
  1212.  
  1213.  
  1214. ΓòÉΓòÉΓòÉ 1.13.1. Edit ΓòÉΓòÉΓòÉ
  1215.  
  1216. The Edit menu contains commands to select, cut, and past, to find and replace, 
  1217. and to read and write files. It also includes an Undo command to undo the last 
  1218. operation. 
  1219.  
  1220. For more information on the Section editor   , see the chapter Adding and 
  1221. modifying routines in the VXΓêÖREXX Programmer's Guide. 
  1222.  
  1223. See also: 
  1224.  
  1225. o Undo 
  1226. o Revert 
  1227. o Cut 
  1228. o Copy 
  1229. o Paste 
  1230. o Delete 
  1231. o Find 
  1232. o Replace 
  1233. o Select all 
  1234. o Deselect all 
  1235. o Go 
  1236. o Import 
  1237. o Export 
  1238.  
  1239.  
  1240. ΓòÉΓòÉΓòÉ 1.13.2. Undo ΓòÉΓòÉΓòÉ
  1241.  
  1242. Use the Undo command to undo the last operation. For example, after deleting a 
  1243. line, choosing Undo brings that line back. 
  1244.  
  1245. See the Edit menu  for more information. 
  1246.  
  1247.  
  1248. ΓòÉΓòÉΓòÉ 1.13.3. Revert ΓòÉΓòÉΓòÉ
  1249.  
  1250. Use the Revert command to throw away all changes since the section was opened 
  1251. for editing. This action cannot be undone. 
  1252.  
  1253. See the Edit menu  for more information. 
  1254.  
  1255.  
  1256. ΓòÉΓòÉΓòÉ 1.13.4. Cut ΓòÉΓòÉΓòÉ
  1257.  
  1258.  Cut removes the selected text and copies it to the OS/2 clipboard. Text in the 
  1259. OS/2 clipboard can be pasted into any section. It also can be pasted into other 
  1260. OS/2 applications such as text editors. 
  1261.  
  1262. See Section editor  for more information. 
  1263.  
  1264.  
  1265. ΓòÉΓòÉΓòÉ 1.13.5. Copy ΓòÉΓòÉΓòÉ
  1266.  
  1267.  Copy copies the selected text to the OS/2 clipboard. Text in the OS/2 
  1268. clipboard can be pasted into any section. It also can be pasted into other OS/2 
  1269. applications such as text editors. 
  1270.  
  1271. See Section editor  for more information. 
  1272.  
  1273.  
  1274. ΓòÉΓòÉΓòÉ 1.13.6. Paste ΓòÉΓòÉΓòÉ
  1275.  
  1276. Paste copies text from the OS/2 clipboard to the section. The pasted text 
  1277. replaces any selected text, otherwise it is inserted at the cursor position. 
  1278. Text can be copied to the clipboard from any section or from other OS/2 
  1279. applications such as text editors. Text can be pasted any number of times, as 
  1280. pasting does not erase the contents of the clipboard. 
  1281.  
  1282. See Section editor  for more information. 
  1283.  
  1284.  
  1285. ΓòÉΓòÉΓòÉ 1.13.7. Delete ΓòÉΓòÉΓòÉ
  1286.  
  1287. The selected text is deleted from the section. The text can be recovered by 
  1288. immediately using the Undo  command. 
  1289.  
  1290. See Section editor  for more information. 
  1291.  
  1292.  
  1293. ΓòÉΓòÉΓòÉ 1.13.8. Find ΓòÉΓòÉΓòÉ
  1294.  
  1295. Use the Find command to open the Find window. Enter the text to locate in the 
  1296. Target field and select the OK button. If the target text is in the section, 
  1297. the first occurrence of the target text in the section will be selected. The 
  1298. case of the text is ignored when searching for a match. 
  1299.  
  1300. The Find command only searches forward from the current cursor position. To 
  1301. search the entire section, press Ctrl+Home in the text area before starting the 
  1302. search. It is not necessary to close the Find window to reposition the cursor 
  1303. or to continue editing. 
  1304.  
  1305. See Section editor  for more information. 
  1306.  
  1307.  
  1308. ΓòÉΓòÉΓòÉ 1.13.9. Replace ΓòÉΓòÉΓòÉ
  1309.  
  1310. Use the Replace command to open the Replace window. Enter the  text to locate 
  1311. in the Target field, and the replacement text in the Replacement field. To 
  1312. locate the next match, select the Find button. (The case of the text is ignored 
  1313. when searching for a match). To replace the located text select the Replace 
  1314. button. To find the next match and replace it in one step start by selecting 
  1315. the Replace button. To find and replace all occurrences of the target text, 
  1316. press the Replace all button. 
  1317.  
  1318. The Find, Replace, and Replace All commands only search forward from the 
  1319. current cursor position. To search the entire section, press Ctrl+Home in the 
  1320. text area before starting the search. It is not necessary to close the Replace 
  1321. window to reposition the cursor or to continue editing. 
  1322.  
  1323. See Section editor  for more information. 
  1324.  
  1325.  
  1326. ΓòÉΓòÉΓòÉ 1.13.10. Select all ΓòÉΓòÉΓòÉ
  1327.  
  1328. Use the Select all command to select all of the text in the section. 
  1329.  
  1330. See Section editor  for more information. 
  1331.  
  1332.  
  1333. ΓòÉΓòÉΓòÉ 1.13.11. Deselect all ΓòÉΓòÉΓòÉ
  1334.  
  1335. Use the Deselect all command to ensure that nothing is selected in the section. 
  1336.  
  1337. See Section editor  for more information. 
  1338.  
  1339.  
  1340. ΓòÉΓòÉΓòÉ 1.13.12. Go ΓòÉΓòÉΓòÉ
  1341.  
  1342. Use the Go command to move to a specified line number. 
  1343.  
  1344. See Section editor  for more information. 
  1345.  
  1346.  
  1347. ΓòÉΓòÉΓòÉ 1.13.13. Import ΓòÉΓòÉΓòÉ
  1348.  
  1349. Use the Import command to insert a text file into the section. The imported 
  1350. text replaces any selected text, otherwise it is inserted at the cursor 
  1351. position. 
  1352.  
  1353. See Section editor  for more information. 
  1354.  
  1355.  
  1356. ΓòÉΓòÉΓòÉ 1.13.14. Export ΓòÉΓòÉΓòÉ
  1357.  
  1358. Use the Export command to save the selected text to a file. 
  1359.  
  1360. See Section editor  for more information. 
  1361.  
  1362.  
  1363. ΓòÉΓòÉΓòÉ 1.14. Help for Help ΓòÉΓòÉΓòÉ
  1364.  
  1365. Use the commands in the Help menu to display: 
  1366.  
  1367. o An index of references to the help topics for the active program 
  1368. o General information about the contents of the active window 
  1369. o General information about the help facility 
  1370. o A list and description of keys you can use 
  1371. o Product information for the active program 
  1372.  
  1373.  
  1374. ΓòÉΓòÉΓòÉ 1.14.1. Product information ΓòÉΓòÉΓòÉ
  1375.  
  1376. The Product information command presents a dialog box which gives information 
  1377. about the VXΓêÖREXX product, such as copyright information and the product 
  1378. version. 
  1379.  
  1380.  
  1381. ΓòÉΓòÉΓòÉ 1.14.2. Help for General help ΓòÉΓòÉΓòÉ
  1382.  
  1383. Use General help to display information about the contents of the active 
  1384. window. 
  1385.  
  1386.  
  1387. ΓòÉΓòÉΓòÉ 1.15. A list of functions ΓòÉΓòÉΓòÉ
  1388.  
  1389. For a brief description of all VXΓêÖREXX functions, see Summary of functions in 
  1390. the VXΓêÖREXX Reference. 
  1391.  
  1392. See also: 
  1393.  
  1394. o VRChAttr 
  1395. o VRChDir 
  1396. o VRChDrive 
  1397. o VRCopyFile 
  1398. o VRCreate 
  1399. o VRCreateFile 
  1400. o VRCreateStem 
  1401. o VRCurrDir 
  1402. o VRCurrDrive 
  1403. o VRDeleteFile 
  1404. o VRDelIni 
  1405. o VRDestroy 
  1406. o VRDir 
  1407. o VRDiskInfo 
  1408. o VRDiskLabel 
  1409. o VRError 
  1410. o VREvent 
  1411. o VRExpandFileName 
  1412. o VRFileDate 
  1413. o VRFileDialog 
  1414. o VRFileExists 
  1415. o VRFindFile 
  1416. o VRFini 
  1417. o VRGet 
  1418. o VRGetIni 
  1419. o VRInfo 
  1420. o VRInit 
  1421. o VRIsDir 
  1422. o VRLoad 
  1423. o VRLoadSecondary 
  1424. o VRMessage 
  1425. o VRMessageStem 
  1426. o VRMethod 
  1427. o VRMkDir 
  1428. o VRParseFileName 
  1429. o VRPrompt 
  1430. o VRRedirectStdIO 
  1431. o VRRenameFile 
  1432. o VRRmDir 
  1433. o VRSet 
  1434. o VRSetIni 
  1435. o VRVersion 
  1436. o VRWindow 
  1437. o VRWindowPath 
  1438.  
  1439.  
  1440. ΓòÉΓòÉΓòÉ 1.16. A list of methods ΓòÉΓòÉΓòÉ
  1441.  
  1442. For a brief description of all VXΓêÖREXX methods, see Summary of methods in the 
  1443. VXΓêÖREXX Reference. 
  1444.  
  1445. See also: 
  1446.  
  1447. o Activate 
  1448. o AddString 
  1449. o AddStringList 
  1450. o CenterWindow 
  1451. o Clear 
  1452. o Delete 
  1453. o DeleteList 
  1454. o DeleteString 
  1455. o Deselect 
  1456. o DeselectList 
  1457. o FindString 
  1458. o GetClipboard 
  1459. o GetSelectedList 
  1460. o GetSelectedStringList 
  1461. o GetString 
  1462. o GetStringList 
  1463. o GetThreadID 
  1464. o GetVar 
  1465. o HaltThread 
  1466. o InstallAccelerators 
  1467. o InvokeHelp 
  1468. o ListChildren 
  1469. o ListClasses 
  1470. o ListMethods 
  1471. o ListProperties 
  1472. o ListThreads 
  1473. o ListVars 
  1474. o ListWindows 
  1475. o LoadClassFile 
  1476. o Maximize 
  1477. o Minimize 
  1478. o Post 
  1479. o PostKeyString 
  1480. o PutClipboard 
  1481. o PutVar 
  1482. o Reset 
  1483. o Restore 
  1484. o SendKeyString 
  1485. o SetFocus 
  1486. o SetSelectedList 
  1487. o SetStringList 
  1488. o StartThread 
  1489. o SupportsMethod 
  1490. o SupportsProperty 
  1491.  
  1492.  
  1493. ΓòÉΓòÉΓòÉ 1.17. A list of objects ΓòÉΓòÉΓòÉ
  1494.  
  1495. For a brief description of all VXΓêÖREXX objects, see Summary of objects in the 
  1496. VXΓêÖREXX Reference. 
  1497.  
  1498. See also: 
  1499.  
  1500. o Application 
  1501. o CheckBox 
  1502. o ComboBox 
  1503. o DescriptiveText 
  1504. o DropDownComboBox 
  1505. o EntryField 
  1506. o GroupBox 
  1507. o ImagePushButton 
  1508. o ImageRadioButton 
  1509. o ListBox 
  1510. o Menu 
  1511. o MenuBar 
  1512. o MenuItem 
  1513. o MultiLineEntryField 
  1514. o PictureBox 
  1515. o PushButton 
  1516. o RadioButton 
  1517. o Screen 
  1518. o SpinButton 
  1519. o Window 
  1520.  
  1521.  
  1522. ΓòÉΓòÉΓòÉ 1.18. A list of properties ΓòÉΓòÉΓòÉ
  1523.  
  1524. For a brief description of all VXΓêÖREXX properties, see Summary of properties in 
  1525. the VXΓêÖREXX Reference. 
  1526.  
  1527. See also: 
  1528.  
  1529. o Accelerator 
  1530. o AdjustHeight 
  1531. o AlwaysUpdate 
  1532. o AutoScroll 
  1533. o AutoSize 
  1534. o BackColor 
  1535. o Border 
  1536. o BorderColor 
  1537. o BorderSize 
  1538. o BorderType 
  1539. o Cancel 
  1540. o Caption 
  1541. o Checked 
  1542. o ClassName 
  1543. o CommandLine 
  1544. o Count 
  1545. o Default 
  1546. o Enabled 
  1547. o FastSpin 
  1548. o FirstChild 
  1549. o Font 
  1550. o ForeColor 
  1551. o Height 
  1552. o HelpFile 
  1553. o HelpTag 
  1554. o HelpText 
  1555. o HelpTitle 
  1556. o HintText 
  1557. o HorizScroll 
  1558. o HWnd 
  1559. o IconHeight 
  1560. o IconWidth 
  1561. o Index 
  1562. o InitialList 
  1563. o InteriorHeight 
  1564. o InteriorLeft 
  1565. o InteriorTop 
  1566. o InteriorWidth 
  1567. o Justification 
  1568. o KeyString 
  1569. o LayoutStyle 
  1570. o Left 
  1571. o Masked 
  1572. o MaximizeButton 
  1573. o MinimizeButton 
  1574. o MoveWithParent 
  1575. o MultiSelect 
  1576. o Name 
  1577. o NumericOnly 
  1578. o PadWithZeros 
  1579. o Painting 
  1580. o Parent 
  1581. o PicturePath 
  1582. o Program 
  1583. o ReadOnly 
  1584. o ResizePicture 
  1585. o Selected 
  1586. o SelectedEnd 
  1587. o SelectedStart 
  1588. o SelectedString 
  1589. o SelectedText 
  1590. o Self 
  1591. o Set 
  1592. o ShowHints 
  1593. o ShutDown 
  1594. o Sibling 
  1595. o SiblingOrder 
  1596. o Sort 
  1597. o StatusArea 
  1598. o StatusText 
  1599. o SystemMenu 
  1600. o TabGroup 
  1601. o TabIndex 
  1602. o TabStop 
  1603. o TextLimit 
  1604. o Top 
  1605. o UserData 
  1606. o Value 
  1607. o VertJustification 
  1608. o VertScroll 
  1609. o Visible 
  1610. o Width 
  1611. o WindowMode 
  1612. o WordWrap 
  1613. o WorkingDirectory 
  1614.  
  1615.  
  1616. ΓòÉΓòÉΓòÉ 1.19. A list of events ΓòÉΓòÉΓòÉ
  1617.  
  1618. For a brief description of all VXΓêÖREXX events, see Summary of events in the 
  1619. VXΓêÖREXX Reference. 
  1620.  
  1621. See also: 
  1622.  
  1623. o Activate 
  1624. o Change 
  1625. o Click 
  1626. o Close 
  1627. o Create 
  1628. o Deactivate 
  1629. o Destroy 
  1630. o DoubleClick 
  1631. o GotFocus 
  1632. o KeyPress 
  1633. o LostFocus 
  1634. o Resize 
  1635.  
  1636.  
  1637. ΓòÉΓòÉΓòÉ 1.20. A summary of help topics ΓòÉΓòÉΓòÉ
  1638.  
  1639. The following is a listing of the chapters of the VXΓêÖREXX Programmer's Guide: 
  1640.  
  1641. o Introduction 
  1642. o A simple program 
  1643. o Creating and running projects 
  1644. o Adding objects to a window 
  1645. o Changing object properties 
  1646. o Adding and modifying routines 
  1647. o Programming with objects 
  1648. o Using objects 
  1649. o Adding menus to a program 
  1650. o Adding help to a program 
  1651. o Using dialogs and system functions 
  1652. o Multiple file projects 
  1653. o Multiple modeless windows 
  1654. o Debugging a project 
  1655. o Using command files and application macros 
  1656. o Database Manager with VXΓêÖREXX 
  1657.  
  1658.  
  1659. ΓòÉΓòÉΓòÉ 1.21. A summary of the REXX language ΓòÉΓòÉΓòÉ
  1660.  
  1661. A summary of the REXX language is provided in the OS/2 online document: REXX 
  1662. Information. 
  1663.  
  1664.  
  1665. ΓòÉΓòÉΓòÉ 1.22. A list of predefined routines ΓòÉΓòÉΓòÉ
  1666.  
  1667. For a brief description of all VXΓêÖREXX predefined routines, see Summary of 
  1668. predefined routines in the VXΓêÖREXX Reference. 
  1669.  
  1670. See also: 
  1671.  
  1672. o Fini 
  1673. o Halt 
  1674. o Init 
  1675. o Main 
  1676. o Quit 
  1677.  
  1678.  
  1679. ΓòÉΓòÉΓòÉ 2. Debugger Online Help ΓòÉΓòÉΓòÉ
  1680.  
  1681.  
  1682. ΓòÉΓòÉΓòÉ 2.1. Using the Debugger ΓòÉΓòÉΓòÉ
  1683.  
  1684. The VXΓêÖREXX debugging facility provides many advanced features. It provides 
  1685. variable and source displays, interactive debugging, breakpoints, and several 
  1686. more powerful debugging features. 
  1687.  
  1688. For more information on the menus, see: 
  1689.  
  1690. o Breakpoints menu 
  1691. o Run menu 
  1692. o Options menu 
  1693. o Windows menu 
  1694. o Edit menu 
  1695.  
  1696. For more information about the debugger windows, see: 
  1697.  
  1698. o Trace window 
  1699. o Variables window 
  1700. o Results window 
  1701. o Section list window 
  1702. o Section window 
  1703.  
  1704. For more information about debugging your projects, see Debugging a project in 
  1705. the VXΓêÖREXX Programmer's Guide. 
  1706.  
  1707.  
  1708. ΓòÉΓòÉΓòÉ 2.2. The Breakpoints Menu ΓòÉΓòÉΓòÉ
  1709.  
  1710. The Breakpoints menu contains commands to set and clear breakpoints in your 
  1711. REXX code. Breakpoints stop the running of your program when a set location 
  1712. within your code is reached. 
  1713.  
  1714. The Breakpoints menu is found on the following windows: 
  1715.  
  1716. o Trace 
  1717. o Section window 
  1718.  
  1719. See also: 
  1720.  
  1721. o Set 
  1722. o Clear 
  1723.  
  1724. See Debugging a project in the VXΓêÖREXX Programmer's Guide for more information 
  1725. on debugging your projects. 
  1726.  
  1727.  
  1728. ΓòÉΓòÉΓòÉ 2.2.1. Set ΓòÉΓòÉΓòÉ
  1729.  
  1730. The Set command displays a window asking for the file, section and line of the 
  1731. project in which to place the breakpoint. Choose the file and section with the 
  1732. drop down combination boxes. Then select the line at which to place the 
  1733. breakpoint. Click on the OK button to complete the setting. 
  1734.  
  1735. You can also set a breakpoint by double clicking on a line number in the trace 
  1736. window or any section window. The background color of the line number turns red 
  1737. to indicate that a breakpoint has been set. Double clicking on a line number 
  1738. with a breakpoint clears the breakpoint. 
  1739.  
  1740. See The Breakpoints menu for more information. 
  1741.  
  1742.  
  1743. ΓòÉΓòÉΓòÉ 2.2.2. Clear ΓòÉΓòÉΓòÉ
  1744.  
  1745. The Clear command displays a window with a list of current breakpoints. To 
  1746. delete a breakpoint, select it, and click on the OK button. To delete multiple 
  1747. breakpoints, hold down the Ctrl key and click on the breakpoints that you want 
  1748. to clear, then click OK. 
  1749.  
  1750. You can also set a breakpoint by double clicking on a line number in the trace 
  1751. window or any section window. The background color of the line number turns red 
  1752. to indicate that a breakpoint has been set. Double clicking on a line number 
  1753. with a breakpoint clears the breakpoint. 
  1754.  
  1755. See The Breakpoints menu for more information. 
  1756.  
  1757.  
  1758. ΓòÉΓòÉΓòÉ 2.3. The Run Menu ΓòÉΓòÉΓòÉ
  1759.  
  1760. The Run menu contains several commands for stepping through and running the 
  1761. current project. Use it to analyze your code line by line and help find errors 
  1762. within your code. 
  1763.  
  1764. The menu contains the following items: 
  1765.  
  1766. o Step 
  1767. o Step over 
  1768. o Redo 
  1769. o Run 
  1770. o Break 
  1771.  
  1772. The Run menu is found on the following windows: 
  1773.  
  1774. o Section List 
  1775. o Trace 
  1776. o Section window 
  1777.  
  1778. See Debugging a project in the VXΓêÖREXX Programmer's Guide for more information 
  1779. on debugging your projects. 
  1780.  
  1781.  
  1782. ΓòÉΓòÉΓòÉ 2.3.1. Break ΓòÉΓòÉΓòÉ
  1783.  
  1784. Use the Break command to interrupt the running of your project. Execution stops 
  1785. and you are returned control of the debugger. 
  1786.  
  1787. See The Run menu for more information. 
  1788.  
  1789.  
  1790. ΓòÉΓòÉΓòÉ 2.3.2. Step ΓòÉΓòÉΓòÉ
  1791.  
  1792. Use the Step command to run the next line of REXX code displayed in the Trace 
  1793. window. If the Step command encounters a call to a subroutine, it will trace 
  1794. into that subroutine. Pressing the I key in a trace window will also run this 
  1795. command. 
  1796.  
  1797. See The Run menu for more information. 
  1798.  
  1799.  
  1800. ΓòÉΓòÉΓòÉ 2.3.3. Step Over ΓòÉΓòÉΓòÉ
  1801.  
  1802. Use the Step Over command to run the next line of REXX code displayed in the 
  1803. Trace window. If the Step Over command encounters a call to a subroutine, the 
  1804. entire subroutine is run without displaying its code. Pressing the O key in a 
  1805. trace window will also run this command. 
  1806.  
  1807. See The Run menu for more information. 
  1808.  
  1809.  
  1810. ΓòÉΓòÉΓòÉ 2.3.4. Redo ΓòÉΓòÉΓòÉ
  1811.  
  1812. Use the Redo command to re-run the last line of REXX code that was run. 
  1813. Pressing the = key in a trace window will also run this command. 
  1814.  
  1815. See The Run menu for more information. 
  1816.  
  1817.  
  1818. ΓòÉΓòÉΓòÉ 2.3.5. Run ΓòÉΓòÉΓòÉ
  1819.  
  1820. Use the Run command to run the program without interruption until the program 
  1821. ends, the Break command is run, or a breakpoint is encountered. Pressing the R 
  1822. key will also run this command. 
  1823.  
  1824. See The Run menu for more information. 
  1825.  
  1826.  
  1827. ΓòÉΓòÉΓòÉ 2.4. The Options Menu ΓòÉΓòÉΓòÉ
  1828.  
  1829. The Options menu allows you to control the contents of the display in the 
  1830. Results window. All of the items in this menu are options that can be set to on 
  1831. or off. 
  1832.  
  1833. The options are: 
  1834.  
  1835. o Show results 
  1836. o Show source 
  1837. o Show trace messages 
  1838.  
  1839. The Options menu is found on the following window: 
  1840.  
  1841. o Results 
  1842.  
  1843. See Debugging a project in the VXΓêÖREXX Programmer's Guide for more information 
  1844. on debugging your projects. 
  1845.  
  1846.  
  1847. ΓòÉΓòÉΓòÉ 2.4.1. Show Results ΓòÉΓòÉΓòÉ
  1848.  
  1849. Use the Show Results option to display the results or return values of the REXX 
  1850. code run in the Results window. 
  1851.  
  1852. See The Options menu for more information. 
  1853.  
  1854.  
  1855. ΓòÉΓòÉΓòÉ 2.4.2. Show Source ΓòÉΓòÉΓòÉ
  1856.  
  1857. Use the Show Source option to display the source code being run in the Results 
  1858. window. 
  1859.  
  1860. See The Options menu for more information. 
  1861.  
  1862.  
  1863. ΓòÉΓòÉΓòÉ 2.4.3. Show Trace Messages ΓòÉΓòÉΓòÉ
  1864.  
  1865. Use the Show Trace Messages option to display the interactive trace messages 
  1866. generated by REXX while the program is running in the Results window. 
  1867.  
  1868. See The Options menu for more information. 
  1869.  
  1870.  
  1871. ΓòÉΓòÉΓòÉ 2.5. The Windows Menu ΓòÉΓòÉΓòÉ
  1872.  
  1873. The Windows menu contains the menu items to display the debugger's various 
  1874. windows. Each window has a hot-key associated with it for easier access. 
  1875.  
  1876. The Windows menu is found on the following windows: 
  1877.  
  1878. o Section List 
  1879. o Trace 
  1880. o Results 
  1881. o Variables 
  1882. o Section window 
  1883.  
  1884. See Debugging a project in the VXΓêÖREXX Programmer's Guide for more information 
  1885. on debugging your projects. 
  1886.  
  1887.  
  1888. ΓòÉΓòÉΓòÉ 2.5.1. The Trace window ΓòÉΓòÉΓòÉ
  1889.  
  1890. Use the Trace command to display the Trace window. This window contains the 
  1891. REXX source code for the project section that is currently being run. Each 
  1892. source line has a number associated with it that appears to the left of the 
  1893. line. Double-clicking on the line number will set a breakpoint on that line. 
  1894. Double-clicking on a variable in the code will display that variable in the 
  1895. Variable window. 
  1896.  
  1897. The Trace window may also be displayed by pressing Ctrl-T. 
  1898.  
  1899. For more information about debugging your projects, see Debugging a project in 
  1900. the VXΓêÖREXX Programmer's Guide. 
  1901.  
  1902. See also: 
  1903.  
  1904. o Breakpoints menu 
  1905. o Run menu 
  1906. o Windows menu 
  1907.  
  1908.  
  1909. ΓòÉΓòÉΓòÉ 2.5.2. The Variables window ΓòÉΓòÉΓòÉ
  1910.  
  1911. Use the Variables command to display the Variables window for the current file 
  1912. in the project. Variables are added to the Variables window by double-clicking 
  1913. on a variable name in the Trace window or a Section window. To delete a 
  1914. variable from the list of variables, select the variable and choose the Delete 
  1915. option from the Edit menu. 
  1916.  
  1917. You may use the entry fields beside each variable to assign it a value for 
  1918. testing purposes. 
  1919.  
  1920. The Variables window may also be displayed by pressing Ctrl-V. 
  1921.  
  1922. For more information about debugging your projects, see Debugging a project in 
  1923. the VXΓêÖREXX Programmer's Guide. 
  1924.  
  1925. See also: 
  1926.  
  1927. o Edit menu 
  1928. o Windows menu 
  1929.  
  1930.  
  1931. ΓòÉΓòÉΓòÉ 2.5.3. The Results window ΓòÉΓòÉΓòÉ
  1932.  
  1933. Use the Results command to display the Results window. The window displays 
  1934. results, source code, and tracing messages generated by REXX. This display is 
  1935. updated every time a piece of REXX code is executed. 
  1936.  
  1937. At the bottom of the Results window is a REXX command or program line. You can 
  1938. enter commands on this line to display the contents of variables, assign values 
  1939. to variables, call routines, and so on. Any REXX command may be run on this 
  1940. line. 
  1941.  
  1942. The Results window may also be displayed by pressing Ctrl-R. 
  1943.  
  1944. For more information about debugging your projects, see Debugging a project in 
  1945. the VXΓêÖREXX Programmer's Guide. 
  1946.  
  1947. See also: 
  1948.  
  1949. o Options menu 
  1950. o Windows menu 
  1951.  
  1952.  
  1953. ΓòÉΓòÉΓòÉ 2.5.4. The Section list window ΓòÉΓòÉΓòÉ
  1954.  
  1955. Use the Section list command to display the Section list window. This window 
  1956. contains the names of the files and sections in the project. Double-click on a 
  1957. file name to display the sections in that file. Double-click on a section name 
  1958. to display a Section window for that section. You can display multiple Section 
  1959. windows simultaneously. 
  1960.  
  1961. You can also display the Section list window by pressing Ctrl-S. 
  1962.  
  1963. For more information about debugging your projects, see Debugging a project in 
  1964. the VXΓêÖREXX Programmer's Guide. 
  1965.  
  1966. See also: 
  1967.  
  1968. o Run menu 
  1969. o Windows menu 
  1970.  
  1971.  
  1972. ΓòÉΓòÉΓòÉ 2.5.5. The Section window ΓòÉΓòÉΓòÉ
  1973.  
  1974. Section windows display the source from one section of the code in your 
  1975. project. Section windows are opened by double clicking on the name of a section 
  1976. in the Section list window. 
  1977.  
  1978. This window can be used to set breakpoints or examine your code. 
  1979.  
  1980. For more information about debugging your projects, see Debugging a project in 
  1981. the VXΓêÖREXX Programmer's Guide. 
  1982.  
  1983. See also: 
  1984.  
  1985. o Breakpoints menu 
  1986. o Run menu 
  1987. o Windows menu 
  1988.  
  1989.  
  1990. ΓòÉΓòÉΓòÉ 2.6. The Edit menu ΓòÉΓòÉΓòÉ
  1991.  
  1992. This menu only appears in the Variables window. It contains the Delete command, 
  1993. which removes a variable from the Variables window. 
  1994.  
  1995. See also: 
  1996.  
  1997. o Delete 
  1998.  
  1999. See Debugging a project in the VXΓêÖREXX Programmer's Guide for more information 
  2000. on debugging your projects. 
  2001.  
  2002.  
  2003. ΓòÉΓòÉΓòÉ 2.6.1. Delete ΓòÉΓòÉΓòÉ
  2004.  
  2005. Use the Delete command to remove a variable from the Variables window. 
  2006.  
  2007. See The Edit menu for more information.