home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / vrextras.zip / vrextras.INF (.txt) < prev    next >
OS/2 Help File  |  1995-08-29  |  32KB  |  1,054 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. VRExtras Object Pack ΓòÉΓòÉΓòÉ
  3.  
  4. The VRExtras Object Pack for VX-REXX contains 4 different objects that are 
  5. installed in the toolbar of VX-REXX: 
  6.  
  7. o VRTransparentText object 
  8. o VRLine object 
  9. o VRFormattedEntryField object 
  10. o VRScroll object 
  11.  
  12.  
  13. ΓòÉΓòÉΓòÉ 1.1. Shareware Software ΓòÉΓòÉΓòÉ
  14.  
  15. DEFINITION OF SHAREWARE SOFTWARE 
  16.  
  17. Shareware Software distribution gives users a chance to try software before 
  18. buying it. If you try a Shareware software program and continue using it, you 
  19. are expected to register. Individual programs differ on details -- some request 
  20. registration while others require it, some specify a maximum trial period. 
  21. With registration, you  get anything from the simple right to continue using 
  22. the software to an updated program with printed manual. 
  23.  
  24. Copyright laws apply to both Shareware and commercial software, and the 
  25. copyright holder retains all rights, with a few specific exceptions as stated 
  26. below. Shareware software authors are accomplished programmers, just like 
  27. commercial authors, and the programs are of comparable quality. (In both cases, 
  28. there are good programs and bad ones!)  The main difference is in the method of 
  29. distribution. The author specifically grants the right to copy and distribute 
  30. the software, either to all and sundry or to a specific group. For example, 
  31. some authors require written permission before a commercial disk vendor may 
  32. copy their Shareware software. 
  33.  
  34. Shareware software is a distribution method, not a type of software. You should 
  35. find software that suits your needs and pocketbook, whether it's commercial or 
  36. Shareware software. The Shareware software system makes fitting your needs 
  37. easier, because you can try before you buy. And because the overhead is low, 
  38. prices are low also. Shareware software has the ultimate money-back guarantee 
  39. -- if you don't use the product, you don't pay for it. 
  40.  
  41. When you register the VRExtras Object Pack you will be sent a registered 
  42. version of the DLL by e-mail. This version has the "nag" popup removed and you 
  43. have the right to freely distribute software that includes the DLL. 
  44.  
  45. If you are satisfied with the VRExtras Object Pack we ask you to freely 
  46. distribute the shareware version to your freinds and colleagues. 
  47.  
  48. If you have any suggestions for enhancements or find any bugs in the software 
  49. please contact us at one of our Contact Addresses 
  50.  
  51.  
  52. ΓòÉΓòÉΓòÉ 1.2. Registering your license ΓòÉΓòÉΓòÉ
  53.  
  54. VRExtras is a "Shareware software program" and is provided at no charge to the 
  55. user for evaluation. Feel free to share it with your friends, but please do not 
  56. give it away altered or as part of another system. The essence of 
  57. "user-supported" software is to provide personal computer users with quality 
  58. software without high prices, and yet to provide incentive for programmers to 
  59. continue to develop new products. If you find this program useful and find that 
  60. you are using the VRExtras Object Pack and continue to use the VRExtras Object 
  61. Pack after a reasonable trial period of 30  days, you must make a registration 
  62. payment of $45.00 to ADD Consulting (CH). 
  63.  
  64. You can register through the CompuServe Shareware Registration facility: 
  65.  
  66.      GO SWREG registration Number 7277 
  67.  
  68.  The registration fee will license one copy for use on any one computer at any 
  69.  one time. You must treat this software just like a book. An example is that 
  70.  this software may be used by any number of people and may be freely moved from 
  71.  one computer location to another, so long as there is no possibility of it 
  72.  being used at one location while it's being used at another. Just as a book 
  73.  cannot be read by two different persons at the same time. 
  74.  
  75.  Payment of the registration fee gives you the right to distribute programs 
  76.  that include the object and the DLL without paying any other "run-time" 
  77.  licenses. 
  78.  
  79.  Site-License arrangements may be made by contacting ADD Consulting (CH). 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 1.3. Distributing the VRExtras Object Pack ΓòÉΓòÉΓòÉ
  83.  
  84. Anyone distributing the VRExtras Object Pack for any kind of remuneration must 
  85. first contact ADD Consulting (CH) at our address below for authorization. This 
  86. authorization will be automatically granted to distributors recognized by the 
  87. (ASP) as adhering to its guidelines for shareware distributors, and such 
  88. distributors may begin offering the VRExtras Object Pack immediately, however 
  89. ADD Consulting (CH) should still be advised so that the distributor can be kept 
  90. up-to-date with the latest version of the VRExtras Object Pack. 
  91.  
  92. Registered users are free to distribute programs that use the the VRExtras 
  93. Object Pack with no additional run-time fees. 
  94.  
  95.  
  96. ΓòÉΓòÉΓòÉ 1.4. Contact Address ΓòÉΓòÉΓòÉ
  97.  
  98. You can contact ADD Consulting at the addresses below or on the OS/2 Other 
  99. Vendors on CompuServe (GO OS2AVEN) where all our products are supported. 
  100.  
  101.           ADD Consulting (CH)
  102.           Mr. Peter Kanis
  103.           Via Suro 9
  104.           CH-7403 Rh╨öz╨æns
  105.           Switzerland
  106.  
  107.           Tel: +41 (0)81 630 2011
  108.           Fax: +41 (0)81 630 2015
  109.           CompuServe: 100275,350 (Peter Kanis)
  110.           INTERNET: kanis@ibm.net
  111.  
  112.           ADD Consulting (RUS)
  113.           Mr. Michael V. Schelkin
  114.           18-29 Molodezhnaya Street
  115.           Jukovsky
  116.           140160 Moscow Region
  117.           Russia
  118.  
  119.           Tel: +7 095 556 8533
  120.           Internet: michael@schelkin.msk.ru
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 1.5. Rights And Limitations ΓòÉΓòÉΓòÉ
  124.  
  125. ADD Consulting makes no warranties as to the information in this guide. 
  126. Additionally, ADD Consulting is not responsible or liable for any loss or 
  127. damage of any kind resulting from use of this product. 
  128.  
  129. The Software is protected by international copyright laws. All rights reserved. 
  130. No part of the computer program, documentation or related files may be 
  131. reproduced photocopied, stored on a retrieval system, or transmitted except as 
  132. provided by copyright law or by express permission of the copyright owner. 
  133.  
  134. DISCLAIMER - AGREEMENT 
  135.  
  136. Users of the VRExtras Object Pack shall accept this disclaimer of warranty: 
  137.  
  138. ADD CONSULTING SUPPLIES THIS PRODUCT AS IS WITHOUT WARANTY OF ANY KIND, EITHER 
  139. EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARANTIES OF 
  140. MERCANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ADD CONSULTING ASSUMES NO 
  141. LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE 
  142. OF THE PRODUCT. 
  143.  
  144. Some jurisdictions do not allow the exclusion or limitations for consequential 
  145. or incidental damages, so the above may not apply to you. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 2. VRTransparentText object ΓòÉΓòÉΓòÉ
  149.  
  150. The Transparent Text Object is designed to help design panels for VX-REXX where 
  151. text is required overwriting an image. 
  152.  
  153. The text within a Transparent Text Object can be justified both horizontally 
  154. and vertically and wrapped within the area of the object. 
  155.  
  156. When you start a program that uses Transparent Text Objects there will be a 
  157. short delay before they are shown on the window. This is so that the objects 
  158. can obtain an image of the underlying window. 
  159.  
  160. Note: 
  161. The background of the Transparent Text Object is NOT transparent in the design 
  162. environment: it will take on the background of the top window. This is due to 
  163. the behaviour of the VX-REXX design environment. 
  164.  
  165. Warning: 
  166. The Transparent Text Object makes a copy of the image in the window over which 
  167. it lies, if you use many Transparent Text Objects the memory signature of your 
  168. program may increase noticeably. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 3. VRTransparentText properties ΓòÉΓòÉΓòÉ
  172.  
  173. The Transparent Text Object has following specific properties: 
  174.  
  175.      o Justification 
  176.      o SizeToText 
  177.      o VertJustification 
  178.      o WrapText 
  179.  
  180.      The Transparent Text Object also has the following standard properties: 
  181.  
  182.      o Caption 
  183.      o ClassName 
  184.      o ClipSiblings 
  185.      o Enabled 
  186.      o FirstChild 
  187.      o Font 
  188.      o ForeColor 
  189.      o Height 
  190.      o HelpTag 
  191.      o HelpText 
  192.      o HintText 
  193.      o HWnd 
  194.      o Left 
  195.      o Name 
  196.      o Painting 
  197.      o Parent 
  198.      o Query 
  199.      o QueryColumns 
  200.      o Self 
  201.      o Sibling 
  202.      o SiblingOrder 
  203.      o Top 
  204.      o UserData 
  205.      o Visible 
  206.      o Width 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ 3.1. Justification ΓòÉΓòÉΓòÉ
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ <hidden> Justification - List ΓòÉΓòÉΓòÉ
  213.  
  214. Data Type 
  215.  
  216.      String 
  217.  
  218.      Possible Values 
  219.  
  220.      Left 
  221.      Centered 
  222.      Right 
  223.  
  224.      See Also 
  225.  
  226.      o SizeToText 
  227.      o VertJustification 
  228.      o WrapText 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ <hidden> Justification - Description ΓòÉΓòÉΓòÉ
  232.  
  233. This property determines the horizontal justification of the text in the 
  234. object. It behaves in the same way as the Justification property of the 
  235. Descriptive Text Object. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 3.2. SizeToText ΓòÉΓòÉΓòÉ
  239.  
  240.  
  241. ΓòÉΓòÉΓòÉ <hidden> SizeToText - List ΓòÉΓòÉΓòÉ
  242.  
  243. Data Type 
  244.  
  245.      Boolean 
  246.  
  247.      Possible Values 
  248.  
  249.      1 (true) 
  250.      0 (false) 
  251.  
  252.      See Also 
  253.  
  254.      o Justification 
  255.      o VertJustification 
  256.      o WrapText 
  257.  
  258.  
  259. ΓòÉΓòÉΓòÉ <hidden> SizeToText - Description ΓòÉΓòÉΓòÉ
  260.  
  261. This property will have different effects on the appearance and behaviour of 
  262. the Transparent Text Object depending on the setting of the WrapText property. 
  263.  
  264. If WrapText is on, then the size of the object will be adjusted to the nearest 
  265. fit to its current size. 
  266.  
  267. If WrapText is off then the object will be sized in the same way as a 
  268. Descriptive Text Object. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 3.3. VertJustification ΓòÉΓòÉΓòÉ
  272.  
  273.  
  274. ΓòÉΓòÉΓòÉ <hidden> VertJustification - List ΓòÉΓòÉΓòÉ
  275.  
  276. Data Type 
  277.  
  278.      String 
  279.  
  280.      Possible Values 
  281.  
  282.      Top 
  283.      Centered 
  284.      Bottom 
  285.  
  286.      See Also 
  287.  
  288.      o Justification 
  289.      o SizeToText 
  290.      o WrapText 
  291.  
  292.  
  293. ΓòÉΓòÉΓòÉ <hidden> VertJustification - Description ΓòÉΓòÉΓòÉ
  294.  
  295. This property determines how the text is justified vertically within the 
  296. object. 
  297.  
  298. Note: 
  299. This property is only valid when WrapText is off. If WrapText is on, this 
  300. propety is always set to "Top". 
  301.  
  302.  
  303. ΓòÉΓòÉΓòÉ 3.4. WrapText ΓòÉΓòÉΓòÉ
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ <hidden> WrapText - List ΓòÉΓòÉΓòÉ
  307.  
  308. Data Type 
  309.  
  310.      Boolean 
  311.  
  312.      Possible Values 
  313.  
  314.      1 (true) 
  315.      0 (false) 
  316.  
  317.      See Also 
  318.  
  319.      o Justification 
  320.      o SizeToText 
  321.      o VertJustification 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ <hidden> WrapText - Description ΓòÉΓòÉΓòÉ
  325.  
  326. This property will cause the text in a Transparent Text Object to be wrapped 
  327. over several lines if it is too long to fit in the width of the object. If 
  328. SizeToText property is set, the object will resize to show the complete text. 
  329.  
  330. Note: 
  331. If the object is not wide enough for a word in the text, this word will be cut. 
  332.  
  333.  
  334. ΓòÉΓòÉΓòÉ 4. VRTransparentText methods ΓòÉΓòÉΓòÉ
  335.  
  336. The Transparent Text Object has the following specific methods: 
  337.  
  338.      o Refresh 
  339.      o TextLength 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 4.1. Refresh ΓòÉΓòÉΓòÉ
  343.  
  344.  
  345. ΓòÉΓòÉΓòÉ <hidden> Refresh method ΓòÉΓòÉΓòÉ
  346.  
  347. ok = VRMethod( object, "Refresh");
  348.  
  349. Returns 
  350.  
  351.  1 (true) if successful 
  352.  0 (false) otherwise 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ <hidden> Refresh - Description ΓòÉΓòÉΓòÉ
  356.  
  357. This method will hide the text in order to refresh the background and then 
  358. re-draw the text. You should call this method whenever the background of the 
  359. text changes. It is a good idea to include this method in the parent window 
  360. Resize event. 
  361.  
  362.  
  363. ΓòÉΓòÉΓòÉ 4.2. TextLength ΓòÉΓòÉΓòÉ
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ <hidden> TextLength method ΓòÉΓòÉΓòÉ
  367.  
  368. Len = VRMethod( object, "TextLength");
  369.  
  370. Returns 
  371.  
  372. The length of the caption text 
  373.  
  374. See Also 
  375.  
  376.  o Justification 
  377.  o SizeToText 
  378.  o WrapText 
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ <hidden> TextLength - Description ΓòÉΓòÉΓòÉ
  382.  
  383. This method will return the length of the caption text in TWIPS. You can then 
  384. use this to determine whether the text will fit in the space you have and the 
  385. modify the SizeToText and/or WrapText properties accordingly. 
  386.  
  387.  
  388. ΓòÉΓòÉΓòÉ 5. VRLine object ΓòÉΓòÉΓòÉ
  389.  
  390. The Line Object is a simple object allows you to draw horizontal or vertical 
  391. lines in a VX-REXX window. 
  392.  
  393. The Line Object has no methods other than the standard methods available to any 
  394. VX-REXX object: 
  395.  
  396.  o DefineEvent 
  397.  o InvokeHelp 
  398.  o ListMethods 
  399.  o ListProperties 
  400.  o PostEvent 
  401.  o StartDrag 
  402.  
  403.  
  404. ΓòÉΓòÉΓòÉ 6. VRLine properties ΓòÉΓòÉΓòÉ
  405.  
  406. The Line Object has the following specific properties: 
  407.  
  408.  o Direction 
  409.  o LineColor 
  410.  o Thickness 
  411.  
  412.  The Line Object also has the following standard properties: 
  413.  
  414.  o ClassName 
  415.  o ClipSiblings 
  416.  o Enabled 
  417.  o FirstChild 
  418.  o Height 
  419.  o HelpTag 
  420.  o HelpText 
  421.  o HintText 
  422.  o HWnd 
  423.  o Left 
  424.  o Name 
  425.  o Painting 
  426.  o Parent 
  427.  o Self 
  428.  o Sibling 
  429.  o SiblingOrder 
  430.  o Top 
  431.  o UserData 
  432.  o Visible 
  433.  o Width 
  434.  
  435.  
  436. ΓòÉΓòÉΓòÉ 6.1. Direction ΓòÉΓòÉΓòÉ
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ <hidden> Direction - list ΓòÉΓòÉΓòÉ
  440.  
  441. Data Type 
  442.  
  443.  String 
  444.  
  445.  Possible Values 
  446.  
  447.  Horizontal 
  448.  Vertical 
  449.  
  450.  See Also 
  451.  
  452.  o Thickness 
  453.  
  454.  
  455. ΓòÉΓòÉΓòÉ <hidden> Direction - Description ΓòÉΓòÉΓòÉ
  456.  
  457. Defines the direction of the line. When you change the Direction property, the 
  458. line will pivot around its top/left anchor point. 
  459.  
  460. Note: 
  461. You can also use the first character of the word V or H to set the direction. 
  462.  
  463.  
  464. ΓòÉΓòÉΓòÉ 6.2. LineColor ΓòÉΓòÉΓòÉ
  465.  
  466.  
  467. ΓòÉΓòÉΓòÉ <hidden> LineColor - list ΓòÉΓòÉΓòÉ
  468.  
  469. Data Type 
  470.  
  471.  String 
  472.  
  473.  Possible Values 
  474.  
  475.  White 
  476.  Black 
  477.  Blue 
  478.  Red 
  479.  Pink 
  480.  Green 
  481.  Cyan 
  482.  Yellow 
  483.  DarkGray 
  484.  DarkBlue 
  485.  DarkRed 
  486.  DarkPink 
  487.  DarkGreen 
  488.  DarkCyan 
  489.  Brown 
  490.  PaleGrey 
  491.  <default> 
  492.  
  493.  
  494. ΓòÉΓòÉΓòÉ <hidden> LineColor - Description ΓòÉΓòÉΓòÉ
  495.  
  496. Sets the color of the line to any of the standard VX-REXX colours. 
  497.  
  498. Note: 
  499. Using the "<default>" colour will make the line invisible. 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 6.3. Thickness ΓòÉΓòÉΓòÉ
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ <hidden> Thickness - list ΓòÉΓòÉΓòÉ
  506.  
  507. Data Type 
  508.  
  509.  Numeric 
  510.  
  511.  Possible Values 
  512.  
  513.  Any +ve integer 
  514.  1mm = 56 TWIPS. 
  515.  
  516.  See Also 
  517.  
  518.  o Direction 
  519.  
  520.  
  521. ΓòÉΓòÉΓòÉ <hidden> Thickness - Description ΓòÉΓòÉΓòÉ
  522.  
  523. Defines the thickness of the line in TWIPS. This property will override the 
  524. Width property if the Direction is Vertical or the Height property if the 
  525. Direction is Horizontal. 
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 7. VRFormattedEntryField object ΓòÉΓòÉΓòÉ
  529.  
  530. The Formatted Entry Field Object allows you to control the way data is entered 
  531. into a VX-REXX Entry Field. The Formatted Entry Field Object achieves this my 
  532. modifying the standard entry field properties and filtering the keyboard input. 
  533.  
  534. Three predefined formatted fields are supplied (see FieldType): 
  535.  
  536.  o Date entry field 
  537.  o Time entry field 
  538.  o Currency entry field 
  539.  
  540.  Other than these you can define your own entry FieldMask using the available 
  541.  Mask Characters 
  542.  
  543.  
  544. ΓòÉΓòÉΓòÉ 7.1. Mask Characters ΓòÉΓòÉΓòÉ
  545.  
  546. To help you define the allowable characters in a Formatted Entry Field, the 
  547. following characters are defined and reserved for creating input masks. 
  548.  
  549.  #         Only numeric characters ( 0..9) and punctuation characters are 
  550.            allowed at this position. 
  551.  @         Any character can be entered at this position. 
  552.  |         Only non-numeric characters can be entered at this position. 
  553.  
  554.  
  555. ΓòÉΓòÉΓòÉ 8. VRFormattedEntryField properties ΓòÉΓòÉΓòÉ
  556.  
  557. The Formatted Entry Field Object inherits all the properties of the standard 
  558. Entry Field Object and adds the following properties: 
  559.  
  560.  o AllowSpaces 
  561.  o FieldType 
  562.  o ForceUpperCase 
  563.  o FieldMask 
  564.  o SpaceToZero 
  565.  
  566.  
  567. ΓòÉΓòÉΓòÉ 8.1. AllowSpaces ΓòÉΓòÉΓòÉ
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ <hidden> AllowSpaces - list ΓòÉΓòÉΓòÉ
  571.  
  572. Data Type 
  573.  
  574.  Boolean 
  575.  
  576.  Possible Values 
  577.  
  578.  1 (true) 
  579.  0 (false) 
  580.  
  581.  See Also 
  582.  
  583.  o FieldMask 
  584.  o SpaceToZero 
  585.  
  586.  
  587. ΓòÉΓòÉΓòÉ <hidden> AllowSpaces - Description ΓòÉΓòÉΓòÉ
  588.  
  589. This property specifies whether the <Space> character is allowed in the input 
  590. string. When set to 0, an error beep will be emmited if you type the <Space> 
  591. character. 
  592.  
  593.  
  594. ΓòÉΓòÉΓòÉ 8.2. FieldType ΓòÉΓòÉΓòÉ
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ <hidden> FieldType - list ΓòÉΓòÉΓòÉ
  598.  
  599. Data Type 
  600.  
  601.  String 
  602.  
  603.  Possible Values 
  604.  
  605.  Date 
  606.  Time 
  607.  Currency 
  608.  User Defined 
  609.  
  610.  See Also 
  611.  
  612.  o AllowSpaces 
  613.  o ForceUpperCase 
  614.  o FieldMask 
  615.  o SpaceToZero 
  616.  
  617.  
  618. ΓòÉΓòÉΓòÉ <hidden> FieldType - Description ΓòÉΓòÉΓòÉ
  619.  
  620. This property determines what type of entry field is created : 
  621.  
  622.  o Date the field will be formatted according to the current system date 
  623.    format. 
  624.  o Time the field will be formatted according to the current system time 
  625.    format. 
  626.  o Currency the field will be formatted according to the current system 
  627.    currency format. 
  628.  o User Defined the user defines the input FieldMask 
  629.  
  630.  
  631. ΓòÉΓòÉΓòÉ 8.3. ForceUpperCase ΓòÉΓòÉΓòÉ
  632.  
  633.  
  634. ΓòÉΓòÉΓòÉ <hidden> ForceUpper - List ΓòÉΓòÉΓòÉ
  635.  
  636. Data Type 
  637.  
  638.  Boolean 
  639.  
  640.  Possible Values 
  641.  
  642.  1 (true) 
  643.  0 (false) 
  644.  
  645.  See Also 
  646.  
  647.  o AllowSpaces 
  648.  o FieldMask 
  649.  o SpaceToZero 
  650.  
  651.  
  652. ΓòÉΓòÉΓòÉ <hidden> ForceUpperCase - Description ΓòÉΓòÉΓòÉ
  653.  
  654. This property determines the allowed case of the characters entered into the 
  655. field. If it is set, all characters typed into the field will be forced to 
  656. upper case. 
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ 8.4. FieldMask ΓòÉΓòÉΓòÉ
  660.  
  661.  
  662. ΓòÉΓòÉΓòÉ <hidden> Mask - List ΓòÉΓòÉΓòÉ
  663.  
  664. Data Type 
  665.  
  666.  String 
  667.  
  668.  Possible Values 
  669.  
  670.  see Mask Characters 
  671.  
  672.  See Also 
  673.  
  674.  o AllowSpaces 
  675.  o ForceUpperCase 
  676.  o SpaceToZero 
  677.  o Mask Characters 
  678.  
  679.  
  680. ΓòÉΓòÉΓòÉ <hidden> Mask - Description ΓòÉΓòÉΓòÉ
  681.  
  682. A string representation containing Mask Characters and literal characters. 
  683. Input to the field is only allowed over the Mask Characters, all literals will 
  684. remain untouched by editing. 
  685.  
  686.  
  687. ΓòÉΓòÉΓòÉ 8.5. SpaceToZero ΓòÉΓòÉΓòÉ
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ <hidden> SpaceToZero - list ΓòÉΓòÉΓòÉ
  691.  
  692. Data Type 
  693.  
  694.  Boolean 
  695.  
  696.  Possible Values 
  697.  
  698.  1 (true) 
  699.  0 (false) 
  700.  
  701.  See Also 
  702.  
  703.  o AllowSpaces 
  704.  o FieldMask 
  705.  o ForceUpperCase 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ <hidden> SpaceToZero - Description ΓòÉΓòÉΓòÉ
  709.  
  710. This property is for for numeric input fields. If set to 1 all spaces left in 
  711. the field will be converted to the number 0 when the focus is lost. 
  712.  
  713.  
  714. ΓòÉΓòÉΓòÉ 9. VRFormattedEntryField methods ΓòÉΓòÉΓòÉ
  715.  
  716. The Formatted Entry Field Object apart from the following specific methods, all 
  717. the standard Entry Field methods apply. 
  718.  
  719.  o ValidateField 
  720.  
  721.  
  722. ΓòÉΓòÉΓòÉ 9.1. ValidateField ΓòÉΓòÉΓòÉ
  723.  
  724.  
  725. ΓòÉΓòÉΓòÉ <hidden> ValidateField - method ΓòÉΓòÉΓòÉ
  726.  
  727. ok = VRMethod( object, "ValidateField");
  728.  
  729. Returns 
  730.  
  731.  1 (true) Field is valid 
  732.  0 (false) Field is invalid 
  733.  
  734.  See Also 
  735.  
  736.  o FieldType 
  737.  o Mask Characters 
  738.  
  739.  
  740. ΓòÉΓòÉΓòÉ <hidden> ValidateField - Description ΓòÉΓòÉΓòÉ
  741.  
  742. This method takes no parameters and only applies to Date or Time fields. It 
  743. will check whether the contents of the field are valid: 
  744.  
  745.  Months part <= 12 
  746.  Days part in range for the month 
  747.  Hours part <= 23 
  748.  Minutes part <= 59 
  749.  
  750.  User defined and Currency fields are not validated, the method always 
  751.  returning TRUE. 
  752.  
  753.  
  754. ΓòÉΓòÉΓòÉ 10. VRScroll object ΓòÉΓòÉΓòÉ
  755.  
  756. The Scroll Object allows you to add scrollbars to a frame window or to use them 
  757. as stand alone objects. 
  758.  
  759.  
  760. ΓòÉΓòÉΓòÉ 11. VRScroll Properties ΓòÉΓòÉΓòÉ
  761.  
  762. The Scroll Object has the following properties: 
  763.  
  764.  o FrameControl 
  765.  o LineIncrement 
  766.  o MaximumValue 
  767.  o MinimumValue 
  768.  o Orientation 
  769.  o PageIncrement 
  770.  o StandardSize 
  771.  o ThumbSize 
  772.  
  773.  The current position of the slider in the scrollbar is available through the 
  774.  Value property and can also be set using the Value property. 
  775.  
  776.  
  777. ΓòÉΓòÉΓòÉ 11.1. FrameControl ΓòÉΓòÉΓòÉ
  778.  
  779.  
  780. ΓòÉΓòÉΓòÉ <hidden> FrameControl - List ΓòÉΓòÉΓòÉ
  781.  
  782. Data Type 
  783.  
  784.  Boolean 
  785.  
  786.  Possible Values 
  787.  
  788.  1 (true) 
  789.  0 (false) 
  790.  
  791.  See Also 
  792.  
  793.  o Orientation 
  794.  o AttachToWindow 
  795.  
  796.  
  797. ΓòÉΓòÉΓòÉ <hidden> FrameControl - Description ΓòÉΓòÉΓòÉ
  798.  
  799. When set to 1, this property will cause the scrollbar to become a frame control 
  800. of its parent window in the runtime environment. The Scroll Object remains free 
  801. floating in the design environment. 
  802.  
  803.  
  804. ΓòÉΓòÉΓòÉ 11.2. LineIncrement ΓòÉΓòÉΓòÉ
  805.  
  806.  
  807. ΓòÉΓòÉΓòÉ <hidden> LineIncrement - List ΓòÉΓòÉΓòÉ
  808.  
  809. Data Type 
  810.  
  811.  Numeric 
  812.  
  813.  Possible Values 
  814.  
  815.  0 - 32737 
  816.  
  817.  See Also 
  818.  
  819.  o MaximumValue 
  820.  o MinimumValue 
  821.  o PageIncrement 
  822.  o ThumbSize 
  823.  
  824.  
  825. ΓòÉΓòÉΓòÉ <hidden> LineIncrement - Description ΓòÉΓòÉΓòÉ
  826.  
  827. This value defines the incrementation/decrementation of the Value of the Scroll 
  828. Object when either the arrows are clicked or a cursor key is pressed. 
  829.  
  830. This value should not be greater than the value in the MaximumValue property 
  831. and should normaly be less than that of the PageIncrement property. 
  832.  
  833.  
  834. ΓòÉΓòÉΓòÉ 11.3. MaximumValue ΓòÉΓòÉΓòÉ
  835.  
  836.  
  837. ΓòÉΓòÉΓòÉ <hidden> MaximumValue - List ΓòÉΓòÉΓòÉ
  838.  
  839. Data Type 
  840.  
  841.  Numeric 
  842.  
  843.  Possible Values 
  844.  
  845.  0 - 32737 
  846.  
  847.  See Also 
  848.  
  849.  o LineIncrement 
  850.  o MinimumValue 
  851.  o PageIncrement 
  852.  o ThumbSize 
  853.  
  854.  
  855. ΓòÉΓòÉΓòÉ <hidden> MaximumValue - Description ΓòÉΓòÉΓòÉ
  856.  
  857. this property defines the maximum Value of the Scroll Object when the slider is 
  858. at the bottom or right of the scrollbar. 
  859.  
  860.  
  861. ΓòÉΓòÉΓòÉ 11.4. MinimumValue ΓòÉΓòÉΓòÉ
  862.  
  863.  
  864. ΓòÉΓòÉΓòÉ <hidden> MinimumValue - List ΓòÉΓòÉΓòÉ
  865.  
  866. Data Type 
  867.  
  868.  Numeric 
  869.  
  870.  Possible Values 
  871.  
  872.  0 - 32737 
  873.  
  874.  See Also 
  875.  
  876.  o LineIncrement 
  877.  o MaximumValue 
  878.  o PageIncrement 
  879.  o ThumbSize 
  880.  
  881.  
  882. ΓòÉΓòÉΓòÉ <hidden> MinimumValue - Description ΓòÉΓòÉΓòÉ
  883.  
  884. this property defines the minimum Value of the Scroll Object when the slider is 
  885. at the top or left of the scrollbar. 
  886.  
  887.  
  888. ΓòÉΓòÉΓòÉ 11.5. Orientation ΓòÉΓòÉΓòÉ
  889.  
  890.  
  891. ΓòÉΓòÉΓòÉ <hidden> Orientation - List ΓòÉΓòÉΓòÉ
  892.  
  893. Data Type 
  894.  
  895.  String 
  896.  
  897.  Possible Values 
  898.  
  899.  Vertical (default) 
  900.  Horizontal 
  901.  
  902.  See Also 
  903.  
  904.  o FrameControl 
  905.  
  906.  
  907. ΓòÉΓòÉΓòÉ <hidden> Orientation - Description ΓòÉΓòÉΓòÉ
  908.  
  909. This property defines the orientation of the Scroll Object. You can also set 
  910. this property using the first character of the word (V or H). 
  911.  
  912.  
  913. ΓòÉΓòÉΓòÉ 11.6. PageIncrement ΓòÉΓòÉΓòÉ
  914.  
  915.  
  916. ΓòÉΓòÉΓòÉ <hidden> PageIncrement ΓòÉΓòÉΓòÉ
  917.  
  918. Data Type 
  919.  
  920.  Numeric 
  921.  
  922.  Possible Values 
  923.  
  924.  0 - 32737 
  925.  
  926.  See Also 
  927.  
  928.  o LineIncrement 
  929.  o MaximumValue 
  930.  o MinimumValue 
  931.  o ThumbSize 
  932.  
  933.  
  934. ΓòÉΓòÉΓòÉ <hidden> PageIncrement - Description ΓòÉΓòÉΓòÉ
  935.  
  936. This value defines the incrementation/decrementation of the Value of the Scroll 
  937. Object when either the bar is clicked or a pageup/pagedown key is pressed. 
  938.  
  939. This value should not be greater than the value in the MaximumValue property 
  940. and should normaly be greater than that of the LineIncrement property. 
  941.  
  942.  
  943. ΓòÉΓòÉΓòÉ 11.7. StandardSize ΓòÉΓòÉΓòÉ
  944.  
  945.  
  946. ΓòÉΓòÉΓòÉ <hidden> StandardSize - List ΓòÉΓòÉΓòÉ
  947.  
  948. Data Type 
  949.  
  950.  Boolean 
  951.  
  952.  Possible Values 
  953.  
  954.  1 (true) 
  955.  0 (false) 
  956.  
  957.  See Also 
  958.  
  959.  o Orientation 
  960.  o FrameControl 
  961.  
  962.  
  963. ΓòÉΓòÉΓòÉ <hidden> StandardSize - Description ΓòÉΓòÉΓòÉ
  964.  
  965. This property is set by default making a Scroll Object that is dropped on a 
  966. window a sensible size. The property is ignored in the runtime environment if 
  967. the Scroll Object is a FrameControl. 
  968.  
  969.  
  970. ΓòÉΓòÉΓòÉ 11.8. ThumbSize ΓòÉΓòÉΓòÉ
  971.  
  972.  
  973. ΓòÉΓòÉΓòÉ <hidden> ThumbSize - List ΓòÉΓòÉΓòÉ
  974.  
  975. Data Type 
  976.  
  977.  Numeric 
  978.  
  979.  Possible Values 
  980.  
  981.  0 - 100 
  982.  
  983.  See Also 
  984.  
  985.  o LineIncrement 
  986.  o MaximumValue 
  987.  o MinimumValue 
  988.  o PageIncrement 
  989.  
  990.  
  991. ΓòÉΓòÉΓòÉ <hidden> ThumbSize - Description ΓòÉΓòÉΓòÉ
  992.  
  993. This defines the proportion of the ScrollBar Objects's height or width that is 
  994. occupied by the slider as a percentage. 
  995.  
  996.  
  997. ΓòÉΓòÉΓòÉ 12. VRScroll Events ΓòÉΓòÉΓòÉ
  998.  
  999. The Scroll Object generates the following events when manipulated in the 
  1000. runtime environment: 
  1001.  
  1002.  o Change 
  1003.  o Track 
  1004.  
  1005.  
  1006. ΓòÉΓòÉΓòÉ 12.1. Change ΓòÉΓòÉΓòÉ
  1007.  
  1008. The change event is posted whenever the positon of the thumb bar is changed, 
  1009. either by clicking the arrows, the bar itself or pressing a cursor key when the 
  1010. Scroll Object has the focus. The Value property of the Scroll Object is updated 
  1011. at the same time. 
  1012.  
  1013.  
  1014. ΓòÉΓòÉΓòÉ 12.2. Track ΓòÉΓòÉΓòÉ
  1015.  
  1016. The track event is posted whenever the Scroll Object's slider is dragged. The 
  1017. Value property of the Scroll Object is updated at the same time. 
  1018.  
  1019.  
  1020. ΓòÉΓòÉΓòÉ 13. VRScroll Methods ΓòÉΓòÉΓòÉ
  1021.  
  1022. The Scroll Object exports the following method: 
  1023.  
  1024.  o AttachToWindow 
  1025.  
  1026.  
  1027. ΓòÉΓòÉΓòÉ 13.1. AttachToWindow ΓòÉΓòÉΓòÉ
  1028.  
  1029.  
  1030. ΓòÉΓòÉΓòÉ <hidden> AttachToWindow method ΓòÉΓòÉΓòÉ
  1031.  
  1032. ok = VRMethod( object, "AttachToWindow");
  1033.  
  1034. Returns 
  1035.  
  1036.  1 (true) if successful 
  1037.  0 (false) if fails 
  1038.  
  1039.  See Also 
  1040.  
  1041.  o FrameControl 
  1042.  o Orientation 
  1043.  
  1044.  
  1045. ΓòÉΓòÉΓòÉ <hidden> AttachToWindow - Description ΓòÉΓòÉΓòÉ
  1046.  
  1047. This method will attach the Scroll Object to the frame of its parent window as 
  1048. a frame control. Once a Scroll Object has been converted to a frame control, it 
  1049. cannot be moved or detached. 
  1050.  
  1051. Note: 
  1052. This method is called during the initialisation of a Scroll Object if the 
  1053. FrameControl property is set. It should, therefore, rarely be necessary to call 
  1054. this method.