home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / DLGEDIT.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-03-10  |  74KB  |  2,237 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Help for the Dialog Editor ΓòÉΓòÉΓòÉ
  3.  
  4. The Dialog Editor (DLGEDIT) is used to create resource script files, and the 
  5. associated resource and include files for use in building applications. 
  6.  
  7. It consists of a standard window that allows the selection, display and 
  8. creation of dialogs, using the standard building block controls provided by the 
  9. Presentation Manager. 
  10.  
  11. The current resource file and the include file being edited are shown in the 
  12. dialog editor's title bar.  If there is an asterisk (*) next to the file, it 
  13. means that the file has been changed. 
  14.  
  15. Pressing the F1 key always brings up help that is related to the operation that 
  16. you are doing at the time it is pressed.  Once you are in the help manager, you 
  17. may press Ctrl+C to view a table of contents, or press F11 to view an index of 
  18. help topics. 
  19.  
  20. To view help on any of the menu commands, press and release the Alt key, use 
  21. the arrow keys to select the command and then press the F1 key. You may also 
  22. use the mouse to highlight the command then press the F1 key before releasing 
  23. the mouse button. 
  24.  
  25. If you are in a dialog that has a Help button, pressing this button will also 
  26. show help for the dialog. 
  27.  
  28. In addition to specific help on menu items and dialogs, you should also see the 
  29. following help topics: 
  30.  
  31.    o  Adding Controls 
  32.    o  Control Palette 
  33.    o  Selecting Controls 
  34.    o  Moving and Sizing Controls 
  35.  
  36.  Any time that you see text in the help manager that is highlighted like the 
  37.  help topics above are, you may double-click the mouse on the text to see more 
  38.  detailed help on that topic.  Pressing the Esc key will come back to the 
  39.  previous help topic. 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 2. Keys Help ΓòÉΓòÉΓòÉ
  43.  
  44. In addition to the standard Presentation Manager keys, there are a number of 
  45. keys used by the dialog editor that do not have corresponding menu commands. 
  46.  
  47. The cursor movement (arrow) keys are used to move the selected control or group 
  48. of controls one grid unit in the specified direction. 
  49.  
  50. The Tab key is used to select the next control.  The Shift+Tab key is used to 
  51. select the previous control. The order of controls can be changed with the 
  52. Arrange/Order groups dialog. 
  53.  
  54. If you are changing the text or the define for a control, the Enter key will 
  55. accept the changes.  Also, if you are in the middle of dragging a control, the 
  56. Enter key will complete the drag operation. 
  57.  
  58. The Esc key will cancel the current dialog or drag operation. 
  59.  
  60. If the Shift key is held down when a control is clicked on to select it, the 
  61. selection state of the control will be toggled. If the control is not already 
  62. selected, it will be selected in addition to any other controls that are 
  63. already selected.  If the control is already selected, it will be removed from 
  64. the group of selected controls. 
  65.  
  66. If the Ctrl key is held down when a control or group of controls is beginning 
  67. to be dragged with the mouse, the control or group of controls will be 
  68. duplicated and a copy of the control or group of controls will be dropped when 
  69. the mouse button is released. 
  70.  
  71. In addition to the above keys, there are a number of keys that are accelerators 
  72. for the menu commands. Pressing the accelerator key for a command is the same 
  73. as choosing it from the menu. The accelerator key for a menu command (if one 
  74. exists), is shown to the right of its name in the menu. 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ
  81.  
  82.    1. Select the down arrow to the right of the Drive list to display all the 
  83.       drives on your system. 
  84.    2. Select a drive from the Drive list. 
  85.    3. Select a directory from the Directory list. 
  86.    4. Select a file name from the File list or type in a file name and select 
  87.       the Open pushbutton to display the file you want to edit. 
  88.  
  89.  For specific help, select a topic below. 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ <hidden> List of Fields ΓòÉΓòÉΓòÉ
  93.  
  94.  File name           Type of file 
  95.  Drive               File 
  96.  Directory           Open pushbutton 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ <hidden> Help for File name ΓòÉΓòÉΓòÉ
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ <hidden> Help for File name ΓòÉΓòÉΓòÉ
  103.  
  104. Type the name of the file you want to open in the File name field and select 
  105. the Open pushbutton. 
  106.  
  107. For more help, select a topic below. 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ <hidden> List of Fields ΓòÉΓòÉΓòÉ
  111.  
  112.  File name           Type of file 
  113.  Drive               File 
  114.  Directory           Open pushbutton 
  115.                      General help 
  116.  
  117.  
  118. ΓòÉΓòÉΓòÉ <hidden> Help for Type of file ΓòÉΓòÉΓòÉ
  119.  
  120.  
  121. ΓòÉΓòÉΓòÉ <hidden> Help for Type of file ΓòÉΓòÉΓòÉ
  122.  
  123. Select the down arrow to the right of the Type of file field to display the 
  124. available file types.  The Dialog Editor has set this field for all file types. 
  125.  
  126. For more help, select a topic below. 
  127.  
  128.  
  129. ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ
  133.  
  134. The Drive list displays the drives on your system.  Select the drive that 
  135. contains the files you want to edit. 
  136.  
  137. For more help, select a topic below. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ
  144.  
  145. The File list displays all the files in the directory you selected from the 
  146. Directory list.  Select the file you want to open. 
  147.  
  148. For more help, select a topic below. 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ
  155.  
  156. The Directory list displays the directories on the selected drive.  Select a 
  157. directory to display the list of files from that directory in the File list 
  158. box. 
  159.  
  160. For more help, select a topic below. 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ
  167.  
  168. Select the Open pushbutton to display the file you want to edit. 
  169.  
  170. For more help, select a topic below. 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ <hidden> Help for Save ΓòÉΓòÉΓòÉ
  174.  
  175. Use Save to store the file you are editing.  After the file is saved, the text 
  176. remains in the window so that you can continue editing it. 
  177.  
  178. Note:  If you are editing a new file, select the Save or Save as choices to 
  179.        display the Save as pop-up so that you can name the file you are 
  180.        editing.  A file must have a title to be saved. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ <hidden> Help for Save as ΓòÉΓòÉΓòÉ
  184.  
  185. Use Save as to name and save a new file or to save an existing file under a 
  186. different name, in a different directory, or on a different disk. 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ <hidden> Help for Save as ΓòÉΓòÉΓòÉ
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ <hidden> Help for Save as ΓòÉΓòÉΓòÉ
  193.  
  194.    1. Select the down arrow to the right of the Drive list to display all the 
  195.       drives on your system. 
  196.    2. Select a drive from the Drive list. 
  197.    3. Select a directory from the Directory list. 
  198.    4. Type the name of the file you want to save in the File name field and 
  199.       select the Save pushbutton. 
  200.  
  201.  For specific help, select a topic below. 
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ <hidden> List of Fields ΓòÉΓòÉΓòÉ
  205.  
  206.  File name           Type of file 
  207.  Drive               File 
  208.  Directory           Save pushbutton 
  209.  Type pushbutton 
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ <hidden> Help for File name ΓòÉΓòÉΓòÉ
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ <hidden> Help for File name ΓòÉΓòÉΓòÉ
  216.  
  217. Type the name of the file you want to save in the File name field and select 
  218. the Save pushbutton. 
  219.  
  220. For more help, select a topic below. 
  221.  
  222.  
  223. ΓòÉΓòÉΓòÉ <hidden> List of Fields ΓòÉΓòÉΓòÉ
  224.  
  225.  File name           Type of file 
  226.  Drive               File 
  227.  Directory           Save pushbutton 
  228.  Type pushbutton     General help 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ <hidden> Help for Type of file ΓòÉΓòÉΓòÉ
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ <hidden> Help for Type of file ΓòÉΓòÉΓòÉ
  235.  
  236. Select the down arrow to the right of the Type of file field to display the 
  237. available file types.  The Dialog Editor has set this field for all file types. 
  238.  
  239. For more help, select a topic below. 
  240.  
  241.  
  242. ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ
  243.  
  244.  
  245. ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ
  246.  
  247. The Drive list displays the drives on your system.  Select the drive that 
  248. contains the files you want to save. 
  249.  
  250. For more help, select a topic below. 
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ
  257.  
  258. The File list displays all the files in the directory you selected from the 
  259. Directory list.  Select the file you want to rename and save. 
  260.  
  261. For more help, select a topic below. 
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ
  265.  
  266.  
  267. ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ
  268.  
  269. The Directory list displays the directories on the selected drive.  Select a 
  270. directory to display the list of files from that directory in the File list 
  271. box. 
  272.  
  273. For more help, select a topic below. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ <hidden> Help for Save ΓòÉΓòÉΓòÉ
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ <hidden> Help for Save ΓòÉΓòÉΓòÉ
  280.  
  281. Select the Save pushbutton to save the file to the drive and directory you 
  282. selected and with the file name you specified. 
  283.  
  284. For more help, select a topic below. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ <hidden> Help for Type ΓòÉΓòÉΓòÉ
  288.  
  289.  
  290. ΓòÉΓòÉΓòÉ <hidden> Help for Type ΓòÉΓòÉΓòÉ
  291.  
  292. Select the Type pushbutton to choose a file type with which to save the file. 
  293.  
  294. For more help, select a topic below. 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 3. Adding Controls ΓòÉΓòÉΓòÉ
  298.  
  299. Once you have either created a new dialog using the Edit/New dialog command, or 
  300. selected an existing dialog using the Edit/Select dialog command, you can begin 
  301. adding controls to it. 
  302.  
  303. To add a new control, select the type of control desired from either the 
  304. Control menu, or from the Control Palette. After you have selected the type of 
  305. control, a tracking rectangle will be displayed that is the default size of 
  306. that type of control. This rectangle can be moved with the mouse, but it cannot 
  307. be moved outside of the dialog.  The coordinates of the new control will be 
  308. shown in the Status Ribbon. When you are satisfied with the position of the new 
  309. control, click mouse button one.  This will create a new control in the dialog, 
  310. initially positioned where the tracking rectangle was. 
  311.  
  312. The new control will be given the next unused id.  The id's for new dialogs are 
  313. always even multiples of 100.  For instance, the first dialog added will be 
  314. given an id of 100, the next will be given 200 and so on.  New controls are 
  315. always given the first available id that is greater than the id of the dialog 
  316. it is being added to.  So if a dialog's id is 200, new controls will be given 
  317. 201, 202, 203 and so on. 
  318.  
  319. If the type of control can have text, the cursor will initially be placed in 
  320. the Text (or Res. ID) field of the Status Ribbon, although you may change the 
  321. text at any time after this, also. 
  322.  
  323. After you have added the control, you can change its styles at any time by 
  324. using the Edit/Styles command, or by double-clicking mouse button one on the 
  325. control. 
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 4. Control Palette ΓòÉΓòÉΓòÉ
  329.  
  330. The control palette is a window along the right side of the Dialog Editor.  It 
  331. contains graphics of the different types of controls, and is used to add new 
  332. controls to the dialog being edited. 
  333.  
  334. To add a new control to the dialog using the control palette, click mouse 
  335. button one on the graphic for the control that you want to add.  When the mouse 
  336. button is released, a tracking rectangle is shown within the dialog that is the 
  337. default size of that type of control.  Use the mouse to position the rectangle 
  338. where you want to add the control, then press and release mouse button one 
  339. again.  To cancel adding the new control, press the Esc key instead. 
  340.  
  341. The control palette behaves in a similar way as the Control menu.  You may use 
  342. either one to add new controls. 
  343.  
  344. The following types of controls are available from the control palette: 
  345.  
  346.       Bitmap 
  347.       Check box 
  348.       Combo box 
  349.       Container 
  350.       Entry field 
  351.       Frame 
  352.       Group box 
  353.       Horz. scroll bar 
  354.       Icon 
  355.       List box 
  356.       MLE 
  357.       Notebook 
  358.       Push button 
  359.       Radio button 
  360.       Rectangle 
  361.       Slider 
  362.       Spin Button 
  363.       Text 
  364.       User defined 
  365.       Value Set 
  366.       Vert. scroll bar 
  367.  
  368.  See also: Adding Controls 
  369.  
  370.  
  371. ΓòÉΓòÉΓòÉ 5. Selecting Controls ΓòÉΓòÉΓòÉ
  372.  
  373. Controls must be selected before they can be edited. 
  374.  
  375. A selected control is shown with eight "drag handles".  These are small squares 
  376. that are at each corner of the selected control, and in the middle of each 
  377. side. 
  378.  
  379. Information about the selected control is shown in the Status Ribbon, and 
  380. almost all of the editing commands work on the current selection. 
  381.  
  382. There are several ways to select a control.  The first is to click on it with 
  383. mouse button one.  The second is to use the Tab and the Shift+Tab keys.  These 
  384. keys will select the next and the previous control, in the order that the 
  385. controls are defined (this order can be changed with the Arrange/Order groups 
  386. dialog). 
  387.  
  388. It is also possible to select a group of controls and operate on them as a 
  389. unit.  When a group of controls are selected, each control shows drag handles, 
  390. but all of the controls except for one of them shows drag handles that are 
  391. hollow squares instead of solid squares. This one control is called the anchor 
  392. control, and is important for some of the editing operations, like the Arrange 
  393. menu commands.  The Status Ribbon always shows information about the anchor 
  394. control. 
  395.  
  396. A group of controls can be selected by pressing and holding mouse button one on 
  397. the background of the dialog, then dragging it over the controls to select. 
  398. When dragging, a rectangle is shown.  When the mouse button is released, all of 
  399. the controls that lie at least partially within the rectangle will become 
  400. selected. This operation is called outline selection. 
  401.  
  402. To add or remove a control to the group of selected controls, hold either Shift 
  403. key down and click on the control.  If the control is already selected, it will 
  404. be unselected.  If it is not yet selected, it will be added to the group of 
  405. selected controls.  In a similar way, if you hold the Shift key down when 
  406. outline selecting controls, they will be added to the group of controls that 
  407. are already selected. 
  408.  
  409. To change the anchor control, click mouse button one on another control.  If 
  410. the control is part of the selection, this will simply change the anchor 
  411. control, leaving all the other controls selected.  If the control is not 
  412. selected, it will become selected and the group of selected controls will all 
  413. be unselected. 
  414.  
  415. The dialog itself can be selected by clicking on its titlebar, or by 
  416. double-clicking on its background.  A dialog cannot be part of a group 
  417. selection. 
  418.  
  419. When some controls are selected, they may not completely fill up the area 
  420. within their drag handles.  This is normal, and is caused by the control 
  421. automatically adjusting its size to be smaller for a better appearance.  For 
  422. instance, list boxes can adjust their height to be slightly smaller so that 
  423. they will enclose an integral number of lines, without showing a partial line 
  424. at the bottom.  The drag handles will always enclose the control as if it did 
  425. not adjust its size. 
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ 6. Moving and Sizing Controls ΓòÉΓòÉΓòÉ
  429.  
  430. Once a control has been added to the dialog, it may be moved to anywhere within 
  431. the dialog, and it may be sized to any size that will fit. 
  432.  
  433. A control can be moved with either the keyboard or the mouse. To move a control 
  434. with the keyboard, select it and then press one of the cursor movement (arrow) 
  435. keys.  The control will be moved one grid unit in the specified direction. 
  436.  
  437. To move a control with the mouse, press mouse button one down on the control 
  438. and drag the control to the desired location.  As the control is being dragged, 
  439. the pointer will be the system "Move" pointer, a rectangle will be displayed 
  440. that shows the outline of the control, and the coordinates in the Status Ribbon 
  441. will be updated to reflect the location of the rectangle. Releasing the button 
  442. will finish dragging the control to its new location.  To cancel without moving 
  443. the control, press the Esc key before releasing the mouse button. 
  444.  
  445. A group of controls can be moved in the same way.  Pressing a cursor movement 
  446. key will move all the selected controls in the specified direction.  Dragging 
  447. one of the controls with a mouse will show a rectangle that encloses all the 
  448. selected controls. When dragging a group of controls, the new location of the 
  449. anchor control is what is shown in the Status Ribbon, not the coordinates of 
  450. the enclosing rectangle. 
  451.  
  452. The drag handles on a selected control are used to size the control.  Moving 
  453. the mouse over the different handles will display different pointers with 
  454. arrows that show the direction the control can be sized in.  Pressing down and 
  455. holding mouse button one will begin sizing the control.  A rectangle will be 
  456. displayed and the coordinates in the Status Ribbon will be updated with the new 
  457. size of the control. Releasing the button will finish sizing the control. To 
  458. cancel without sizing the control, press the Esc key before releasing the mouse 
  459. button.  A group of controls cannot be sized as a unit with the mouse. 
  460.  
  461. The dialog can be moved with the cursor movement keys also, or you can drag it 
  462. with the mouse by pressing and holding mouse button one down on its titlebar or 
  463. its border. 
  464.  
  465. Once the dialog is selected it can be sized with the drag handles in the same 
  466. way that controls are.  If the left or bottom edges are moved, the controls 
  467. within the dialog all have their coordinates adjusted so that they appear to 
  468. stay in the same location on the screen.  This is useful to open space at the 
  469. left or bottom edge of the dialog for adding more controls.  To increase the 
  470. size of the dialog without changing the coordinates of any of the controls, 
  471. drag the top or right edge of the dialog instead. 
  472.  
  473. Some types of controls can be automatically sized so that they exactly fit 
  474. their text.  See the Edit/Size to text command. 
  475.  
  476. A group of controls can be sized so that either their height or their width is 
  477. set to be the same as that of the anchor control. See the Arrange/Same 
  478. size/Height or the Arrange/Same size/Width command. 
  479.  
  480.  
  481. ΓòÉΓòÉΓòÉ 7. Status Ribbon ΓòÉΓòÉΓòÉ
  482.  
  483. The Status Ribbon is a window just below the menu bar. It displays information 
  484. about the selected control, and allows the text and symbolic name of that 
  485. control to be changed. 
  486.  
  487. The coordinates of the currently selected control are shown in the status 
  488. ribbon.  At the lower left is shown the x and y starting origin of the control. 
  489. At the upper right is shown the x and y coordinates of the upper right corner 
  490. of the control. The width (cx) and height (cy) are also shown. When the control 
  491. is being sized or moved, these coordinates will be updated to show the new 
  492. coordinates the control will have. 
  493.  
  494. The text of the control is also shown in an entry field.  This text can be 
  495. edited at any time just by clicking on the entry field and entering the new 
  496. text. 
  497.  
  498. The symbolic name and value for the control are also shown in the status 
  499. ribbon.  The symbol is in a combo box that contains all the symbolic names 
  500. defined in the current include file. The value for the control is shown in an 
  501. entry field to the right of the combo box.  They can be changed at any time 
  502. just by entering the new symbol or value, or by selecting another symbol from 
  503. the combo box.  If the symbol that is entered is not already in the include 
  504. file, it will be added to it. 
  505.  
  506. As a new symbol is being entered into the entry field of the combo box, the 
  507. value field will be updated to either be the value that is associated with the 
  508. symbol (if the symbol is already in the include file) or the next available id 
  509. value if the symbol is new.  For this reason, the name of a new symbol should 
  510. be typed in first, followed by modifying the id value for it (if the next 
  511. available id is not desired).  The default numbering scheme is described in the 
  512. help for Adding Controls, and it is recommended that you accept the default id 
  513. values. 
  514.  
  515. The Symbol combo box always contains several predefined values.  They are the 
  516. constants DID_OK, DID_CANCEL and (Unused).  The DID_OK and DID_CANCEL values 
  517. are used for OK and Cancel push buttons.  The (Unused) value is a special value 
  518. that can be assigned to any controls in the dialog that do not need a unique 
  519. symbolic name. These are usually things like group boxes, text fields, frames 
  520. and other controls that do not need to be explicitly referenced by the 
  521. application.  Giving them the (Unused) id reduces the size of the include file 
  522. and speeds up compiles. 
  523.  
  524. If the current control is either a bitmap or an icon control, the Text field 
  525. will be labeled Res. ID instead.  These types of controls do not have text. 
  526. They do, however, need to have an ordinal entered that specifies which bitmap 
  527. or icon resource in the resource file should be loaded for this bitmap or icon 
  528. control. Enter the resource id value for the bitmap or icon resource as an 
  529. integer in the Res. ID field of your bitmap and icon controls. 
  530.  
  531. To accept the changes press Enter, or click on another control or menu item. 
  532. To cancel the changes, press the Esc key. 
  533.  
  534.  
  535. ΓòÉΓòÉΓòÉ 8. File Menu ΓòÉΓòÉΓòÉ
  536.  
  537. The following commands are available from the File menu: 
  538.  
  539.  New       Creates a new resource file. 
  540.  
  541.  Open      Opens a new resource file. 
  542.  
  543.  Save      Saves the current resource and include files. 
  544.  
  545.  Save as   Saves the current resource and include files to a different name. 
  546.  
  547.  Open include Opens a new include file for the current resource file. 
  548.  
  549.  
  550. ΓòÉΓòÉΓòÉ 8.1. New ΓòÉΓòÉΓòÉ
  551.  
  552. The File/New command creates a new resource file.  This new file can contain 
  553. one or many dialogs.  If there is currently another resource file being edited, 
  554. the editor will give you a chance to save any changes that you may have made to 
  555. this other resource file before creating the new one. 
  556.  
  557.  
  558. ΓòÉΓòÉΓòÉ 8.2. Open ΓòÉΓòÉΓòÉ
  559.  
  560. The File/Open command displays the Open dialog, and allows you to begin editing 
  561. dialogs from an existing resource file on disk. 
  562.  
  563.  
  564. ΓòÉΓòÉΓòÉ 8.3. Open Dialog ΓòÉΓòÉΓòÉ
  565.  
  566. The Open dialog has an entry field, two list boxes, and three buttons. The list 
  567. boxes are used to select the directory and/or drive to get a file list from, 
  568. and to select a file from.  The list box on the left contains entries for each 
  569. directory (including the current directory's parent, unless the root directory 
  570. is currently being displayed.)  The list box on the right displays all the 
  571. files in the current directory that match the string in the entry field (only 
  572. if the entry field contains wildcards). The current drive and directory are 
  573. displayed just above the entry field.  The three buttons are Open, Cancel and 
  574. Help.  The Help button (or F1) displays this help.  The Cancel button exits the 
  575. dialog. 
  576.  
  577. The Open  button causes the current contents of the entry field to become the 
  578. result.  Normally the editor will attempt to open the file when the Open button 
  579. is pressed, but if there is a directory selected when the Open button is 
  580. pressed, the dialog will display the files contained within that directory 
  581. instead. 
  582.  
  583. The user may type a filename, pathname or pattern containing wildcards into the 
  584. entry field.  If that filename contains wildcards, the dialog will display 
  585. matching files.  If the filename or pathname is fully qualified, the dialog 
  586. will return and the editor will attempt to open the file. 
  587.  
  588. The mouse may be used to select items from the list boxes.  In addition, double 
  589. clicking will select the item and 'press' the Open button, causing the entry 
  590. field and/or file list to change. 
  591.  
  592.  
  593. ΓòÉΓòÉΓòÉ 8.4. Save ΓòÉΓòÉΓòÉ
  594.  
  595. The File/Save command saves the current file to disk.  If the file has not been 
  596. given a name yet, the Save As dialog will be displayed to allow you to name the 
  597. file. 
  598.  
  599.  
  600. ΓòÉΓòÉΓòÉ 8.5. Save as ΓòÉΓòÉΓòÉ
  601.  
  602. The File/Save as command displays the Save As dialog, which allows you to save 
  603. the current file under a different name. 
  604.  
  605.  
  606. ΓòÉΓòÉΓòÉ 8.6. Save As Dialog ΓòÉΓòÉΓòÉ
  607.  
  608. The Save As dialog is used to prompt for a filename or pathname under which to 
  609. save the current file.  It has an entry field and three buttons. 
  610.  
  611. The entry field contains the name of the currently selected file. The current 
  612. drive and directory are displayed just above the entry field. The three buttons 
  613. are Save, Cancel and Help.  The Help button (or F1) displays this help.  The 
  614. Cancel button cancels the save without doing anything. The Save button causes 
  615. the editor to save the file under the specified name. 
  616.  
  617. The user may type a filename or pathname into the entry field.  If only a 
  618. filename is typed, the file will be created in the currently displayed drive 
  619. and directory.  If the full path is typed, and all the subdirectories in the 
  620. path exist, the file will be created in the specified directory. 
  621.  
  622.  
  623. ΓòÉΓòÉΓòÉ 8.7. Open include ΓòÉΓòÉΓòÉ
  624.  
  625. The File/Open include command displays the Open dialog, and allows you to 
  626. associate an include file with the current resource file. 
  627.  
  628. The include file contains symbolic defines that are used to give the dialog and 
  629. controls a meaningful name (symbol) that is easier to remember than just a 
  630. numeric id. 
  631.  
  632. Once you have associated an include file with a resource file, the association 
  633. is remembered and will be in effect the next time that the editor is used to 
  634. edit that resource file. 
  635.  
  636.  
  637. ΓòÉΓòÉΓòÉ 9. Edit Menu ΓòÉΓòÉΓòÉ
  638.  
  639. The following commands are available from the Edit menu: 
  640.  
  641.  Cut       Copies the current selection to the clipboard and clears it from the 
  642.            resource file. 
  643.  
  644.  Copy      Copies the current selection to the clipboard without clearing it. 
  645.  
  646.  Paste     Pastes the current contents of the clipboard into the current 
  647.            resource file. 
  648.  
  649.  Clear     Deletes the current selection. 
  650.  
  651.  Duplicate Duplicates the current selection. 
  652.  
  653.  New dialog Creates a new dialog in the current resource file. 
  654.  
  655.  Select Dialog Displays the Select Dialog dialog. 
  656.  
  657.  Symbols - edit Displays the Symbols - edit dialog. 
  658.  
  659.  Styles    Displays the Styles dialog for the selected control. 
  660.  
  661.  Presentation parameters Displays the Presentation parameters dialog for the 
  662.            selected control. 
  663.  
  664.  Size to text Sizes controls to fit their text. 
  665.  
  666.  
  667. ΓòÉΓòÉΓòÉ 9.1. Cut ΓòÉΓòÉΓòÉ
  668.  
  669. The Edit/Cut command copies the current selection into the clipboard.  If the 
  670. dialog is selected, it and all of its controls will be copied into the 
  671. clipboard.  If a control or group of controls is selected, only those controls 
  672. will be copied into the clipboard. 
  673.  
  674. After the selected dialog or controls have been copied to the clipboard, it 
  675. will be deleted from the current resource file or dialog. 
  676.  
  677.  
  678. ΓòÉΓòÉΓòÉ 9.2. Copy ΓòÉΓòÉΓòÉ
  679.  
  680. The Edit/Copy command copies the current selection into the clipboard.  If the 
  681. dialog is selected, it and all of its controls will be copied into the 
  682. clipboard.  If a control or group of controls is selected, only those controls 
  683. will be copied into the clipboard. 
  684.  
  685. Unlike the Edit/Cut command, this command does not delete the selection after 
  686. it is copied to the clipboard. 
  687.  
  688.  
  689. ΓòÉΓòÉΓòÉ 9.3. Paste ΓòÉΓòÉΓòÉ
  690.  
  691. The Edit/Paste command pastes the contents of the clipboard into the current 
  692. resource file or dialog. 
  693.  
  694. If the clipboard contains an entire dialog, this dialog will be added to the 
  695. current resource file, complete with any controls that it may have. 
  696.  
  697. If the clipboard contains a control or group of controls, these controls will 
  698. be pasted into the current dialog being edited. 
  699.  
  700.  
  701. ΓòÉΓòÉΓòÉ 9.4. Clear ΓòÉΓòÉΓòÉ
  702.  
  703. The Edit/Clear command deletes the currently selected dialog, control or group 
  704. of controls. 
  705.  
  706. If the dialog is selected, you will be asked to confirm that you want to delete 
  707. the dialog and all of its controls. 
  708.  
  709.  
  710. ΓòÉΓòÉΓòÉ 9.5. Duplicate ΓòÉΓòÉΓòÉ
  711.  
  712. The Edit/Duplicate command duplicates the currently selected dialog, control or 
  713. group of controls. 
  714.  
  715. If the dialog is selected, a new dialog with all of its controls will be added 
  716. to the current resource file.  If a controls or group of controls is selected, 
  717. they will be duplicated and added to the current dialog. 
  718.  
  719. Note:  Another way to duplicate controls is to hold the Ctrl key down while 
  720. clicking down with mouse button 1 on the control or group of controls. 
  721.  
  722.  
  723. ΓòÉΓòÉΓòÉ 9.6. Symbols - edit ΓòÉΓòÉΓòÉ
  724.  
  725. The Edit/Symbols command displays the Symbols - edit dialog, which allows you 
  726. to change the symbols that are stored in the current include file. 
  727.  
  728.  
  729. ΓòÉΓòÉΓòÉ 9.7. Symbols - edit dialog ΓòÉΓòÉΓòÉ
  730.  
  731. The Symbols - edit dialog displays the symbols that are in the current include 
  732. file, and allows them to be changed. 
  733.  
  734. There is a list box that shows the symbols.  The selected symbol will be shown 
  735. in two entry fields above the list box.  The symbol will be in one field and 
  736. the numeric id value will be in another. 
  737.  
  738. To add a symbol, enter the name of the symbol in the Symbol entry field, and 
  739. optionally enter the numeric value desired in the ID Value entry field, then 
  740. press the Add button. 
  741.  
  742. To change a symbol, select it from the list box, modify the name of the symbol 
  743. in the Symbol entry field and/or change the numeric value in the ID Value entry 
  744. field, then press the Change button. 
  745.  
  746. To delete a symbol, select it from the list box, then press the Delete button. 
  747.  
  748. Over a period of time, with controls being added and deleted to the different 
  749. dialogs in the resource file, there can be symbols that were used at one time 
  750. but are no longer needed.  If you click on the Show unused symbols only 
  751. checkbox, only those symbols that are not used by any dialog or control in the 
  752. current resource file will be displayed, and they can be removed from the 
  753. include file. 
  754.  
  755. To accept the changes, press the OK button.  To ignore the changes, press the 
  756. Cancel button. 
  757.  
  758.  
  759. ΓòÉΓòÉΓòÉ 9.8. Styles ΓòÉΓòÉΓòÉ
  760.  
  761. The Edit/Styles command displays the styles dialog for the selected control or 
  762. dialog.  If a group of controls is selected, the styles dialog for the anchor 
  763. control is shown. 
  764.  
  765. The styles dialogs allow you to change various style attributes of the selected 
  766. dialog or control.  For instance, whether a text control is left justified, 
  767. centered or right justified is a text control style that can be set by the Text 
  768. Styles dialog. 
  769.  
  770. In addition to using the Edit/Styles command, the styles dialog for a control 
  771. may also be shown by double-clicking the left mouse button on the control. 
  772.  
  773. The following styles dialogs are available: 
  774.  
  775.       Dialog Styles - set 
  776.       Bitmap Styles - set 
  777.       Check Box Styles - set 
  778.       Combo Box Styles - set 
  779.       Container Styles - set 
  780.       Entry Field Styles - set 
  781.       Frame Styles - set 
  782.       Group Box Styles - set 
  783.       Horizontal Scroll Bar Styles - set 
  784.       Icon Styles - set 
  785.       List Box Styles - set 
  786.       MLE Styles - set 
  787.       Notebook Styles - set 
  788.       Push Button Styles - set 
  789.       Radio Button Styles - set 
  790.       Rectangle Styles - set 
  791.       Slider Styles - set 
  792.       Spin Button Styles - set 
  793.       Text Styles - set 
  794.       User Control Styles - set 
  795.       Value Set Styles - set 
  796.       Vertical Scroll Bar Styles - set 
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ 9.8.1. Dialog Styles Dialog ΓòÉΓòÉΓòÉ
  800.  
  801. The Dialog Styles dialog is used to change the attributes of the current 
  802. dialog. 
  803.  
  804. The Resource Memory Flags determine how and when the dialog is loaded into 
  805. memory.  The dialog can have any of the following resource memory flags: 
  806.  
  807.  Preload   The dialog resource is loaded into memory as soon as the application 
  808.            is started.  If this is not specified, the dialog resource will be 
  809.            loaded into memory only when needed. 
  810.  
  811.  Moveable  Presentation Manager can move the dialog resource in memory as 
  812.            needed. 
  813.  
  814.  Discardable The dialog resource in memory can be discarded if needed.  The 
  815.            dialog resource will be reloaded from disk if it is needed later. 
  816.  
  817.  The Alignment style determines how the dialogs x,y coordinates are 
  818.  interpreted.  The dialog can have one of the following styles: 
  819.  
  820.  Window    The dialog will be positioned at the specified x,y offset from its 
  821.            owner window. 
  822.  
  823.  Screen    The dialog will be positioned at the specified x,y offset from the 
  824.            desktop (screen) window. 
  825.  
  826.  Mouse     The dialog will be positioned at the specified x,y offset from the 
  827.            location of the mouse pointer at the time the dialog is shown by the 
  828.            application. 
  829.  
  830.  The Border style determines what kind of border the dialog has. The dialog can 
  831.  have one of the following borders: 
  832.  
  833.  Dialog    A standard dialog border. 
  834.  
  835.  Thin      A thin (single line) border. 
  836.  
  837.  Sizing    A standard sizing border that allows the dialog to be resized using 
  838.            the mouse. 
  839.  
  840.  None      No border. 
  841.  
  842.  The dialog frame can have any number of the following Optional Controls: 
  843.  
  844.  Titlebar  A title bar window, used for moving the dialog with a mouse. 
  845.  
  846.  Min button A minimize button, used for minimizing the dialog into an icon. 
  847.  
  848.  Max button A maximize button, used for maximizing the dialog to fit the entire 
  849.            screen. 
  850.  
  851.  System menu A system menu, with various standard menu commands. 
  852.  
  853.  Vertical scroll bar A vertical scroll bar along the right edge of the dialog. 
  854.  
  855.  Horizontal scroll bar A horizontal scroll bar along the bottom of the dialog. 
  856.  
  857.  In addition, the following styles are available: 
  858.  
  859.  Visible   If this style is not set, the dialog will initially be invisible. 
  860.  
  861.  Disabled  A disabled dialog cannot be selected. 
  862.  
  863.  Save bits Saves the image under the dialog as a bitmap.  This is an 
  864.            optimization, common for dialogs, that allows them to be shown then 
  865.            removed without the window underneath the dialog having to paint its 
  866.            image over again. 
  867.  
  868.  Sync paint The dialog will immediately repaint itself completely if any part 
  869.            of it becomes invalid.  Normally, the painting is deferred until 
  870.            there are no other window messages to process. 
  871.  
  872.  System modal The dialog will be system modal.  When this dialog is displayed, 
  873.            no other window in the system is allowed to become active until this 
  874.            dialog is dismissed. 
  875.  
  876.  No byte align Normally, a dialog will adjust its horizontal position to be an 
  877.            even multiple of 8 from the left edge of the screen for speed in 
  878.            drawing.  If the no byte align style is set, this adjustment will 
  879.            not be done and the dialog may be positioned exactly to any 
  880.            horizontal coordinate. 
  881.  
  882.  No move with owner Allows the dialog to maintain its position when its owner 
  883.            window moves. This applies only to dialogs that are not child 
  884.            windows of the owner. If this flag is not given, the dialog moves 
  885.            when its owner window moves. 
  886.  
  887.  DBCS status line Add a DBCS status line to the bottom of the dialog. 
  888.  
  889.  
  890. ΓòÉΓòÉΓòÉ 9.8.2. Bitmap Styles - set Dialog ΓòÉΓòÉΓòÉ
  891.  
  892. The Bitmap Styles- set  dialog is used to change the attributes of the 
  893. currently selected bitmap control. 
  894.  
  895. See also: Basic styles 
  896.  
  897.  
  898. ΓòÉΓòÉΓòÉ 9.8.3. Check Box Styles - set Dialog ΓòÉΓòÉΓòÉ
  899.  
  900. The Check box styles- set  dialog is used to change the attributes of the 
  901. currently selected check box control. 
  902.  
  903. The following styles are available: 
  904.  
  905.  Auto      An "auto" check box will automatically check and uncheck itself when 
  906.            it is clicked on.  If this style is not set, it is the applications 
  907.            responsibility to do this. 
  908.  
  909.  3 state   Every check box has a checked and an unchecked state.  A 3 state 
  910.            check box has a third state which can be used by an application. 
  911.  
  912.  No pointer focus If the check box has this style, it does not get the focus 
  913.            when it is clicked on with the mouse. 
  914.  
  915.  See also: Basic styles 
  916.  
  917.  
  918. ΓòÉΓòÉΓòÉ 9.8.4. Combo box styles - set dialog ΓòÉΓòÉΓòÉ
  919.  
  920. The Combo box styles- set  dialog is used to change the attributes of the 
  921. currently selected combo box control. 
  922.  
  923. The following types of combo boxes are available: 
  924.  
  925.  Simple    The list box is always visible.  A string can be selected from the 
  926.            list box or can be typed into the entry field. 
  927.  
  928.  Drop down Same as a simple combo box, except that the list box is initially 
  929.            collapsed into an icon next to the entry field, and the icon must be 
  930.            clicked on to drop it down. 
  931.  
  932.  Drop down list Same as a drop down combo box, except that the entry field 
  933.            cannot be typed into.  The only possible choices are what is in the 
  934.            list box. 
  935.  
  936.  Horizontal scroll bar The list box of the combo box can be set to have a 
  937.            horizontal scroll bar, in case any list item is longer than the 
  938.            width of the window. 
  939.  
  940.  See also: DBCS support styles and Basic styles 
  941.  
  942.  
  943. ΓòÉΓòÉΓòÉ 9.8.5. Container styles - set dialog ΓòÉΓòÉΓòÉ
  944.  
  945. The Container styles- set  dialog is used to change the attributes of the 
  946. currently selected container control. 
  947.  
  948. The following types of selection styles are available: 
  949.  
  950.  Extended Selection One or more records can be selected.  You can select one 
  951.            choice, a range of choices, or multiple ranges of choices. 
  952.  
  953.  Multiple Selection You may select zero or more container records at a time. 
  954.  
  955.  Single selection You may select exactly one container record at a time. 
  956.  
  957.  The following types of container styles are available: 
  958.  
  959.  Auto Position When the container is in icon view with this style, the 
  960.            icon/text pairs will be repositioned when the window size changes, 
  961.            when the icon/text pairs are inserted, deleted, sorted, or filtered, 
  962.            or when the font changes.  This style is valid only with the icon 
  963.            view. 
  964.  
  965.  Mini record Use the abbreviated data structure, when only the icon view of the 
  966.            container is to be used. 
  967.  
  968.  Read only None of the text in the container can be edited directly with this 
  969.            style. 
  970.  
  971.  Verify Pointers The container will verify that the application pointers are 
  972.            members of the container's linked list before they are used. 
  973.  
  974.  See also: DBCS support styles and Basic styles 
  975.  
  976.  
  977. ΓòÉΓòÉΓòÉ 9.8.6. Entry field styles - set dialog ΓòÉΓòÉΓòÉ
  978.  
  979. The Entry field styles- set  dialog is used to change the attributes of the 
  980. currently selected entry field control. 
  981.  
  982. The text can be aligned in one of the following ways: 
  983.  
  984.  Left      Left justified. 
  985.  
  986.  Center    Centered horizontally. 
  987.  
  988.  Right     Right justified. 
  989.  
  990.  The following styles are also available: 
  991.  
  992.  Auto scroll Horizontally scrolls text automatically to show the insertion 
  993.            point. 
  994.  
  995.  Margin    Draws a border around the control. 
  996.  
  997.  Auto tab  Automatically moves the cursor to the next control when the user 
  998.            enters the maximum number of characters. 
  999.  
  1000.  Read only Prevents the user from entering or editing text in the control. 
  1001.  
  1002.  Unreadable Displays each character as an asterisk.  This is useful for 
  1003.            password fields. 
  1004.  
  1005.  These double-byte character set support styles are available: 
  1006.  
  1007.  Any       The text is a mixture of SBCS and DBCS characters. 
  1008.  
  1009.  Mixed     The text is a mixture of SBCS and DBCS characters. 
  1010.  
  1011.  SBCS only The text is purely single-byte. 
  1012.  
  1013.  DBCS only The text is purely double-byte. 
  1014.  
  1015.  See also: DBCS support styles and Basic styles 
  1016.  
  1017.  
  1018. ΓòÉΓòÉΓòÉ 9.8.7. Frame styles - set dialog ΓòÉΓòÉΓòÉ
  1019.  
  1020. The Frame styles- set  dialog is used to change the attributes of the currently 
  1021. selected frame control. 
  1022.  
  1023. The frame can be one of the following types: 
  1024.  
  1025.  Foreground The color is the foreground text color. 
  1026.  
  1027.  Background The color is the window background color. 
  1028.  
  1029.  Halftone  The color is halftone. 
  1030.  
  1031.  See also: Basic styles 
  1032.  
  1033.  
  1034. ΓòÉΓòÉΓòÉ 9.8.8. Group box styles - set dialog ΓòÉΓòÉΓòÉ
  1035.  
  1036. The Group box styles- set  dialog is used to change the attributes of the 
  1037. currently selected group box control. 
  1038.  
  1039. The following styles are available: 
  1040.  
  1041.  Halftone  The border and text are halftone color. 
  1042.  
  1043.  Mnemonic  If a mnemonic prefix character is encountered, draw the next 
  1044.            character with mnemonic emphasis. 
  1045.  
  1046.  See also: Basic styles 
  1047.  
  1048.  
  1049. ΓòÉΓòÉΓòÉ 9.8.9. Horizontal scroll bar styles - set dialog ΓòÉΓòÉΓòÉ
  1050.  
  1051. The Horizontal scroll bar styles- set  dialog is used to change the attributes 
  1052. of the currently selected horizontal scroll bar control. 
  1053.  
  1054. See also: Basic styles 
  1055.  
  1056.  
  1057. ΓòÉΓòÉΓòÉ 9.8.10. Icon styles - set dialog ΓòÉΓòÉΓòÉ
  1058.  
  1059. The Icon styles - set dialog is used to change the attributes of the currently 
  1060. selected icon control. 
  1061.  
  1062. See also: Basic styles 
  1063.  
  1064.  
  1065. ΓòÉΓòÉΓòÉ 9.8.11. List box styles - set dialog ΓòÉΓòÉΓòÉ
  1066.  
  1067. The List box styles - set dialog is used to change the attributes of the 
  1068. currently selected list box control. 
  1069.  
  1070. The following styles are available: 
  1071.  
  1072.  Owner draw Causes the owner window to receive a WM_DRAWITEM message each time 
  1073.            an item must be drawn or highlighted. 
  1074.  
  1075.  No adjust position Prevents the height of the list box from being adjusted to 
  1076.            a multiple of the item height. List boxes with this style could 
  1077.            display partial items at the bottom of the box. 
  1078.  
  1079.  Horizontal scroll bar Creates a horizontal scroll bar. 
  1080.  
  1081.  Multiple selection Toggles the item selection on or off each time the user 
  1082.            selects it. The user can select any number of list box items. 
  1083.  
  1084.  Extended selection One or more items can be selected.  You can select one 
  1085.            choice, a range of choices, or multiple ranges of choices. 
  1086.  
  1087.  See also: Basic styles 
  1088.  
  1089.  
  1090. ΓòÉΓòÉΓòÉ 9.8.12. MLE styles - set dialog ΓòÉΓòÉΓòÉ
  1091.  
  1092. The MLE styles - set dialog is used to change the attributes of the currently 
  1093. selected MLE control. 
  1094.  
  1095. The following styles are available: 
  1096.  
  1097.  Word wrap Automatically moves complete words that do not fit at the end of a 
  1098.            line to the beginning of the next line during text entry. 
  1099.  
  1100.  Border    Creates a thin-line border around the control. 
  1101.  
  1102.  Vertical scroll bar Creates a vertical scroll bar. 
  1103.  
  1104.  Horizontal scroll bar Creates a horizontal scroll bar. 
  1105.  
  1106.  Read only Prevents the user from entering or editing text in the control. 
  1107.  
  1108.  Ignore tab Prevents the TAB key from functioning within the control. 
  1109.  
  1110.  See also: Basic styles 
  1111.  
  1112.  
  1113. ΓòÉΓòÉΓòÉ 9.8.13. Notebook styles - set dialog ΓòÉΓòÉΓòÉ
  1114.  
  1115. The Notebook styles - set dialog is used to change the attributes of the 
  1116. currently selected Notebook control. 
  1117.  
  1118. The following styles are available: 
  1119.  
  1120.  Back page orientation The choices are bottom right, bottom left, top right, or 
  1121.            top left. 
  1122.  
  1123.  Major tab side The choices are right, left, top, or bottom. 
  1124.  
  1125.  Tab Type  The choices are square, round, or polygon. 
  1126.  
  1127.  Binding Type The choices are solid or spiral. 
  1128.  
  1129.  Tab text  The choices are left justify, right justify, or center. 
  1130.  
  1131.  Status line text The choices are left justify, right justify, or center. 
  1132.  
  1133.  See also: Basic styles 
  1134.  
  1135.  
  1136. ΓòÉΓòÉΓòÉ 9.8.14. Push button styles - set dialog ΓòÉΓòÉΓòÉ
  1137.  
  1138. The Push button styles - set dialog is used to change the attributes of the 
  1139. currently selected push button control. 
  1140.  
  1141. The following styles are available: 
  1142.  
  1143.  Help      Creates a button that posts a WM_HELP message to its owner window 
  1144.            when the user selects the button. 
  1145.  
  1146.  SYSCOMMAND Creates a button that posts a WM_SYSCOMMAND message to its owner 
  1147.            window when the user selects the button, rather than a WM_COMMAND 
  1148.            message. 
  1149.  
  1150.  Default   Creates a button with a heavy black border. The user can select this 
  1151.            button by pressing the ENTER key.  Only one default push button is 
  1152.            allowed in a dialog, so this style will not be available if another 
  1153.            default push button is present in the current dialog. 
  1154.  
  1155.  No pointer focus Creates a button that does not receive the focus when it is 
  1156.            selected. 
  1157.  
  1158.  No border Creates a button that has no border. 
  1159.  
  1160.  See also: Basic styles 
  1161.  
  1162.  
  1163. ΓòÉΓòÉΓòÉ 9.8.15. Radio button styles - set dialog ΓòÉΓòÉΓòÉ
  1164.  
  1165. The Radio button styles - set dialog is used to change the attributes of the 
  1166. currently selected radio button control. 
  1167.  
  1168. The following styles are available: 
  1169.  
  1170.  Auto      An "auto" radio button will automatically select itself when it is 
  1171.            clicked on.  If this style is not set, it is the applications 
  1172.            responsibility to do this. 
  1173.  
  1174.  No pointer focus If the radio button has this style, it does not get the focus 
  1175.            when it is clicked on with the mouse. 
  1176.  
  1177.  No cursor select Prevents the radio button from being automatically selected 
  1178.            when the user moves the cursor to the button using the 
  1179.            cursor-movement keys. 
  1180.  
  1181.  See also: Basic styles 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ 9.8.16. Rectangle styles - set dialog ΓòÉΓòÉΓòÉ
  1185.  
  1186. The Rectangle styles - set  dialog is used to change the attributes of the 
  1187. currently selected rectangle control. 
  1188.  
  1189. The rectangle can be one of the following types: 
  1190.  
  1191.  Foreground The color is the foreground text color. 
  1192.  
  1193.  Background The color is the window background color. 
  1194.  
  1195.  Halftone  The color is halftone. 
  1196.  
  1197.  See also: Basic styles 
  1198.  
  1199.  
  1200. ΓòÉΓòÉΓòÉ 9.8.17. Slider styles - set dialog ΓòÉΓòÉΓòÉ
  1201.  
  1202. The Slider styles - set dialog is used to change the attributes of the 
  1203. currently selected slider control. 
  1204.  
  1205. The slider can be one of the following types: 
  1206.  
  1207.  Snap to Increment The slider arm position, when moved, will be adjusted to the 
  1208.            nearest increment value and will be redrawn at that position. 
  1209.  
  1210.  Owner Draw The application is to be notified whenever the painting of the 
  1211.            slider shaft, the ribbon strip, or the slider background is to take 
  1212.            place. 
  1213.  
  1214.  Read only Provide a read-only slider. 
  1215.  
  1216.  Ribbon strip Provide a ribbon strip for the control. 
  1217.  
  1218.  Orientation The choices are horizontal or vertical for the long axis of the 
  1219.            control. A horizontal slider can be positioned left and right;  a 
  1220.            vertical slider can be positioned up and down. 
  1221.  
  1222.  Shaft offset This setting locates the shaft within the control. The choices 
  1223.            are bottom, center, or top for horizontal orientation, or left, 
  1224.            center, or right for vertical orientation. 
  1225.  
  1226.  Buttons position If the slider is to have buttons for incremental movement, 
  1227.            the buttons position may be set to the bottom or top (in vertical 
  1228.            orientation) or left or right (in horizontal orientation). The 
  1229.            default is no buttons. 
  1230.  
  1231.  Home position The home position may be set to the bottom or top (in vertical 
  1232.            orientation) or left or right (in horizontal orientation). The 
  1233.            default home position is bottom for a vertical slider and left for a 
  1234.            horizontal slider. 
  1235.  
  1236.  Primary scale The choices are ruler 1 or ruler 2.  Ruler 1 scales the length 
  1237.            of the slider to the first value previously entered;  ruler 2 scales 
  1238.            the length of the slider to the second value entered. 
  1239.  
  1240.  See also: Basic styles 
  1241.  
  1242.  
  1243. ΓòÉΓòÉΓòÉ 9.8.18. Spin button styles - set dialog ΓòÉΓòÉΓòÉ
  1244.  
  1245. The Spin button styles - set dialog is used to change the attributes of the 
  1246. currently selected spin button control. 
  1247.  
  1248. The spin button can be one of the following types: 
  1249.  
  1250.  No Border The button might or might not have a border. 
  1251.  
  1252.  Fast spin Spin speed can be fast or normal. 
  1253.  
  1254.  Zero pad  Numbers can be padded on the front with zeroes. 
  1255.  
  1256.  Character Acceptance The characters accepted can be either all characters, or 
  1257.            only the digits 0-9 and virtual keys, or no characters at all (read 
  1258.            only). 
  1259.  
  1260.  Component Type The choices are master or servant.  Master components have spin 
  1261.            arrows, while servant components do not. 
  1262.  
  1263.  Justification This setting determines the positioning of data in the display 
  1264.            fields. The choices are the default (left justify), left, right, or 
  1265.            center. 
  1266.  
  1267.  See also: Basic styles 
  1268.  
  1269.  
  1270. ΓòÉΓòÉΓòÉ 9.8.19. Text styles - set dialog ΓòÉΓòÉΓòÉ
  1271.  
  1272. The Text styles - set dialog is used to change the attributes of the currently 
  1273. selected text control. 
  1274.  
  1275. The text can be horizontally aligned in one of the following ways: 
  1276.  
  1277.  Left      Left justified. 
  1278.  
  1279.  Center    Centered horizontally. 
  1280.  
  1281.  Right     Right justified. 
  1282.  
  1283.  If the text control is larger than one line, the text within the rectangle of 
  1284.  the text control can be vertically aligned in one of the following ways: 
  1285.  
  1286.  Top       At the top of the bounding rectangle. 
  1287.  
  1288.  Center    Centered vertically in the rectangle. 
  1289.  
  1290.  Bottom    At the bottom of the bounding rectangle. 
  1291.  
  1292.  The following styles are also available: 
  1293.  
  1294.  Halftone  The text will be displayed in a halftone color. 
  1295.  
  1296.  Mnemonic  If a mnemonic prefix character is encountered, draw the next 
  1297.            character with mnemonic emphasis. 
  1298.  
  1299.  Word break Only complete words will be shown in the text control. This is most 
  1300.            useful if the text control is larger than one line high. 
  1301.  
  1302.  See also: Basic styles 
  1303.  
  1304.  
  1305. ΓòÉΓòÉΓòÉ 9.8.20. User control styles set - dialog ΓòÉΓòÉΓòÉ
  1306.  
  1307. The User Control styles - set dialog is used to change the attributes of the 
  1308. currently selected user defined control. 
  1309.  
  1310. The Class entry field is used to enter a custom window class.  This class 
  1311. string will be written out in the dialog template in quotes.  The application 
  1312. that uses the dialog with this control must register this window class before 
  1313. the dialog is loaded. 
  1314.  
  1315. See also: Basic styles 
  1316.  
  1317.  
  1318. ΓòÉΓòÉΓòÉ 9.8.21. Value set styles - set dialog ΓòÉΓòÉΓòÉ
  1319.  
  1320. The Value set styles - set dialog is used to change the attributes of the 
  1321. currently selected value set control. 
  1322.  
  1323. The value set can be one of the following types: 
  1324.  
  1325.  Default type The choices are:  bitmaps, icons, text strings, color 
  1326.            information, or color indices. 
  1327.  
  1328.  Border    A border may be placed around the control, or around each item in 
  1329.            it. 
  1330.  
  1331.  Ordering  The ordering may be right to left, or left to right. 
  1332.  
  1333.  See also: Basic styles 
  1334.  
  1335.  
  1336. ΓòÉΓòÉΓòÉ 9.8.22. Vertical scroll bar styles - set dialog ΓòÉΓòÉΓòÉ
  1337.  
  1338. The Vertical scroll bar styles - set dialog is used to change the attributes of 
  1339. the currently selected vertical scroll bar control. 
  1340.  
  1341. See also: Basic styles 
  1342.  
  1343.  
  1344. ΓòÉΓòÉΓòÉ 9.8.23. Handwriting styles - set dialog ΓòÉΓòÉΓòÉ
  1345.  
  1346. The Handwriting styles - set dialog is used to change the attributes of the 
  1347. currently selected handwriting control. 
  1348.  
  1349. The Border style determines what kind of border the control has. The 
  1350. handwriting entry control can have one of the following borders: 
  1351.  
  1352.  Border    A single line border. 
  1353.  
  1354.  3D        A wider border to give the appearance of a raised control. 
  1355.  
  1356.  None      No border. 
  1357.  
  1358.  See also: Basic styles 
  1359.  
  1360.  
  1361. ΓòÉΓòÉΓòÉ 9.8.24. Sketch styles - set dialog ΓòÉΓòÉΓòÉ
  1362.  
  1363. The Sketch styles - set dialog is used to change the attributes of the 
  1364. currently selected sketch control. 
  1365.  
  1366. The Border style determines what kind of border the control has. The sketch 
  1367. control can have one of the following borders: 
  1368.  
  1369.  Border    A single line border. 
  1370.  
  1371.  3D        A wider border to give the appearance of a raised control. 
  1372.  
  1373.  None      No border. 
  1374.  
  1375.  See also: Basic styles 
  1376.  
  1377.  
  1378. ΓòÉΓòÉΓòÉ 9.8.25. Basic Styles ΓòÉΓòÉΓòÉ
  1379.  
  1380. All of the controls have the following basic styles: 
  1381.  
  1382.  Visible   If this style is not set, the control will initially be invisible. 
  1383.  
  1384.  Disabled  A disabled control cannot be selected, and usually is displayed in a 
  1385.            "greyed" color. 
  1386.  
  1387.  Group     A control with this attribute begins a new "group".  Controls in a 
  1388.            group are usually positioned close together in a logical unit. The 
  1389.            arrow keys will cycle through controls in a group in the order that 
  1390.            they are defined in the dialog.  Use the Arrange/Order groups dialog 
  1391.            to change this order. 
  1392.  
  1393.  Tabstop   A control that has a tabstop style can be jumped to by pressing the 
  1394.            Tab key, if the control type supports it. 
  1395.  
  1396.  
  1397. ΓòÉΓòÉΓòÉ 9.8.26. DBCS Support Styles ΓòÉΓòÉΓòÉ
  1398.  
  1399. Entry field controls and combo box controls have the following DBCS (Double 
  1400. Byte Character Set) support styles: 
  1401.  
  1402.  Any       Allows the entry-field text to contain a mixture of double-byte and 
  1403.            single-byte characters. 
  1404.  
  1405.  Mixed     Allows the entry-field text to contain a mixture of single-byte and 
  1406.            double-byte characters. Unlike the ES_ANY style, this style allows 
  1407.            ASCII DBCS data to be converted to EBCDIC DBCS data without causing 
  1408.            an overflow condition. 
  1409.  
  1410.  SBCS only Specifies that the entry-field text is single-byte characters only. 
  1411.  
  1412.  DBCS only Specifies that the entry-field text is double-byte characters only. 
  1413.  
  1414.  
  1415. ΓòÉΓòÉΓòÉ 9.9. Presentation parameters ΓòÉΓòÉΓòÉ
  1416.  
  1417. The Edit/Presentation parameters command displays the presentation parameters 
  1418. dialog for the selected control or dialog.  If a group of controls is selected, 
  1419. the presentation parameters dialog for the anchor control is shown. 
  1420.  
  1421. The Presentation parameters - set dialog allows you to set various presentation 
  1422. parameters of the selected dialog or control.  For example, the background and 
  1423. foreground colors of an entry field can be set in this dialog. 
  1424.  
  1425.  
  1426. ΓòÉΓòÉΓòÉ 9.10. Size to text ΓòÉΓòÉΓòÉ
  1427.  
  1428. The Edit/Size to text command will size the width of selected controls so that 
  1429. they exactly fit their text. 
  1430.  
  1431. The following control types can be sized to their text: 
  1432.  
  1433.    o  Check box 
  1434.    o  Push button 
  1435.    o  Radio button 
  1436.    o  Text 
  1437.  
  1438.  You may size a single control to exactly fit its text, or you can select a 
  1439.  group of controls and size them all at once.  If a group of controls are 
  1440.  selected and this command is used, only those controls that can be sized to 
  1441.  their text will be affected. 
  1442.  
  1443.  There are special rules used when sizing a push button control.  The width 
  1444.  will never be smaller than the default size of a push button.  The largest 
  1445.  text that exactly fits within this default size is the text "Cancel".  Any 
  1446.  text that is larger than this will cause the size of the push button to be 
  1447.  increased by the difference between its size and the size of the "Cancel" 
  1448.  text.  These rules always keep a margin around the text inside the push 
  1449.  button, and do not size a button to be smaller than the default size. 
  1450.  
  1451.  
  1452. ΓòÉΓòÉΓòÉ 9.11. New dialog ΓòÉΓòÉΓòÉ
  1453.  
  1454. The Edit/New dialog command creates a new dialog and adds it to the current 
  1455. resource file.  Note that there can be many dialogs in a single resource file. 
  1456.  
  1457.  
  1458. ΓòÉΓòÉΓòÉ 9.12. Dialog - select ΓòÉΓòÉΓòÉ
  1459.  
  1460. The Edit/Select dialog command displays the Dialog - select dialog, which 
  1461. allows you to choose a dialog to display and edit out of all the dialogs in the 
  1462. current resource file. 
  1463.  
  1464.  
  1465. ΓòÉΓòÉΓòÉ 9.13. Dialog - select dialog ΓòÉΓòÉΓòÉ
  1466.  
  1467. The Dialog - select dialog displays a list box which contains all the dialogs 
  1468. that are in the current resource file. 
  1469.  
  1470. To select a dialog to view or edit, either double-click on the name of the 
  1471. dialog in the list, or select it and press the OK button. 
  1472.  
  1473.  
  1474. ΓòÉΓòÉΓòÉ 10. Control Menu ΓòÉΓòÉΓòÉ
  1475.  
  1476. Use the Control menu to add new controls to the current dialog.  Selecting one 
  1477. of the controls from the menu will begin the operation of dropping a new 
  1478. control.  First, an outline of the control will be shown within the dialog. 
  1479. Use the mouse to position the outline where you want the control to be placed, 
  1480. then click mouse button one. 
  1481.  
  1482. New controls can also be added to the current dialog by using the Control 
  1483. Palette, located along the right edge of the dialog editor.  Simply click on 
  1484. the control that is desired, move the mouse to position the control then click 
  1485. mouse button one again. 
  1486.  
  1487. The following controls are available: 
  1488.  
  1489.       Bitmap 
  1490.       Check box 
  1491.       Combo box 
  1492.       Container 
  1493.       Entry field 
  1494.       Frame 
  1495.       Group box 
  1496.       Horz. scroll bar 
  1497.       Icon 
  1498.       List box 
  1499.       MLE 
  1500.       Notebook 
  1501.       Push button 
  1502.       Radio button 
  1503.       Rectangle 
  1504.       Slider 
  1505.       Spin Button 
  1506.       Text 
  1507.       User defined 
  1508.       Value Set 
  1509.       Vert. scroll bar 
  1510.  
  1511.  
  1512. ΓòÉΓòÉΓòÉ 10.1. Bitmap ΓòÉΓòÉΓòÉ
  1513.  
  1514. The Control/Bitmap command adds a new bitmap control to the current dialog. 
  1515.  
  1516. A bitmap control is a rectangle that marks the position for a bitmap.  The 
  1517. bitmap itself is defined in a bitmap (.BMP) file that you can create using the 
  1518. Icon Editor. When the dialog editor has created a bitmap control in the dialog 
  1519. being edited, a sample bitmap will be displayed. 
  1520.  
  1521. The sample bitmap control cannot be sized. The actual size displayed in the 
  1522. dialog when it is being used in an application depends on the size of the 
  1523. bitmap resource that the bitmap control is associated with, so the size of the 
  1524. bitmap control when editing does not matter. 
  1525.  
  1526. See also: Bitmap Styles dialog 
  1527.  
  1528.  
  1529. ΓòÉΓòÉΓòÉ 10.2. Check box ΓòÉΓòÉΓòÉ
  1530.  
  1531. The Control/Check box command adds a new check box control to the current 
  1532. dialog. 
  1533.  
  1534. A check box control is a small square with a text label to the right. It is 
  1535. normally used in groups that allow many items (or none) to be selected. 
  1536. Clicking on the square or the text checks or unchecks the control. 
  1537.  
  1538. See also: Check Box Styles dialog 
  1539.  
  1540.  
  1541. ΓòÉΓòÉΓòÉ 10.3. Combo box ΓòÉΓòÉΓòÉ
  1542.  
  1543. The Control/Combo box command adds a new combo box control to the current 
  1544. dialog. 
  1545.  
  1546. A combo box control is a combination of an entry field and list box, allowing 
  1547. the user to select an item from a list, placing the text of that item into the 
  1548. entry field.  The list may be hidden, saving room in the dialog. 
  1549.  
  1550. See also: Combo Box Styles dialog 
  1551.  
  1552.  
  1553. ΓòÉΓòÉΓòÉ 10.4. Container ΓòÉΓòÉΓòÉ
  1554.  
  1555. The Control/Container command adds a new container control to the current 
  1556. dialog. 
  1557.  
  1558. A container control is a window which presents the user with a list of its 
  1559. contents in any of various views. 
  1560.  
  1561. See also: Container Styles dialog 
  1562.  
  1563.  
  1564. ΓòÉΓòÉΓòÉ 10.5. Entry field ΓòÉΓòÉΓòÉ
  1565.  
  1566. The Control/Entry field command adds a new entry field control to the current 
  1567. dialog. 
  1568.  
  1569. An entry field control is a rectangle in which a user can enter text. 
  1570.  
  1571. See also: Entry Field Styles dialog 
  1572.  
  1573.  
  1574. ΓòÉΓòÉΓòÉ 10.6. Frame ΓòÉΓòÉΓòÉ
  1575.  
  1576. The Control/Frame command adds a new frame control to the current dialog. 
  1577.  
  1578. A frame control is a rectangular frame, used in simple graphics. 
  1579.  
  1580. See also: Frame Styles dialog 
  1581.  
  1582.  
  1583. ΓòÉΓòÉΓòÉ 10.7. Group box ΓòÉΓòÉΓòÉ
  1584.  
  1585. The Control/Group box command adds a new group box control to the current 
  1586. dialog. 
  1587.  
  1588. A group box is a frame used for grouping controls together.  It has a text 
  1589. label in its top edge. 
  1590.  
  1591. See also: Group Box Styles dialog 
  1592.  
  1593.  
  1594. ΓòÉΓòÉΓòÉ 10.8. Horz. scroll bar ΓòÉΓòÉΓòÉ
  1595.  
  1596. The Control/Scroll bar/Horizontal command adds a new horizontal scroll bar 
  1597. control to the current dialog. 
  1598.  
  1599. A horizontal scroll bar lets the user scroll the contents of a window 
  1600. horizontally. The horizontal scroll bar has a scrolling arrow at each end, and 
  1601. a slider that can be set at any point in the bar. 
  1602.  
  1603. See also: Horizontal Scroll Bar Styles dialog 
  1604.  
  1605.  
  1606. ΓòÉΓòÉΓòÉ 10.9. Icon ΓòÉΓòÉΓòÉ
  1607.  
  1608. The Control/Icon command adds a new icon control to the current dialog. 
  1609.  
  1610. An icon control is a rectangle that marks the position for an icon.  The icon 
  1611. itself is defined in an icon (.ICO) file that you can create using the Icon 
  1612. Editor. When the dialog editor has created an icon control in the dialog being 
  1613. edited, a sample icon will be displayed. 
  1614.  
  1615. The sample icon control cannot be sized. The actual size displayed in the 
  1616. dialog when it is being used in an application depends on the size of the icon 
  1617. resource that the icon control is associated with, so the size of the icon 
  1618. control when editing does not matter. 
  1619.  
  1620. See also: Icon Styles dialog 
  1621.  
  1622.  
  1623. ΓòÉΓòÉΓòÉ 10.10. List box ΓòÉΓòÉΓòÉ
  1624.  
  1625. The Control/List box command adds a new list box control to the current dialog. 
  1626.  
  1627. A list box control is a rectangle with a vertical scroll bar on its right side. 
  1628. It is used to display a list of strings, such as file names. 
  1629.  
  1630. See also: List Box Styles dialog 
  1631.  
  1632.  
  1633. ΓòÉΓòÉΓòÉ 10.11. MLE ΓòÉΓòÉΓòÉ
  1634.  
  1635. The Control/MLE command adds a new Multi-Line Edit (MLE) control to the current 
  1636. dialog. 
  1637.  
  1638. An MLE control is a special type of entry field that allows the text to be 
  1639. entered on multiple lines. 
  1640.  
  1641. See also: MLE Styles dialog 
  1642.  
  1643.  
  1644. ΓòÉΓòÉΓòÉ 10.12. Notebook ΓòÉΓòÉΓòÉ
  1645.  
  1646. The Control/Notebook command adds a new notebook control to the current dialog. 
  1647.  
  1648. A notebook control is a window which organizes information on individual pages 
  1649. so that a user can find and display that information quickly and easily. 
  1650.  
  1651. See also: Notebook Styles dialog 
  1652.  
  1653.  
  1654. ΓòÉΓòÉΓòÉ 10.13. Push button ΓòÉΓòÉΓòÉ
  1655.  
  1656. The Control/Push button command adds a new push button control to the current 
  1657. dialog. 
  1658.  
  1659. A push button control is a rectangle with rounded corners, containing a text 
  1660. label. Clicking on it with the mouse activates it and causes an application 
  1661. defined action to occur. 
  1662.  
  1663. See also: Push Button Styles dialog 
  1664.  
  1665.  
  1666. ΓòÉΓòÉΓòÉ 10.14. Radio button ΓòÉΓòÉΓòÉ
  1667.  
  1668. The Control/Radio button command adds a new radio button control to the current 
  1669. dialog. 
  1670.  
  1671. A radio button control is a small circle with a text label to the right. It is 
  1672. normally used in groups that allow only one item at a time to be selected. 
  1673. Clicking on the circle or the text chooses that option instead of any other one 
  1674. in the group. 
  1675.  
  1676. See also: Radio Button Styles dialog 
  1677.  
  1678.  
  1679. ΓòÉΓòÉΓòÉ 10.15. Rectangle ΓòÉΓòÉΓòÉ
  1680.  
  1681. The Control/Rectangle command adds a new rectangle control to the current 
  1682. dialog. 
  1683.  
  1684. A rectangle control is a colored rectangle, typically used in simple graphics. 
  1685. By flattening the rectangle to a line, it is also useful for making a 
  1686. separating line or bar between controls. 
  1687.  
  1688. See also: Rectangle Styles dialog 
  1689.  
  1690.  
  1691. ΓòÉΓòÉΓòÉ 10.16. Slider ΓòÉΓòÉΓòÉ
  1692.  
  1693. The Control/Slider command adds a new slider control to the current dialog. 
  1694.  
  1695. A slider control is a window which allows selection of a value from a range. 
  1696.  
  1697. See also: Slider Styles dialog 
  1698.  
  1699.  
  1700. ΓòÉΓòÉΓòÉ 10.17. Spin Button ΓòÉΓòÉΓòÉ
  1701.  
  1702. The Control/Spin Button command adds a new spin button control to the current 
  1703. dialog. 
  1704.  
  1705. A spin button control is a window which allows access to a sequenced list of 
  1706. string data values, but which occupies less space in the dialog than a list 
  1707. box. 
  1708.  
  1709. See also: Spin Button Styles dialog 
  1710.  
  1711.  
  1712. ΓòÉΓòÉΓòÉ 10.18. Text ΓòÉΓòÉΓòÉ
  1713.  
  1714. The Control/Text command adds a new text control to the current dialog. 
  1715.  
  1716. A text control is used to display a text label within a dialog. 
  1717.  
  1718. See also: Text Styles dialog 
  1719.  
  1720.  
  1721. ΓòÉΓòÉΓòÉ 10.19. User defined ΓòÉΓòÉΓòÉ
  1722.  
  1723. The Control/User defined command adds a new user defined control to the current 
  1724. dialog. 
  1725.  
  1726. A user defined control is any window defined by an applications developer with 
  1727. an application defined window procedure (and such processing), that is intended 
  1728. for specialized input or display.  When one of these controls is added to the 
  1729. dialog, a colored rectangle is shown in the dialog as an outline of where the 
  1730. user defined control will appear.  The User Control Styles dialog is used to 
  1731. specify the application defined class for each user control. 
  1732.  
  1733. See also: User Control Styles dialog 
  1734.  
  1735.  
  1736. ΓòÉΓòÉΓòÉ 10.20. Value Set ΓòÉΓòÉΓòÉ
  1737.  
  1738. The Control/Value Set command adds a new Value Set control to the current 
  1739. dialog. 
  1740.  
  1741. A value set control is a window which gives the user a choice of values to be 
  1742. displayed. They can be either graphical images, colors, text, or numeric 
  1743. representations of the data.  When starting the control, the user specifies the 
  1744. number of rows and columns in which the data will be arranged. 
  1745.  
  1746. See also: Value Set Styles dialog 
  1747.  
  1748.  
  1749. ΓòÉΓòÉΓòÉ 10.21. Vert. scroll bar ΓòÉΓòÉΓòÉ
  1750.  
  1751. The Control/Scroll bar/Vertical command adds a new vertical scroll bar control 
  1752. to the current dialog. 
  1753.  
  1754. A vertical scroll bar lets the user scroll the contents of a window vertically. 
  1755. The vertical scroll bar has a scrolling arrow at each end, and a slider that 
  1756. can be set at any point in the bar. 
  1757.  
  1758. See also: Vertical Scroll Bar Styles dialog 
  1759.  
  1760.  
  1761. ΓòÉΓòÉΓòÉ 10.22. Scroll bar ΓòÉΓòÉΓòÉ
  1762.  
  1763. Use the Control/Scroll bar menu to add a new horizontal or vertical scroll bar 
  1764. control to the current dialog. 
  1765.  
  1766.  
  1767. ΓòÉΓòÉΓòÉ 10.23. Pen ΓòÉΓòÉΓòÉ
  1768.  
  1769. Use the Control/Pen menu to add a new handwriting or sketch control to the 
  1770. current dialog. 
  1771.  
  1772.  
  1773. ΓòÉΓòÉΓòÉ 10.24. Handwriting entry control ΓòÉΓòÉΓòÉ
  1774.  
  1775. Use the Control/Pen/Handwriting command to add a new handwriting entry control 
  1776. to the current dialog. 
  1777.  
  1778. The user of a handwriting entry control may input handwritten text and have 
  1779. text be recognized and converted to characters. 
  1780.  
  1781.  
  1782. ΓòÉΓòÉΓòÉ 10.25. Sketch input control ΓòÉΓòÉΓòÉ
  1783.  
  1784. Use the Control/Pen/Sketch command to add a new sketch input control to the 
  1785. current dialog. 
  1786.  
  1787. A sketch control is a visual component that provides the user with a stroke 
  1788. capture with delivery mechanism. 
  1789.  
  1790. The user may input a signature, have the collection of strokes or signature 
  1791. captured into a sketch database and rendered in order to allow editor-oriented 
  1792. applications to get the sketch bitmap without having to modify the code. 
  1793.  
  1794.  
  1795. ΓòÉΓòÉΓòÉ 11. Arrange Menu ΓòÉΓòÉΓòÉ
  1796.  
  1797. The following commands are available from the Arrange menu: 
  1798.  
  1799.  Align     Commands to align controls along an edge. 
  1800.  
  1801.  Even spacing Commands to evenly space controls. 
  1802.  
  1803.  Same size Commands to set controls to the same size. 
  1804.  
  1805.  Push buttons Commands to arrange push buttons. 
  1806.  
  1807.  Order groups Displays the Arrange/Order groups dialog, which allows the order 
  1808.            of controls and groups to be changed. 
  1809.  
  1810.  Settings  Displays the Settings - change dialog, which allows the grid and 
  1811.            spacing constants to be changed. 
  1812.  
  1813.  
  1814. ΓòÉΓòÉΓòÉ 11.1. Align ΓòÉΓòÉΓòÉ
  1815.  
  1816. The following commands are available from the Arrange/Align menu: 
  1817.  
  1818.       Left edges. 
  1819.  
  1820.       Vertically centered. 
  1821.  
  1822.       Right edges. 
  1823.  
  1824.       Top edges. 
  1825.  
  1826.       Horizontally centered. 
  1827.  
  1828.       Bottom edges. 
  1829.  
  1830.  
  1831. ΓòÉΓòÉΓòÉ 11.1.1. Left edges ΓòÉΓòÉΓòÉ
  1832.  
  1833. The Arrange/Align/Left edges command will align all the selected controls with 
  1834. the anchor control's left edge. 
  1835.  
  1836.  
  1837. ΓòÉΓòÉΓòÉ 11.1.2. Vertically centered ΓòÉΓòÉΓòÉ
  1838.  
  1839. The Arrange/Align/Vertically centered command will vertically center all the 
  1840. selected controls with the anchor control's center. 
  1841.  
  1842.  
  1843. ΓòÉΓòÉΓòÉ 11.1.3. Right edges ΓòÉΓòÉΓòÉ
  1844.  
  1845. The Arrange/Align/Right edges command will align all the selected controls with 
  1846. the anchor control's right edge. 
  1847.  
  1848.  
  1849. ΓòÉΓòÉΓòÉ 11.1.4. Top edges ΓòÉΓòÉΓòÉ
  1850.  
  1851. The Arrange/Align/Top edges command will align all the selected controls with 
  1852. the anchor control's top edge. 
  1853.  
  1854.  
  1855. ΓòÉΓòÉΓòÉ 11.1.5. Horizontally centered ΓòÉΓòÉΓòÉ
  1856.  
  1857. The Arrange/Align/Horizontally centered command will horizontally center all 
  1858. the selected controls with the anchor control's center. 
  1859.  
  1860.  
  1861. ΓòÉΓòÉΓòÉ 11.1.6. Bottom edges ΓòÉΓòÉΓòÉ
  1862.  
  1863. The Arrange/Align/Bottom edges command will align all the selected controls 
  1864. with the anchor control's bottom edge. 
  1865.  
  1866.  
  1867. ΓòÉΓòÉΓòÉ 11.2. Even spacing ΓòÉΓòÉΓòÉ
  1868.  
  1869. The following commands are available from the Arrange/Even spacing menu: 
  1870.  
  1871.       Vertically 
  1872.  
  1873.       Horizontally 
  1874.  
  1875.  
  1876. ΓòÉΓòÉΓòÉ 11.2.1. Vertically ΓòÉΓòÉΓòÉ
  1877.  
  1878. The Arrange/Even spacing/Vertically command will distribute all the selected 
  1879. controls up and down from the anchor control.  Controls that are ordered before 
  1880. the anchor control will be positioned above the anchor control, and controls 
  1881. that are ordered after it will be positioned below. 
  1882.  
  1883. The most common use of this command is to arrange a group of radio buttons or 
  1884. check boxes.  To do this, select the controls, drag either the first or last 
  1885. control into position (because it was the last control clicked on it will 
  1886. become the anchor) then choose this command.  You might also need to use the 
  1887. Arrange/Align/Left edges command to make the column of controls line up. 
  1888.  
  1889. The Vertical Control Spacing constant that is used to determine how much space 
  1890. is between each control can be changed using the Settings - change dialog. 
  1891.  
  1892. While spacing controls vertically with respect to an anchor, when the Dialog 
  1893. Editor reaches the top or bottom of the client window before placing all of the 
  1894. ordered controls, it will position the remaining controls at that edge. 
  1895.  
  1896.  
  1897. ΓòÉΓòÉΓòÉ 11.2.2. Horizontally ΓòÉΓòÉΓòÉ
  1898.  
  1899. The Arrange/Even spacing/Horizontally command will distribute all the selected 
  1900. controls left and right from the anchor control.  Controls that are ordered 
  1901. before the anchor control will be positioned to the left of the anchor control, 
  1902. and controls that are ordered after it will be positioned to the right. 
  1903.  
  1904. The Horizontal Control Spacing constant that is used to determine how much 
  1905. space is between each control can be changed using the Settings - change 
  1906. dialog. 
  1907.  
  1908. While spacing controls horizontally with respect to an anchor, when the Dialog 
  1909. Editor reaches the left or right edge of the client window before placing all 
  1910. of the ordered controls, it will position the remaining controls at that edge. 
  1911.  
  1912.  
  1913. ΓòÉΓòÉΓòÉ 11.3. Same size ΓòÉΓòÉΓòÉ
  1914.  
  1915. The following commands are available from the Arrange/Same size menu: 
  1916.  
  1917.       Width 
  1918.  
  1919.       Height 
  1920.  
  1921.  
  1922. ΓòÉΓòÉΓòÉ 11.3.1. Width ΓòÉΓòÉΓòÉ
  1923.  
  1924. The Arrange/Same size/Width command will size all the selected controls so that 
  1925. their width is the same as the anchor control's width. 
  1926.  
  1927.  
  1928. ΓòÉΓòÉΓòÉ 11.3.2. Height ΓòÉΓòÉΓòÉ
  1929.  
  1930. The Arrange/Same size/Height command will size all the selected controls so 
  1931. that their height is the same as the anchor control's height. 
  1932.  
  1933.  
  1934. ΓòÉΓòÉΓòÉ 11.4. Push buttons ΓòÉΓòÉΓòÉ
  1935.  
  1936. The following commands are available from the Arrange/Push buttons menu: 
  1937.  
  1938.       Along bottom. 
  1939.  
  1940.       Down right side. 
  1941.  
  1942.  
  1943. ΓòÉΓòÉΓòÉ 11.4.1. Along bottom ΓòÉΓòÉΓòÉ
  1944.  
  1945. The Arrange/Push buttons/Along bottom command is used to arrange push buttons 
  1946. along the bottom of the dialog. 
  1947.  
  1948. The buttons are always arranged in the order they are defined, regardless of 
  1949. which one is the anchor control.  The first button will be placed in the lower 
  1950. left corner of the dialog, inset by the horizontal and vertical margins. 
  1951. Following buttons will be placed to the right of this, with a fixed horizontal 
  1952. push button spacing between them. 
  1953.  
  1954. If either the dialog itself or nothing is selected, all the push buttons in the 
  1955. dialog will be arranged.  This makes it easy to arrange all the push buttons in 
  1956. the dialog by simply selecting the dialog (click on its titlebar) then choosing 
  1957. this command.  If, however, the dialog has a few buttons that should not be 
  1958. arranged, simply select only the buttons that you want arranged before choosing 
  1959. this command. 
  1960.  
  1961. To change the order of the push buttons, use the Arrange/Order groups dialog. 
  1962.  
  1963. To change the margins or the push button spacing constants, use the Settings - 
  1964. change dialog. 
  1965.  
  1966.  
  1967. ΓòÉΓòÉΓòÉ 11.4.2. Down right side ΓòÉΓòÉΓòÉ
  1968.  
  1969. The Arrange/Push buttons/Down right side command is used to arrange push 
  1970. buttons down the right side of the dialog. 
  1971.  
  1972. The buttons are always arranged in the order they are defined, regardless of 
  1973. which one is the anchor control.  The first button will be placed in the upper 
  1974. right corner of the dialog, inset by the horizontal and vertical margins. 
  1975. Following buttons will be placed below this, with a fixed vertical push button 
  1976. spacing between them. 
  1977.  
  1978. If either the dialog itself or nothing is selected, all the push buttons in the 
  1979. dialog will be arranged.  This makes it easy to arrange all the push buttons in 
  1980. the dialog by simply selecting the dialog (click on its titlebar) then choosing 
  1981. this command.  If, however, the dialog has a few buttons that should not be 
  1982. arranged, simply select only the buttons that you want arranged before choosing 
  1983. this command. 
  1984.  
  1985. To change the order of the push buttons, use the Arrange/Order groups dialog. 
  1986.  
  1987. To change the margins or the push button spacing constants, use the Settings - 
  1988. change dialog. 
  1989.  
  1990.  
  1991. ΓòÉΓòÉΓòÉ 11.5. Order groups ΓòÉΓòÉΓòÉ
  1992.  
  1993. The Arrange/Order groups command displays the Arrange/Order groups dialog, 
  1994. which allows you to gather controls into groups and to change the order in 
  1995. which the selection cursor moves around the controls. 
  1996.  
  1997.  
  1998. ΓòÉΓòÉΓòÉ 11.6. Arrange/Order groups Dialog ΓòÉΓòÉΓòÉ
  1999.  
  2000. The Arrange/Order groups dialog allows you to change the order in which the 
  2001. selection cursor moves around the controls and to gather controls together into 
  2002. groups. 
  2003.  
  2004. The list box shows the order in which the selection cursor moves between the 
  2005. controls when the user presses the arrow and tab keys. The position of a 
  2006. control in the dialog does not affect the order. Initially, the controls are 
  2007. listed in the order they were created. 
  2008.  
  2009. To change the position of a control in the list, click on its name to select 
  2010. it. Then position the pointer in the list where you want the name to appear. 
  2011. The pointer changes shape when it is over a place where you can insert the 
  2012. name. To insert the control name, click the mouse button. 
  2013.  
  2014. To create a group of controls, select the name of the control that you want to 
  2015. appear as the first in the group, then press the Group Marker button. 
  2016.  
  2017. To remove a group marker, select the group marker, then press the Delete Group 
  2018. button. 
  2019.  
  2020. An asterisk to the left of a control name means that the control has a tab 
  2021. stop. The cursor moves to the next control that has a tab stop when the user 
  2022. presses the tab key. 
  2023.  
  2024. To set a tab, select the control name, then press the Tab Stop button. 
  2025.  
  2026. To delete a tab, select the control name, then press the Delete Tab button. 
  2027.  
  2028. To accept the changes, press the OK button.  To ignore the changes, press the 
  2029. Cancel button. 
  2030.  
  2031.  
  2032. ΓòÉΓòÉΓòÉ 11.7. Settings ΓòÉΓòÉΓòÉ
  2033.  
  2034. The Arrange/Settings command displays the Settings - change dialog,  which 
  2035. allows various grid and spacing constants to be changed. 
  2036.  
  2037.  
  2038. ΓòÉΓòÉΓòÉ 11.8. Settings -change dialog ΓòÉΓòÉΓòÉ
  2039.  
  2040. The Settings - change dialog allows you to change the grid and spacing values 
  2041. used when positioning and aligning controls. 
  2042.  
  2043. The Grid values are used when sizing and positioning controls.  Control 
  2044. coordinates will only be allowed to be exact multiples of the grid values.  A 
  2045. grid value greater than one can be useful when aligning controls with each 
  2046. other. 
  2047.  
  2048. The Control Spacing constants are used with the Arrange/Even spacing/Vertically 
  2049. and Arrange/Even spacing/Horizontally commands.  These constants are the number 
  2050. of dialog units between controls that are spaced using these commands. 
  2051.  
  2052. The Margins are used with the Arrange/Push buttons/Along bottom and 
  2053. Arrange/Push buttons/Down right side commands.  They determine the number of 
  2054. dialog units that the buttons are inset from the edges of the dialog. 
  2055.  
  2056. The Push Button Spacing constants are also used with the Arrange/Push 
  2057. buttons/Along bottom and Arrange/Push buttons/Down right side commands.  These 
  2058. constants are the number of dialog units between push buttons that are arranged 
  2059. with these commands. 
  2060.  
  2061. To accept the changes, press the OK button.  The changes that you make to the 
  2062. settings will be remembered between editing sessions.  Use the Defaults button 
  2063. to restore all the settings to the application defaults.  To ignore the 
  2064. changes, press the Cancel button. 
  2065.  
  2066.  
  2067. ΓòÉΓòÉΓòÉ 12. Options Menu ΓòÉΓòÉΓòÉ
  2068.  
  2069. The following commands are available from the Options menu: 
  2070.  
  2071.  Test mode Tests the current dialog. 
  2072.  
  2073.  Hex mode  Turns hex mode on or off. 
  2074.  
  2075.  Translate mode Turns translate mode on or off. 
  2076.  
  2077.  Enable 2.0 styles Enables OS/2 version 2.0 specific styles. 
  2078.  
  2079.  Show status window Shows/hides the status area at the top of the window. 
  2080.  
  2081.  
  2082. ΓòÉΓòÉΓòÉ 12.1. Test mode ΓòÉΓòÉΓòÉ
  2083.  
  2084. The Options/Test mode command enters test mode. This will create a working copy 
  2085. of the current dialog, and allows the actions of the various controls to be 
  2086. tested. 
  2087.  
  2088. List boxes and combo boxes will have sample lines inserted into them. 
  2089.  
  2090. Certain styles of some controls will not be allowed in test mode. For instance, 
  2091. a dialog with the System Modal style can be tested, but it will not behave 
  2092. exactly like an actual system modal dialog would. 
  2093.  
  2094. There are several ways to exit test mode.  You can choose the Options/Test mode 
  2095. command again.  If the dialog has a system menu, the Close command of this menu 
  2096. will also exit test mode. 
  2097.  
  2098.  
  2099. ΓòÉΓòÉΓòÉ 12.2. Hex mode ΓòÉΓòÉΓòÉ
  2100.  
  2101. The Options/Hex mode command turns hex mode on or off. When hex mode is on, the 
  2102. id values of the controls and symbols are displayed in hex notation.  When it 
  2103. is off, the values are displayed in decimal notation. 
  2104.  
  2105. The hex mode also determines how the id values are written out in the include 
  2106. (.H) file. 
  2107.  
  2108.  
  2109. ΓòÉΓòÉΓòÉ 12.3. Translate mode ΓòÉΓòÉΓòÉ
  2110.  
  2111. The Options/Translate mode command turns translate mode on or off.  Translate 
  2112. mode is used when translating dialogs into another language. 
  2113.  
  2114. When in this mode, various editing commands are disabled.  The text of controls 
  2115. can still be changed, and controls can be sized and positioned (to accommodate 
  2116. the changed text) but new controls cannot be added, existing controls cannot be 
  2117. deleted or have their styles or id values changed. 
  2118.  
  2119.  
  2120. ΓòÉΓòÉΓòÉ 12.4. Enable 2.0 styles ΓòÉΓòÉΓòÉ
  2121.  
  2122. The Options/Enable 2.0 styles command enables several styles that are specific 
  2123. to OS/2 version 2.0.  These style options will be disabled in the different 
  2124. styles dialogs if this option is not enabled. 
  2125.  
  2126. Disable this option if you are developing dialogs for a version of OS/2 prior 
  2127. to version 2.0. 
  2128.  
  2129.  
  2130. ΓòÉΓòÉΓòÉ 12.5. Show status area ΓòÉΓòÉΓòÉ
  2131.  
  2132. The Options/Show status area command toggles the visibility of all of the 
  2133. information in the status area at the top of the main edit window. 
  2134.  
  2135.  
  2136. ΓòÉΓòÉΓòÉ 13. Help Menu ΓòÉΓòÉΓòÉ
  2137.  
  2138. The following commands are available from the Help menu: 
  2139.  
  2140.  General help Displays general help for the Dialog Editor. 
  2141.  
  2142.  Using help Displays how to use the help facility. 
  2143.  
  2144.  Keys help Displays help for the keys used in the editor. 
  2145.  
  2146.  Help index Displays an index of help topics. 
  2147.  
  2148.  Product information Displays the Product information dialog box. 
  2149.  
  2150.  
  2151. ΓòÉΓòÉΓòÉ 13.1. General help ΓòÉΓòÉΓòÉ
  2152.  
  2153. The Help/General help command will display general help on the Dialog Editor. 
  2154.  
  2155.  
  2156. ΓòÉΓòÉΓòÉ 13.2. Using help ΓòÉΓòÉΓòÉ
  2157.  
  2158. The Help/Using help command will display how to use the help facility. 
  2159.  
  2160.  
  2161. ΓòÉΓòÉΓòÉ 13.3. Keys help ΓòÉΓòÉΓòÉ
  2162.  
  2163. The Help/Keys help command will display help for the keyboard interface to the 
  2164. dialog editor. 
  2165.  
  2166.  
  2167. ΓòÉΓòÉΓòÉ 13.4. Help index ΓòÉΓòÉΓòÉ
  2168.  
  2169. The Help/Help index command will display an index of help topics for the dialog 
  2170. editor. 
  2171.  
  2172.  
  2173. ΓòÉΓòÉΓòÉ 13.5. Product information ΓòÉΓòÉΓòÉ
  2174.  
  2175. The Help/Product information command will display the Product information 
  2176. dialog box. 
  2177.  
  2178.  
  2179. ΓòÉΓòÉΓòÉ 13.6. Product information Dialog ΓòÉΓòÉΓòÉ
  2180.  
  2181. The Product information dialog displays copyright and version information for 
  2182. the Dialog Editor.  For more specific information on using the editor, press 
  2183. Ctrl+C for a help table of contents, or press F11 for a help topic index. 
  2184.  
  2185.  
  2186. ΓòÉΓòÉΓòÉ 13.7. Presentation parameters - set dialog ΓòÉΓòÉΓòÉ
  2187.  
  2188. The Presentation parameters - set dialog allows you to change the color or font 
  2189. information for the selected control or the dialog being edited. 
  2190.  
  2191. The presentation parameters which you can change are the foreground and 
  2192. background color, the foreground and background color highlight, the foreground 
  2193. and background disabled color, the border color, and the font name and font 
  2194. size. 
  2195.  
  2196. To specify a color, enter the red, green, and blue values in the appropriate 
  2197. entry fields of the table.  The valid values for each color are in the range of 
  2198. 0 to 255. 
  2199.  
  2200. To specify a font, enter its point size in the Font size entry field.  Valid 
  2201. values range from 1 to 120 points.  Enter the name in the Font name entry 
  2202. field. 
  2203.  
  2204. To remove the definition of an existing presentation parameter, use the Del key 
  2205. to erase the text in all the affected entry fields.  To remove a color 
  2206. specification, delete the red, green, and blue values for the parameter.  To 
  2207. remove a font specification, delete both the font size and the font name. 
  2208.  
  2209. Press OK to use the values you have entered. If you do not want to change any 
  2210. presentation parameter values for this control, press Cancel. 
  2211.  
  2212.  
  2213. ΓòÉΓòÉΓòÉ 13.8. Slider control data - set ΓòÉΓòÉΓòÉ
  2214.  
  2215. The Slider control data - set dialog allows you to specify initial settings for 
  2216. a new slider control. 
  2217.  
  2218. The control data items which you can set are the number of increments for scale 
  2219. 1 (the primary scale) and the number of increments for scale 2 (the alternate 
  2220. scale).  The values you enter must be positive integers. Spacing values for 
  2221. scales 1 and 2 will be preset to 0, indicating auto spacing. 
  2222.  
  2223. Press OK to use the increment values you have entered. Press Cancel if you do 
  2224. not want to create a slider control. 
  2225.  
  2226.  
  2227. ΓòÉΓòÉΓòÉ 13.9. Value set control data - set ΓòÉΓòÉΓòÉ
  2228.  
  2229. The Value set control data - set dialog allows you to specify initial dimension 
  2230. settings for a new value set control. 
  2231.  
  2232. The control data items which you can set are the number of rows and the number 
  2233. of columns in the control.  The values you enter must be integers in the range 
  2234. of 1 to 65535. 
  2235.  
  2236. Press OK to use the row and column values you have entered. Press Cancel if you 
  2237. do not want to create a value set control.