home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / vrpinf21.zip / vrprint.INF (.txt) < prev   
OS/2 Help File  |  1995-12-31  |  165KB  |  3,285 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. VRPrinter Object ΓòÉΓòÉΓòÉ
  3.  
  4. The VRPrinter Object for VX-REXX* gives you access to complex graphic printing 
  5. functionality with VX-REXX v2.1 or greater. 
  6.  
  7. With this library you will be able to create professional style reports and 
  8. outputs for your VX-REXX programs with images, boxes and text that can be 
  9. justified, right or left aligned or centred. and with documents that use up to 
  10. 25 different font faces. 
  11.  
  12. The VRPrinter Object allows you to define headers and footers and gives you 
  13. access to a list of the printers connected to your work-station, their Job 
  14. Properties dialogs and their available printing fonts. 
  15.  
  16. * VX-REXX is a registered trade mark of Watcom International Corporation. 
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 1.1. Whats new in version 2.1 ΓòÉΓòÉΓòÉ
  20.  
  21. The VRPrinter Object has been ported to VX-REXX version 2.1. This means that if 
  22. you still have VX-REXX version 2.0, you should stay with version 1.x of the 
  23. VRPrinter Object. 
  24.  
  25. In version 2.1 we have introduced the following new methods: 
  26.  
  27.          MoveX 
  28.          MoveY 
  29.          PrintWinImage 
  30.  
  31.  NewPage will now prepare the job to start a new page from within a table when 
  32.  the next EndRow call is made. 
  33.  
  34.  
  35. ΓòÉΓòÉΓòÉ 1.2. Shareware Software ΓòÉΓòÉΓòÉ
  36.  
  37. DEFINITION OF SHAREWARE SOFTWARE 
  38.  
  39. Shareware Software distribution gives users a chance to try software before 
  40. buying it. If you try a Shareware software program and continue using it, you 
  41. are expected to register. Individual programs differ on details -- some request 
  42. registration while others require it, some specify a maximum trial period. 
  43. With registration, you  get anything from the simple right to continue using 
  44. the software to an updated program with printed manual. 
  45.  
  46. Copyright laws apply to both Shareware and commercial software, and the 
  47. copyright holder retains all rights, with a few specific exceptions as stated 
  48. below. Shareware software authors are accomplished programmers, just like 
  49. commercial authors, and the programs are of comparable quality. (In both cases, 
  50. there are good programs and bad ones!)  The main difference is in the method of 
  51. distribution. The author specifically grants the right to copy and distribute 
  52. the software, either to all and sundry or to a specific group. For example, 
  53. some authors require written permission before a commercial disk vendor may 
  54. copy their Shareware software. 
  55.  
  56. Shareware software is a distribution method, not a type of software. You should 
  57. find software that suits your needs and pocketbook, whether it's commercial or 
  58. Shareware software. The Shareware software system makes fitting your needs 
  59. easier, because you can try before you buy. And because the overhead is low, 
  60. prices are low also. Shareware software has the ultimate money-back guarantee 
  61. -- if you don't use the product, you don't pay for it. 
  62.  
  63. When you register the VRPrinter Object you will be sent a registered version of 
  64. the DLL by e-mail. This version has the "nag" popup removed and you have the 
  65. right to freely distribute software that includes the DLL. 
  66.  
  67. If you are satisfied with the VRPrinter Object we ask you to freely distribute 
  68. the shareware version to your freinds and colleagues. 
  69.  
  70. If you have any suggestions for enhancements or find any bugs in the software 
  71. please contact us at one of our Contact Addresses 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 1.3. Registering your license ΓòÉΓòÉΓòÉ
  75.  
  76. VRPrinter is a "Shareware software program" and is provided at no charge to the 
  77. user for evaluation. Feel free to share it with your friends, but please do not 
  78. give it away altered or as part of another system. The essence of 
  79. "user-supported" software is to provide personal computer users with quality 
  80. software without high prices, and yet to provide incentive for programmers to 
  81. continue to develop new products. If you find this program useful and find that 
  82. you are using VRPrinter and continue to use VRPrinter after a reasonable trial 
  83. period of 30  days, you must make a registration payment of $45.00 to ADD 
  84. Consulting (CH). 
  85.  
  86. If you have already registered either PRTGRAPH for REXX or PRTGRAFC for C/C++ 
  87. you can register for $20.00. 
  88.  
  89. You can register through the CompuServe Shareware Registration facility: 
  90.  
  91.      GO SWREG registration Number 6200 for new registrations 
  92.  
  93.      GO SWREG registration Number 6330 for registered owners of PrtGraph for C 
  94.      or the PrtGraph C++ Class Library 
  95.  
  96.  The registration fee will license one copy for use on any one computer at any 
  97.  one time. You must treat this software just like a book. An example is that 
  98.  this software may be used by any number of people and may be freely moved from 
  99.  one computer location to another, so long as there is no possibility of it 
  100.  being used at one location while it's being used at another. Just as a book 
  101.  cannot be read by two different persons at the same time. 
  102.  
  103.  Payment of the registration fee gives you the right to distribute programs 
  104.  that include the object and the DLL without paying any other "run-time" 
  105.  licenses. 
  106.  
  107.  Site-License arrangements may be made by contacting ADD Consulting (CH). 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 1.4. Distributing the VRPrinter Object ΓòÉΓòÉΓòÉ
  111.  
  112. Anyone distributing the VRPrinter Object for any kind of remuneration must 
  113. first contact ADD Consulting (CH) at our address below for authorization. This 
  114. authorization will be automatically granted to distributors recognized by the 
  115. (ASP) as adhering to its guidelines for shareware distributors, and such 
  116. distributors may begin offering VRPrinter immediately, however ADD Consulting 
  117. (CH) should still be advised so that the distributor can be kept up-to-date 
  118. with the latest version of VRPrinter. 
  119.  
  120. Registered users are free to distribute programs that use the the VRPrinter 
  121. Object with no additional run-time fees. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 1.5. Contact Address ΓòÉΓòÉΓòÉ
  125.  
  126. You can contact ADD Consulting at the addresses below: 
  127.  
  128.           ADD Consulting (CH)
  129.           Mr. Peter Kanis
  130.           Via Suro 9
  131.           CH-7403 Rh╨öz╨æns
  132.           Switzerland
  133.  
  134.           Tel: +41 (0)81 630 2011
  135.           Fax: +41 (0)81 630 2015
  136.           CompuServe: 100275,350 (Peter Kanis)
  137.           INTERNET: kanis@ibm.net
  138.  
  139.           ADD Consulting (RUS)
  140.           Mr. Michael V. Schelkin
  141.           18-29 Molodezhnaya Street
  142.           Jukovsky
  143.           140160 Moscow Region
  144.           Russia
  145.  
  146.           Tel: +7 095 556 8533
  147.           Internet: michael@schelkin.msk.ru
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ 1.6. Rights And Limitations ΓòÉΓòÉΓòÉ
  151.  
  152. ADD Consulting makes no warranties as to the information in this guide. 
  153. Additionally, ADD Consulting is not responsible or liable for any loss or 
  154. damage of any kind resulting from use of this product. 
  155.  
  156. The Software is protected by international copyright laws. All rights reserved. 
  157. No part of the computer program, documentation or related files may be 
  158. reproduced photocopied, stored on a retrieval system, or transmitted except as 
  159. provided by copyright law or by express permission of the copyright owner. 
  160.  
  161. DISCLAIMER - AGREEMENT 
  162.  
  163. Users of VRPrinter shall accept this disclaimer of warranty: 
  164.  
  165. ADD CONSULTING SUPPLIES THIS PRODUCT AS IS WITHOUT WARANTY OF ANY KIND, EITHER 
  166. EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARANTIES OF 
  167. MERCANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ADD CONSULTING ASSUMES NO 
  168. LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE 
  169. OF THE PRODUCT. 
  170.  
  171. Some jurisdictions do not allow the exclusion or limitations for consequential 
  172. or incidental damages, so the above may not apply to you. 
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 1.7. The DEMO program ΓòÉΓòÉΓòÉ
  176.  
  177. Included in this package is a demonstration program in VX-REXX and its source 
  178. code.  The demo shows you many of the possibilities offered by the object, but 
  179. the limits are set by your imagination. 
  180.  
  181. Figure: Demo Program. 
  182.  
  183.  
  184. ΓòÉΓòÉΓòÉ 1.8. Setting up a print job ΓòÉΓòÉΓòÉ
  185.  
  186. Setting up a print job requires several steps: 
  187.  
  188.          Include a Printer object on the main window 
  189.          Choose a printer with the PrinterDialog method 
  190.          If necessary set the job properties with the JobProperties method 
  191.          Set the page margins with the SetMargins method 
  192.          Set up the aspect of header with the SetHeaderMode method 
  193.          Set up any header text with the SetHeader method 
  194.          Change any fonts for the lines in the header with the 
  195.           SetHeaderLineFont method 
  196.          Set up any footer with the SetFooter method 
  197.          Open the print job with the OpenPrintJob method 
  198.          Print your texts, tables, bitmaps etc.. 
  199.          Close the print job with the ClosePrintJob method 
  200.  
  201.  Since headers and footers often contain constants like the date or the 
  202.  document title and variables like the page number, the texts defined for these 
  203.  can contain special formatting characters. 
  204.  
  205.  NOTE 
  206.  
  207.  All the input parameters that denote positions are by default in millimetres 
  208.  or 1/10 inch depending on the Measures property. You can convert from inches 
  209.  using the formula: 
  210.  
  211.      mm = 254 * inch 
  212.  
  213.  All the line widths are defined in TWIPS: 
  214.  
  215.      1 Point = 20 TWIPS 
  216.      1 mm = 56.7 TWIPS (rounded to 57 for internal calculation) 
  217.  
  218.  Warning: 
  219.  If you wish to print several documents concurrently (i.e. in parrallel threads 
  220.  or windows) you must include a printer object on each window. 
  221.  
  222.  
  223. ΓòÉΓòÉΓòÉ 1.9. Formatting Characters ΓòÉΓòÉΓòÉ
  224.  
  225. To help define header and footer texts with SetFooter and SetHeader the 
  226. following special formatting flags are defined: 
  227.  
  228. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  229. Γöé$       ΓöéIf followed by one of the other characters in this tableΓöé
  230. Γöé        Γöéit indicates a formatting character follows, otherwise  Γöé
  231. Γöé        Γöéit is taken as a literal '$'                            Γöé
  232. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  233. Γöél       ΓöéLeft align the following text                           Γöé
  234. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  235. Γöér       ΓöéRight align the following text                          Γöé
  236. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  237. Γöéc       ΓöéCentre the following text                               Γöé
  238. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  239. Γöé@       ΓöéInsert the current date formatted acording to the systemΓöé
  240. Γöé        Γöésettings. This is read every time a job is started; so  Γöé
  241. Γöé        Γöéyou can change the date format from job to job in the   Γöé
  242. Γöé        Γöésame sesssion.                                          Γöé
  243. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  244. Γöé#       Γöéinsert the current page number (always arabic)          Γöé
  245. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  246. ΓöéΓûî or |  ΓöéInsert the title of the document (see OpenPrintJob)     Γöé
  247. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  248.  
  249. Example 
  250.  
  251. '$Γûî$rpage $#' would give: 
  252.  
  253. Document Title                     page 1 
  254.  
  255. '$r@ page $#' would give (where date is defined as ISO with '/' separator): 
  256.  
  257.                              1995/03/18 page 1 
  258.  
  259. Warning: 
  260. Formatting characters only apply to the page and table header and page footer 
  261. texts. 
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ 1.10. Fill Syles ΓòÉΓòÉΓòÉ
  265.  
  266. Several of the VRPrinter methods refer to a fill style. You can see the effect 
  267. of a style for any printer by running the DEMO program and printing the box 
  268. styles option. The numbers you pass to any of these methods is translated into 
  269. a PATSYM_????? constant, and the output is, to a certain extent, device 
  270. dependent. For an idea of what you will obtain see the pictures below. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 1.11. Printing on a separate thread ΓòÉΓòÉΓòÉ
  274.  
  275. Printing is often a lengthy operation and is a good candidate for 
  276. multi-threading. However, the Printer Object needs to be present on a Window. 
  277. The technique to use if you want to write a code file to perform the actual 
  278. printing operation in your VX-REXX program is this 
  279.  
  280. Start a thread passing the "Self" property of the Printer Object NOT THE NAME: 
  281.  
  282. PB_Print_Click:
  283.     somSelf = VRGet( "PRT_1", "Self");
  284.     threadID = VRMethod( "Application", "StartThread", "printit", somSelf )
  285. return
  286.  
  287. In the main section of printit.vrx: 
  288.  
  289. Main:
  290.     signal on halt
  291.  
  292.     parse arg somSelf
  293.     .
  294.     .
  295. exit
  296.  
  297. When calling VRPrinter methods use somSelf as the object name: 
  298.  
  299. PrintStuff:
  300.  
  301.     /***** Open the print job *******************************************/
  302.  
  303.     ok = VRMethod( somSelf, "OpenPrintJob", 'Test Printing');
  304.  
  305.     /***** Print out with text, pictures or anything ********************/
  306.  
  307.     ok = VRMethod( somSelf, "PrintLine", facename, fnt, text);
  308.     ok = VRMethod( somSelf, "PrintLine", , fnt, '');
  309.     .
  310.     .
  311.     .
  312.  
  313.     /***** Close the job ************************************************/
  314.  
  315.     ok = VRMethod( somSelf, "ClosePrintJob");
  316.  
  317. return
  318.  
  319. Note:  This technique can be used to access methods and properties of many 
  320. other objects in VX-REXX. 
  321.  
  322.  
  323. ΓòÉΓòÉΓòÉ 2. VRPrinter properties ΓòÉΓòÉΓòÉ
  324.  
  325. The following sections describe the properties specific to the VRPrinter 
  326. Object. 
  327.  
  328.          BottomMargin 
  329.          ColorEnabled 
  330.          CurrentDevice 
  331.          CurrentPrinter 
  332.          DefaultPrinter 
  333.          FormHeight 
  334.          FormName 
  335.          FormWidth 
  336.          JobName 
  337.          LeftMargin 
  338.          LineSpace 
  339.          Measures 
  340.          MinBottomMar 
  341.          MinLeftMar 
  342.          MinRightMar 
  343.          MinTopMar 
  344.          PageHeight 
  345.          PageNum 
  346.          PageWidth 
  347.          Printing 
  348.          PrintColor 
  349.          RightMargin 
  350.          ShowProgress 
  351.          TopMargin 
  352.          Version 
  353.          WordBreak 
  354.  
  355.  The VRPrinter Object inherits its properties from the Descriptive Text object 
  356.  in VX-REXX. The behaviour of the following properties is the standard (see 
  357.  VX-REXX programming guide for Descriptive Text): 
  358.  
  359.          Autozize 
  360.          BackColor 
  361.          Caption 
  362.          ClassName 
  363.          ClipSiblings 
  364.          Enabled 
  365.          FirstChild 
  366.          Font 
  367.          ForeColor 
  368.          Height 
  369.          HelpTag 
  370.          HelpText 
  371.          HintText 
  372.          Justification 
  373.          HWnd 
  374.          Left 
  375.          Name 
  376.          Painting 
  377.          Parent 
  378.          Self 
  379.          Sibling 
  380.          SiblingOrder 
  381.          Top 
  382.          UserData 
  383.          VertJustification 
  384.          Visible 
  385.          Width 
  386.          WordBreak 
  387.  
  388.  
  389. ΓòÉΓòÉΓòÉ 2.1. BottomMargin ΓòÉΓòÉΓòÉ
  390.  
  391.  
  392. ΓòÉΓòÉΓòÉ <hidden> BottomMargin - List ΓòÉΓòÉΓòÉ
  393.  
  394. Data Type 
  395.  
  396.       Numeric 
  397.  
  398.  See Also 
  399.  
  400.      LeftMargin 
  401.      RightMargin 
  402.      TopMargin 
  403.      PageHeight 
  404.      PageWidth 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ <hidden> BottomMargin - Description ΓòÉΓòÉΓòÉ
  408.  
  409. The distance of the bottom margin from the lower edge of the page. The measure 
  410. is in mm or 1/10 inch depending on the Measures property. 
  411.  
  412. Warning: This property is read only and cannot be set with a call to VRSet. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 2.2. ColorEnabled ΓòÉΓòÉΓòÉ
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ <hidden> ColorEnabled - List ΓòÉΓòÉΓòÉ
  419.  
  420. Data Type 
  421.  
  422.       Boolean 
  423.  
  424.  Possible Values 
  425.  
  426.       1 (TRUE) 
  427.       0 (FALSE) 
  428.  
  429.  See Also 
  430.  
  431.      PrintColor 
  432.  
  433.  
  434. ΓòÉΓòÉΓòÉ <hidden> ColorEnabled - Description ΓòÉΓòÉΓòÉ
  435.  
  436. Boolean property indicating whether color printing is enabled or not. 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 2.3. CurrentDevice ΓòÉΓòÉΓòÉ
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ <hidden> CurrentDevice - List ΓòÉΓòÉΓòÉ
  443.  
  444. Data Type 
  445.  
  446.       String 
  447.  
  448.  See Also 
  449.  
  450.      CurrentPrinter 
  451.      PrinterDialog 
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ <hidden> CurrentDevice - Description ΓòÉΓòÉΓòÉ
  455.  
  456. The name of the printer device selected for the printer object. This is the 
  457. same as the Physical Name seen in printer settings notebook. This is the name 
  458. used for printing charts. 
  459.  
  460. Warning: This property is read only and cannot be set with a call to VRSet. 
  461.  
  462.  
  463. ΓòÉΓòÉΓòÉ 2.4. CurrentPrinter ΓòÉΓòÉΓòÉ
  464.  
  465.  
  466. ΓòÉΓòÉΓòÉ <hidden> CurrentPrinter - list ΓòÉΓòÉΓòÉ
  467.  
  468. Data Type 
  469.  
  470.       String 
  471.  
  472.  See Also 
  473.  
  474.      CurrentDevice 
  475.      PrinterDialog 
  476.  
  477.  
  478. ΓòÉΓòÉΓòÉ <hidden> CurrentPrinter - Description ΓòÉΓòÉΓòÉ
  479.  
  480. The name of the printer selected for the printer object. This is the same as 
  481. the name seen on the desktop printer object. 
  482.  
  483. Warning: This property is read only and cannot be set with a call to VRSet. 
  484.  
  485.  
  486. ΓòÉΓòÉΓòÉ 2.5. DefaultPrinter ΓòÉΓòÉΓòÉ
  487.  
  488.  
  489. ΓòÉΓòÉΓòÉ <hidden> DefaultPrinter - List ΓòÉΓòÉΓòÉ
  490.  
  491. Data Type 
  492.  
  493.       String 
  494.  
  495.  See Also 
  496.  
  497.      CurrentDevice 
  498.      CurrentPrinter 
  499.      PrinterDialog 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ <hidden> DefaultPrinter - Description ΓòÉΓòÉΓòÉ
  503.  
  504. The name of the default system printer. This is the same as the name seen on 
  505. the desktop printer object. 
  506.  
  507. Warning: This property is read only and cannot be set with a call to VRSet. 
  508.  
  509.  
  510. ΓòÉΓòÉΓòÉ 2.6. FormHeight ΓòÉΓòÉΓòÉ
  511.  
  512.  
  513. ΓòÉΓòÉΓòÉ <hidden> FormHeight - List ΓòÉΓòÉΓòÉ
  514.  
  515. Data Type 
  516.  
  517.       Numeric 
  518.  
  519.  See Also 
  520.  
  521.      FormName 
  522.      FormWidth 
  523.  
  524.  
  525. ΓòÉΓòÉΓòÉ <hidden> FormHeight - Description ΓòÉΓòÉΓòÉ
  526.  
  527. The height of the currently selected form for the current printer in mm or 1/10 
  528. inch depending on the Measures property. 
  529.  
  530. Warning: This property is read only and cannot be set with a call to VRSet. 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 2.7. FormName ΓòÉΓòÉΓòÉ
  534.  
  535.  
  536. ΓòÉΓòÉΓòÉ <hidden> FormName - List ΓòÉΓòÉΓòÉ
  537.  
  538. Data Type 
  539.  
  540.       String 
  541.  
  542.  See Also 
  543.  
  544.      FormHeight 
  545.      FormWidth 
  546.  
  547.  
  548. ΓòÉΓòÉΓòÉ <hidden> FormName - Description ΓòÉΓòÉΓòÉ
  549.  
  550. The name of the currently selected form for the current printer. 
  551.  
  552. Warning: This property is read only and cannot be set with a call to VRSet. 
  553.  
  554.  
  555. ΓòÉΓòÉΓòÉ 2.8. FormWidth ΓòÉΓòÉΓòÉ
  556.  
  557.  
  558. ΓòÉΓòÉΓòÉ <hidden> FormWidth - List ΓòÉΓòÉΓòÉ
  559.  
  560. Data Type 
  561.  
  562.       String 
  563.  
  564.  See Also 
  565.  
  566.      FormHeight 
  567.      FormName 
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ <hidden> FormWidth - Description ΓòÉΓòÉΓòÉ
  571.  
  572. The width of the currently selected form for the current printer in mm or 1/10 
  573. inch depending on the Measures property. 
  574.  
  575. Warning: This property is read only and cannot be set with a call to VRSet. 
  576.  
  577.  
  578. ΓòÉΓòÉΓòÉ 2.9. JobName ΓòÉΓòÉΓòÉ
  579.  
  580.  
  581. ΓòÉΓòÉΓòÉ <hidden> JobName - List ΓòÉΓòÉΓòÉ
  582.  
  583. Data Type 
  584.  
  585.       String 
  586.  
  587.  
  588. ΓòÉΓòÉΓòÉ <hidden> JobName - Description ΓòÉΓòÉΓòÉ
  589.  
  590. The document name of the current print job. 
  591.  
  592. Warning: This property is read only and cannot be set with a call to VRSet. 
  593.  
  594.  
  595. ΓòÉΓòÉΓòÉ 2.10. LeftMargin ΓòÉΓòÉΓòÉ
  596.  
  597.  
  598. ΓòÉΓòÉΓòÉ <hidden> LeftMargin - List ΓòÉΓòÉΓòÉ
  599.  
  600. Data Type 
  601.  
  602.       Numeric 
  603.  
  604.  See Also 
  605.  
  606.      BottomMargin 
  607.      RightMargin 
  608.      TopMargin 
  609.      PageHeight 
  610.      PageWidth 
  611.  
  612.  
  613. ΓòÉΓòÉΓòÉ <hidden> LeftMargin - Description ΓòÉΓòÉΓòÉ
  614.  
  615. The distance of the left margin from the left edge of the page. The measure is 
  616. in mm or 1/10 inch depending on the Measures property. 
  617.  
  618. Warning: This property is read only and cannot be set with a call to VRSet. 
  619.  
  620.  
  621. ΓòÉΓòÉΓòÉ 2.11. LineSpace ΓòÉΓòÉΓòÉ
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ <hidden> LineSpace - List ΓòÉΓòÉΓòÉ
  625.  
  626. Data Type 
  627.  
  628.       Numeric 
  629.  
  630.  See Also 
  631.  
  632.      PrintCentered 
  633.      PrintJustified 
  634.      PrintRight 
  635.      PrintLeft 
  636.      PrintLine 
  637.  
  638.  
  639. ΓòÉΓòÉΓòÉ <hidden> LineSpace - Description ΓòÉΓòÉΓòÉ
  640.  
  641. Line spacing as a percentage of the font size. The default value is set to 
  642. single space = 120%. All writes following this call will use this inter-line 
  643. spacing. 
  644.  
  645.  
  646. ΓòÉΓòÉΓòÉ 2.12. Measures ΓòÉΓòÉΓòÉ
  647.  
  648.  
  649. ΓòÉΓòÉΓòÉ <hidden> Measures - List ΓòÉΓòÉΓòÉ
  650.  
  651. Data Type 
  652.  
  653.       String 
  654.  
  655.  Possible Values 
  656.  
  657.       Metric 
  658.       Inch 
  659.  
  660.  See Also 
  661.  
  662.      DefineTable 
  663.      SetFooter 
  664.      SetHeaderMode 
  665.      SetMargins 
  666.  
  667.  
  668. ΓòÉΓòÉΓòÉ <hidden> Measures - Description ΓòÉΓòÉΓòÉ
  669.  
  670. The units to use for distances on the printing page. These can be either mm 
  671. (the default) or in 1/10 inch units. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 2.13. MinBottomMar ΓòÉΓòÉΓòÉ
  675.  
  676.  
  677. ΓòÉΓòÉΓòÉ <hidden> MinBottomMar - List ΓòÉΓòÉΓòÉ
  678.  
  679. Data Type 
  680.  
  681.       Numeric 
  682.  
  683.  See Also 
  684.  
  685.      MinLeftMar 
  686.      MinRightMar 
  687.      MinTopMar 
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ <hidden> MinBottomMar - Description ΓòÉΓòÉΓòÉ
  691.  
  692. The minimum bottom margin allowed for the selected printer. The measure is in 
  693. mm or 1/10 inch depending on the Measures property. 
  694.  
  695. Warning: This property is read only and cannot be set with a call to VRSet. 
  696.  
  697.  
  698. ΓòÉΓòÉΓòÉ 2.14. MinLeftMar ΓòÉΓòÉΓòÉ
  699.  
  700.  
  701. ΓòÉΓòÉΓòÉ <hidden> MinLeftMar - List ΓòÉΓòÉΓòÉ
  702.  
  703. Data Type 
  704.  
  705.       Numeric 
  706.  
  707.  See Also 
  708.  
  709.      MinBottomMar 
  710.      MinRightMar 
  711.      MinTopMar 
  712.  
  713.  
  714. ΓòÉΓòÉΓòÉ <hidden> MinLeftMar - Description ΓòÉΓòÉΓòÉ
  715.  
  716. The minimum left margin allowed for the selected printer. The measure is in mm 
  717. or 1/10 inch depending on the Measures property. 
  718.  
  719. Warning: This property is read only and cannot be set with a call to VRSet. 
  720.  
  721.  
  722. ΓòÉΓòÉΓòÉ 2.15. MinRightMar ΓòÉΓòÉΓòÉ
  723.  
  724.  
  725. ΓòÉΓòÉΓòÉ <hidden> MinRightMar - List ΓòÉΓòÉΓòÉ
  726.  
  727. Data Type 
  728.  
  729.       Numeric 
  730.  
  731.  See Also 
  732.  
  733.      MinBottomMar 
  734.      MinLeftMar 
  735.      MinTopMar 
  736.  
  737.  
  738. ΓòÉΓòÉΓòÉ <hidden> MinRightMar - Description ΓòÉΓòÉΓòÉ
  739.  
  740. The minimum right margin allowed for the selected printer. The measure is in mm 
  741. or 1/10 inch depending on the Measures property. 
  742.  
  743. Warning: This property is read only and cannot be set with a call to VRSet. 
  744.  
  745.  
  746. ΓòÉΓòÉΓòÉ 2.16. MinTopMar ΓòÉΓòÉΓòÉ
  747.  
  748.  
  749. ΓòÉΓòÉΓòÉ <hidden> MinTopMar - List ΓòÉΓòÉΓòÉ
  750.  
  751. Data Type 
  752.  
  753.       Numeric 
  754.  
  755.  See Also 
  756.  
  757.      MinBottomMar 
  758.      MinLeftMar 
  759.      MinRightMar 
  760.  
  761.  
  762. ΓòÉΓòÉΓòÉ <hidden> MinTopMar - Description ΓòÉΓòÉΓòÉ
  763.  
  764. The minimum top margin allowed for the selected printer. The measure is in mm 
  765. or 1/10 inch depending on the Measures property. 
  766.  
  767. Warning: This property is read only and cannot be set with a call to VRSet. 
  768.  
  769.  
  770. ΓòÉΓòÉΓòÉ 2.17. PageHeight ΓòÉΓòÉΓòÉ
  771.  
  772.  
  773. ΓòÉΓòÉΓòÉ <hidden> PageHeight - List ΓòÉΓòÉΓòÉ
  774.  
  775. Data Type 
  776.  
  777.       Numeric 
  778.  
  779.  See Also 
  780.  
  781.      BottomMargin 
  782.      LeftMargin 
  783.      RightMargin 
  784.      TopMargin 
  785.      PageWidth 
  786.  
  787.  
  788. ΓòÉΓòÉΓòÉ <hidden> PageHeight - Decsription ΓòÉΓòÉΓòÉ
  789.  
  790. The height of the printing area of the page (bottom to top margin) in mm or 
  791. 1/10 inch depending on the Measures property. 
  792.  
  793. Warning: This property is read only and cannot be set with a call to VRSet. 
  794.  
  795.  
  796. ΓòÉΓòÉΓòÉ 2.18. PageNum ΓòÉΓòÉΓòÉ
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ <hidden> PageNum - List ΓòÉΓòÉΓòÉ
  800.  
  801. Data Type 
  802.  
  803.       Numeric 
  804.  
  805.  See Also 
  806.  
  807.      JobName 
  808.  
  809.  
  810. ΓòÉΓòÉΓòÉ <hidden> PageNum - Description ΓòÉΓòÉΓòÉ
  811.  
  812. This property contains the number of the page that is currently being printed. 
  813.  
  814. Warning: This property is read only and cannot be set with a call to VRSet. 
  815.  
  816.  
  817. ΓòÉΓòÉΓòÉ 2.19. PageWidth ΓòÉΓòÉΓòÉ
  818.  
  819.  
  820. ΓòÉΓòÉΓòÉ <hidden> PageWidth - List ΓòÉΓòÉΓòÉ
  821.  
  822. Data Type 
  823.  
  824.       Numeric 
  825.  
  826.  See Also 
  827.  
  828.      BottomMargin 
  829.      LeftMargin 
  830.      RightMargin 
  831.      TopMargin 
  832.      PageHeight 
  833.  
  834.  
  835. ΓòÉΓòÉΓòÉ <hidden> PageWidth - Description ΓòÉΓòÉΓòÉ
  836.  
  837. The width of the printing area of the page (left to right margin) in mm or 1/10 
  838. inch depending on the Measures property. 
  839.  
  840. Warning: This property is read only and cannot be set with a call to VRSet. 
  841.  
  842.  
  843. ΓòÉΓòÉΓòÉ 2.20. Printing ΓòÉΓòÉΓòÉ
  844.  
  845.  
  846. ΓòÉΓòÉΓòÉ <hidden> Printing - List ΓòÉΓòÉΓòÉ
  847.  
  848. Data Type 
  849.  
  850.       Boolean 
  851.  
  852.  Possible Values 
  853.  
  854.       1 (TRUE) 
  855.       0 (FALSE) 
  856.  
  857.  See Also 
  858.  
  859.      ClosePrintJob 
  860.      OpenPrintJob 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ <hidden> Printing - Description ΓòÉΓòÉΓòÉ
  864.  
  865. This property is set to 1 when a print job is open on the printer object. 
  866. Otherwise this property is set to 0. 
  867.  
  868. Warning: This property is read only and cannot be set with a call to VRSet. 
  869.  
  870.  
  871. ΓòÉΓòÉΓòÉ 2.21. PrintColor ΓòÉΓòÉΓòÉ
  872.  
  873.  
  874. ΓòÉΓòÉΓòÉ <hidden> PrintColor - List ΓòÉΓòÉΓòÉ
  875.  
  876. Data Type 
  877.  
  878.       String 
  879.  
  880.  Possible Values 
  881.  
  882.       See Description 
  883.  
  884.  See Also 
  885.  
  886.      ColorEnabled 
  887.  
  888.  
  889. ΓòÉΓòÉΓòÉ <hidden> PrintColor - Description ΓòÉΓòÉΓòÉ
  890.  
  891. This property is only relevant for colour printers. It contains the current 
  892. colour being used for printing. This color can be any of the followng values: 
  893.  
  894.  
  895.  White           Black           Blue
  896.  
  897.  Red             Pink            Green
  898.  
  899.  Cyan            Yellow          DarkGray
  900.  
  901.  DarkBlue        DarkRed         DarkPink
  902.  
  903.  DarkGreen       DarkCyan        Brown
  904.  
  905.  PaleGrey        <default>
  906.  
  907.  
  908. ΓòÉΓòÉΓòÉ 2.22. RightMargin ΓòÉΓòÉΓòÉ
  909.  
  910.  
  911. ΓòÉΓòÉΓòÉ <hidden> RightMargin - List ΓòÉΓòÉΓòÉ
  912.  
  913. Data Type 
  914.  
  915.       Numeric 
  916.  
  917.  See Also 
  918.  
  919.      BottomMargin 
  920.      LeftMargin 
  921.      TopMargin 
  922.      PageHeight 
  923.      PageWidth 
  924.  
  925.  
  926. ΓòÉΓòÉΓòÉ <hidden> RightMargin - Description ΓòÉΓòÉΓòÉ
  927.  
  928. The distance of the right margin from the right edge of the page. The measure 
  929. is in mm or 1/10 inch depending on the Measures property. 
  930.  
  931. Warning: This property is read only and cannot be set with a call to VRSet. 
  932.  
  933.  
  934. ΓòÉΓòÉΓòÉ 2.23. ShowProgress ΓòÉΓòÉΓòÉ
  935.  
  936.  
  937. ΓòÉΓòÉΓòÉ <hidden> ShowProgress - List ΓòÉΓòÉΓòÉ
  938.  
  939. Data Type 
  940.  
  941.       Boolean 
  942.  
  943.  Possible Values 
  944.  
  945.       1 (TRUE) 
  946.       0 (FALSE) 
  947.  
  948.  See Also 
  949.  
  950.      SetProgressTexts 
  951.  
  952.  
  953. ΓòÉΓòÉΓòÉ <hidden> ShowProgress - Description ΓòÉΓòÉΓòÉ
  954.  
  955. This is boolean property that when set enables the progress dialog to pop up 
  956. when a job is printing. 
  957.  
  958. Figure: Default Progress Dialog. 
  959.  
  960.  
  961. ΓòÉΓòÉΓòÉ 2.24. TopMargin ΓòÉΓòÉΓòÉ
  962.  
  963.  
  964. ΓòÉΓòÉΓòÉ <hidden> TopMargin - List ΓòÉΓòÉΓòÉ
  965.  
  966. Data Type 
  967.  
  968.       Numeric 
  969.  
  970.  See Also 
  971.  
  972.      BottomMargin 
  973.      LeftMargin 
  974.      RightMargin 
  975.      PageHeight 
  976.      PageWidth 
  977.  
  978.  
  979. ΓòÉΓòÉΓòÉ <hidden> TopMargin - Description ΓòÉΓòÉΓòÉ
  980.  
  981. The distance of the top margin from the upper edge of the page. The measure is 
  982. in mm or 1/10 inch depending on the Measures property. 
  983.  
  984. Warning: This property is read only and cannot be set with a call to VRSet. 
  985.  
  986.  
  987. ΓòÉΓòÉΓòÉ 2.25. Version ΓòÉΓòÉΓòÉ
  988.  
  989.  
  990. ΓòÉΓòÉΓòÉ <hidden> Version - List ΓòÉΓòÉΓòÉ
  991.  
  992. Data Type 
  993.  
  994.       Numeric 
  995.  
  996.  
  997. ΓòÉΓòÉΓòÉ <hidden> Version - Description ΓòÉΓòÉΓòÉ
  998.  
  999. Version number of the object. 
  1000.  
  1001. Warning: This property is read only and cannot be set with a call to VRSet. 
  1002.  
  1003.  
  1004. ΓòÉΓòÉΓòÉ 2.26. WordBreak ΓòÉΓòÉΓòÉ
  1005.  
  1006.  
  1007. ΓòÉΓòÉΓòÉ <hidden> WordBreak - List ΓòÉΓòÉΓòÉ
  1008.  
  1009. Data Type 
  1010.  
  1011.       Boolean 
  1012.  
  1013.  Possible Values 
  1014.  
  1015.       1 (TRUE) 
  1016.       0 (FALSE) 
  1017.  
  1018.  
  1019. ΓòÉΓòÉΓòÉ <hidden> WordBreak - Description ΓòÉΓòÉΓòÉ
  1020.  
  1021. The WordBreak property allows you to control the way the VRPrinter Object 
  1022. performs word wrapping on a block of text. By default this property is set to 1 
  1023. (TRUE) so that the breaks occur between words. By setting this property off 
  1024. (0), line wrapping will occur with breaks between characters. 
  1025.  
  1026.  
  1027. ΓòÉΓòÉΓòÉ 3. VRPrinter events ΓòÉΓòÉΓòÉ
  1028.  
  1029. No events are triggred by the VRPrinter Object. 
  1030.  
  1031.  
  1032. ΓòÉΓòÉΓòÉ 4. VRPrinter methods ΓòÉΓòÉΓòÉ
  1033.  
  1034. The following sections describe each of the methods available for the VRPrinter 
  1035. Object. 
  1036.  
  1037.      AbortPrintJob 
  1038.      BlockFits 
  1039.      ClosePrintJob 
  1040.      DefineTable 
  1041.      EndRow 
  1042.      EndTable 
  1043.      FontDialog 
  1044.      Goto 
  1045.      JobProperties 
  1046.      LineFits 
  1047.      MoveX 
  1048.      MoveY 
  1049.      NewPage 
  1050.      OpenPrintJob 
  1051.      PrintBitMap 
  1052.      PrintBox 
  1053.      PrintCentered 
  1054.      PrinterDialog 
  1055.      PrinterList 
  1056.      PrintFile 
  1057.      PrintJustified 
  1058.      PrintLeft 
  1059.      PrintLine 
  1060.      PrintObjectImage 
  1061.      PrintRight 
  1062.      PrintWinImage 
  1063.      ResetColHeader 
  1064.      ResetHeader 
  1065.      SetFooter 
  1066.      SetHeader 
  1067.      SetHeaderLineFont 
  1068.      SetHeaderMode 
  1069.      SetMargins 
  1070.      SetPrinter 
  1071.      SetProgressTexts 
  1072.      StartCol 
  1073.      StartRow 
  1074.      StartTable 
  1075.      Tab 
  1076.  
  1077.  
  1078. ΓòÉΓòÉΓòÉ 4.1. AbortPrintJob ΓòÉΓòÉΓòÉ
  1079.  
  1080.  
  1081. ΓòÉΓòÉΓòÉ <hidden> AbortPrintJob - List ΓòÉΓòÉΓòÉ
  1082.  
  1083. Topics 
  1084.  
  1085.      Description 
  1086.      Parameters 
  1087.      Example 
  1088.  
  1089.  See Also 
  1090.  
  1091.      OpenPrintJob 
  1092.      ClosePrintJob 
  1093.  
  1094.  
  1095. ΓòÉΓòÉΓòÉ <hidden> AbortPrintJob - Description ΓòÉΓòÉΓòÉ
  1096.  
  1097. ok = VRMethod( object, "AbortPrintJob");
  1098.  
  1099. Aborts the print job and deletes the document from the print queue. 
  1100.  
  1101. Return 
  1102.  
  1103. TRUE (1) if successful else FALSE (0). 
  1104.  
  1105.  
  1106. ΓòÉΓòÉΓòÉ <hidden> AbortPrintJob - Parameters ΓòÉΓòÉΓòÉ
  1107.  
  1108.  None 
  1109.  
  1110.  
  1111. ΓòÉΓòÉΓòÉ <hidden> AbortPrintJob - Example ΓòÉΓòÉΓòÉ
  1112.  
  1113. /********************************************************************/
  1114. /* Abort the print job                                              */
  1115. /********************************************************************/
  1116.  
  1117. ok = VRMethod( "PRT_1", "AbortPrintJob");
  1118.  
  1119.  
  1120. ΓòÉΓòÉΓòÉ 4.2. BlockFits ΓòÉΓòÉΓòÉ
  1121.  
  1122.  
  1123. ΓòÉΓòÉΓòÉ <hidden> BlockFits - List ΓòÉΓòÉΓòÉ
  1124.  
  1125. Topics 
  1126.  
  1127.      Description 
  1128.      Parameters 
  1129.      Example 
  1130.  
  1131.  See Also 
  1132.  
  1133.      LineFits 
  1134.      PrintCentered 
  1135.      PrintJustified 
  1136.      PrintRight 
  1137.      PrintLeft 
  1138.      PrintLine 
  1139.      FontDialog 
  1140.  
  1141.  
  1142. ΓòÉΓòÉΓòÉ <hidden> BlockFits - Description ΓòÉΓòÉΓòÉ
  1143.  
  1144. ok = VRMethod( object, "BlockFits",
  1145.                        face_name,
  1146.                        points,
  1147.                        string);
  1148.  
  1149. Checks whether the text will fit as one block onto the page or needs a new page 
  1150. to complete. 
  1151.  
  1152. Return 
  1153.  
  1154. TRUE (1) if the block of text will fit on the page else FALSE (0). 
  1155.  
  1156. Note: 
  1157. No text is actually printed. 
  1158.  
  1159.  
  1160. ΓòÉΓòÉΓòÉ <hidden> BlockFits - parameters ΓòÉΓòÉΓòÉ
  1161.  
  1162.  face_name           Name of the font used to print. This MUST be an outline 
  1163.                      font. If this is left empty, the previous font is used. 
  1164.  points              Point size of the font, If this is left empty, the 
  1165.                      previous font size is used. 
  1166.  string              The string to be printed. 
  1167.  
  1168.  
  1169. ΓòÉΓòÉΓòÉ <hidden> BlockFits - Example ΓòÉΓòÉΓòÉ
  1170.  
  1171.  
  1172.     facename = 'Helvetica';
  1173.  
  1174.     /**** Text is long block of text */
  1175.     fnt = 8
  1176.     rcy = VRMethod( "PRT_1", "PrintLine", facename, fnt, text);
  1177.     rcy = VRMethod( "PRT_1", "PrintLine", , fnt, '');
  1178.     do fnt = 10 to 24 by 2
  1179.         if VRMethod( "PRT_1", "BlockFits", facename, fnt, text) then
  1180.             rcy = VRMethod( "PRT_1", "PrintLine", , fnt, text);
  1181.         else do
  1182.             rcy = VRMethod( "PRT_1", "Goto", 0, 10, 1);
  1183.             rcy = VRMethod( "PRT_1", "PrintRight", , 10, "Continued...");
  1184.             rcy = VRMethod( "PRT_1", "PrintLine", , fnt, text);
  1185.         end
  1186.         if VRMethod( "PRT_1", "BlockFits", facename, fnt, '') then
  1187.             rcy = VRMethod( "PRT_1", "PrintLine", , fnt, '');
  1188.         else
  1189.             rcy = VRMethod( "PRT_1", "PrintRight", , 10, "Continued...");
  1190.     end
  1191.  
  1192.  
  1193. ΓòÉΓòÉΓòÉ 4.3. ClosePrintJob ΓòÉΓòÉΓòÉ
  1194.  
  1195.  
  1196. ΓòÉΓòÉΓòÉ <hidden> ClosePrintJob - List ΓòÉΓòÉΓòÉ
  1197.  
  1198. Topics 
  1199.  
  1200.      Description 
  1201.      Parameters 
  1202.      Example 
  1203.  
  1204.  See Also 
  1205.  
  1206.      OpenPrintJob 
  1207.      AbortPrintJob 
  1208.  
  1209.  
  1210. ΓòÉΓòÉΓòÉ <hidden> ClosePrintJob - Description ΓòÉΓòÉΓòÉ
  1211.  
  1212. ok = VRMethod( object, "ClosePrintJob");
  1213.  
  1214. Close the print job and end the document. 
  1215.  
  1216. Return 
  1217.  
  1218. TRUE (1) if successful else FALSE (0). 
  1219.  
  1220.  
  1221. ΓòÉΓòÉΓòÉ <hidden> ClosePrintJob - parameters ΓòÉΓòÉΓòÉ
  1222.  
  1223.  None 
  1224.  
  1225.  
  1226. ΓòÉΓòÉΓòÉ <hidden> ClosePrintJob - Example ΓòÉΓòÉΓòÉ
  1227.  
  1228. /********************************************************************/
  1229. /* Close the print job                                              */
  1230. /********************************************************************/
  1231.  
  1232. ok = VRMethod( "PRT_1", "ClosePrintJob");
  1233.  
  1234.  
  1235. ΓòÉΓòÉΓòÉ 4.4. DefineTable ΓòÉΓòÉΓòÉ
  1236.  
  1237.  
  1238. ΓòÉΓòÉΓòÉ <hidden> DefineTable - List ΓòÉΓòÉΓòÉ
  1239.  
  1240. Topics 
  1241.  
  1242.      Description 
  1243.      Parameters 
  1244.      Example 
  1245.  
  1246.  See Also 
  1247.  
  1248.      StartTable 
  1249.      StartRow 
  1250.      StartCol 
  1251.      EndRow 
  1252.      EndTable 
  1253.  
  1254.  
  1255. ΓòÉΓòÉΓòÉ <hidden> DefineTable - Description ΓòÉΓòÉΓòÉ
  1256.  
  1257. ok = VRMethod( object, "DefineTable",
  1258.                        "table.",
  1259.                        "Cols.");
  1260.  
  1261. Defines a table for printing. If there are not the right number of elements in 
  1262. the stem vars the method will return FALSE. 
  1263.  
  1264. This call only prepares the internal structures for handling a table, to start 
  1265. printing the table you must call StartRow and StartCol. 
  1266.  
  1267. Return 
  1268.  
  1269. TRUE (1) if successful else FALSE (0). 
  1270.  
  1271.  
  1272. ΓòÉΓòÉΓòÉ <hidden> DefineTable - Parameters ΓòÉΓòÉΓòÉ
  1273.  
  1274.  "table."            Quoted name of a stem variable containing the definition 
  1275.                      of the table: 
  1276.                      table.0             Must be 9 for monochrome printing or 
  1277.                                          15 if you use colour support 
  1278.                      table.1             fill style for the table (see Fill 
  1279.                                          Syles) 
  1280.                      table.2             line thickness in TWIPS for the 
  1281.                                          outlines of the cells in the table 
  1282.                      table.3             Flag indicating that table has column 
  1283.                                          headers 
  1284.                      table.4             fill style for the table header (see 
  1285.                                          Fill Syles) 
  1286.                      table.5             line thickness in TWIPS for the 
  1287.                                          outlines of the table headers 
  1288.                      table.6             Flag indicating that the table header 
  1289.                                          should be printed on all pages. 
  1290.                                          (1 = TRUE, 0 = FALSE) 
  1291.                      table.7             Point size of text for column header 
  1292.                                          texts 
  1293.                      table.8             Font face name for column header texts 
  1294.  
  1295.                      table.9             Left edge of the table from the left 
  1296.                                          margin in mm or 1/10 inch depending on 
  1297.                                          the Measures property 
  1298.                      table.10            Colour for the text in the table cells 
  1299.                      table.11            Colour for the line around table cells 
  1300.                      table.12            Colour for the fill pattern in table 
  1301.                                          cells 
  1302.                      table.13            Colour for the text in the table 
  1303.                                          headers 
  1304.                      table.14            Colour for the line around table 
  1305.                                          headers 
  1306.                      table.15            Colour for the fill pattern in table 
  1307.                                          headers 
  1308.  "Cols."             Quoted name of a complex stem variable containing the 
  1309.                      definitions for the columns in the table. it has the form 
  1310.                      Cols.x.y 
  1311.                      where 
  1312.      x is the column reference starting with 1 y is the field number 
  1313.                      Cols.0.0            Number of columns in the table 
  1314.                      Cols.x.1            Width of the column in mm or 1/10 inch 
  1315.                                          depending on the Measures property 
  1316.                      Cols.x.2            Column header text 
  1317.  
  1318.  
  1319. ΓòÉΓòÉΓòÉ <hidden> DefineTable - Example ΓòÉΓòÉΓòÉ
  1320.  
  1321. /************************************************************************/
  1322. /* Declare a table with no fill style, 0.5 mm separator lines, 1mm      */
  1323. /* lines around headers on all pages and 3 columns                      */
  1324. /************************************************************************/
  1325.  
  1326. table.0 = 15
  1327. table.1 = 0
  1328. table.2 = 28
  1329. table.3 = 1
  1330. table.4 = 0
  1331. table.5 = 56
  1332. table.6 = 1
  1333. table.7 = 12
  1334. table.8 = 'Helvetica Bold'
  1335. table.9 = 10
  1336. table.10 = "Red"
  1337. table.11 = "Cyan"
  1338. table.12 = "Black"
  1339. table.13 = "Blue"
  1340. table.14 = "White"
  1341. table.15 = "Black"
  1342.  
  1343. Cols.0.0 = 3
  1344.  
  1345. Cols.1.1 = 45
  1346. Cols.1.2 = 'Column 1'
  1347.  
  1348. Cols.2.1 = 75
  1349. Cols.2.2 = 'Column 2'
  1350.  
  1351. Cols.3.1 = 40
  1352. Cols.3.2 = 'Column 3'
  1353.  
  1354. ok = VRMethod( "PRT_1", "DefineTable", "table.", "Cols.");
  1355.  
  1356. if ok then do
  1357.  
  1358.     /**** Start printing in the table **********************************/
  1359.  
  1360.     ok = VRMethod( "PRT_1", "StartRow");
  1361.  
  1362.     /**** Start printing in column 1 ***********************************/
  1363.  
  1364.     ok = VRMethod( "PRT_1", "StartCol", 1);
  1365.     ok = VRMethod( "PRT_1", "PrintRight", 'Helvetica', 10, textvar);
  1366.  
  1367.     /**** Start printing in column 2 ***********************************/
  1368.  
  1369.     ok = VRMethod( "PRT_1", "StartCol", 2);
  1370.     ok = VRMethod( "PRT_1", "PrintJustified", 'Helvetica Bold', 10, textvar);
  1371.     ok = VRMethod( "PRT_1", "PrintJustified",,,textvar);
  1372.     ok = VRMethod( "PRT_1", "PrintJustified",,,textvar);
  1373.  
  1374.     /**** Start printing in column 3 ***********************************/
  1375.  
  1376.     ok = VRMethod( "PRT_1", "StartCol", 3);
  1377.     ok = VRMethod( "PRT_1", "PrintCentered", 'Helvetica Bold', 14, textvar);
  1378.  
  1379.     /**** Print the row ************************************************/
  1380.  
  1381.     ok = VRMethod( "PRT_1", "EndRow");
  1382.  
  1383.     /**** Start a new row **********************************************/
  1384.  
  1385.     ok = VRMethod( "PRT_1", "StartRow");
  1386.     ok = VRMethod( "PRT_1", "StartCol", 1);
  1387.     ok = VRMethod( "PRT_1", "PrintRight", 'Times New Roman', 10, textvar);
  1388.     ok = VRMethod( "PRT_1", "StartCol", 2);
  1389.     ok = VRMethod( "PRT_1", "PrintLeft", 'Helvetica Bold', 10, textvar);
  1390.     ok = VRMethod( "PRT_1", "PrintCentered",,,textvar);
  1391.     ok = VRMethod( "PRT_1", "PrintJustified",,,textvar);
  1392.     ok = VRMethod( "PRT_1", "PrintRight",,,textvar);
  1393.     ok = VRMethod( "PRT_1", "StartCol", 3);
  1394.     ok = VRMethod( "PRT_1", "PrintJustified", 'Times New Roman', 8, textvar);
  1395.  
  1396.     /**** Print the row ************************************************/
  1397.  
  1398.     ok = VRMethod( "PRT_1", "EndRow");
  1399.  
  1400.     /**** Destroy the table data structures ****************************/
  1401.  
  1402.     ok = VRMethod( object, "EndTable");
  1403. end
  1404.  
  1405.  
  1406. ΓòÉΓòÉΓòÉ 4.5. EndRow ΓòÉΓòÉΓòÉ
  1407.  
  1408.  
  1409. ΓòÉΓòÉΓòÉ <hidden> EndRow - List ΓòÉΓòÉΓòÉ
  1410.  
  1411. Topics 
  1412.  
  1413.      Description 
  1414.      Parameters 
  1415.  
  1416.  See Also 
  1417.  
  1418.      DefineTable 
  1419.      StartTable 
  1420.      StartRow 
  1421.      StartCol 
  1422.      EndTable 
  1423.  
  1424.  
  1425. ΓòÉΓòÉΓòÉ <hidden> EndRow - Description ΓòÉΓòÉΓòÉ
  1426.  
  1427. ok = VRMethod( object, "EndRow");
  1428.  
  1429. End the current row in a table and print it. This will cause the table to wrap 
  1430. over page if any of the columns will not fit. Cells will be split over the page 
  1431. not forced onto the next page. If you have defined running headers for the 
  1432. table, these will be printed at the top of the page. 
  1433.  
  1434. Return 
  1435.  
  1436. TRUE (1) if successful else FALSE (0). 
  1437.  
  1438.  
  1439. ΓòÉΓòÉΓòÉ <hidden> EndRow - Parameters ΓòÉΓòÉΓòÉ
  1440.  
  1441.  None 
  1442.  
  1443.  
  1444. ΓòÉΓòÉΓòÉ 4.6. EndTable ΓòÉΓòÉΓòÉ
  1445.  
  1446.  
  1447. ΓòÉΓòÉΓòÉ <hidden> EndTable - List ΓòÉΓòÉΓòÉ
  1448.  
  1449. Topics 
  1450.  
  1451.      Description 
  1452.      Parameters 
  1453.  
  1454.  See Also 
  1455.  
  1456.      DefineTable 
  1457.      StartTable 
  1458.      StartRow 
  1459.      StartCol 
  1460.      EndRow 
  1461.  
  1462.  
  1463. ΓòÉΓòÉΓòÉ <hidden> EndTable - Description ΓòÉΓòÉΓòÉ
  1464.  
  1465. ok = VRMethod( object, "EndTable");
  1466.  
  1467. Terminate table mode printing and return to normal text printing. 
  1468.  
  1469. Return 
  1470.  
  1471. TRUE (1) if successful else FALSE (0). 
  1472.  
  1473.  
  1474. ΓòÉΓòÉΓòÉ <hidden> EndTable - Parameters ΓòÉΓòÉΓòÉ
  1475.  
  1476.  None 
  1477.  
  1478.  
  1479. ΓòÉΓòÉΓòÉ 4.7. FontDialog ΓòÉΓòÉΓòÉ
  1480.  
  1481.  
  1482. ΓòÉΓòÉΓòÉ <hidden> FontDialog - List ΓòÉΓòÉΓòÉ
  1483.  
  1484. Topics 
  1485.  
  1486.      Description 
  1487.      Parameters 
  1488.      Example 
  1489.  
  1490.  See Also 
  1491.  
  1492.      PrinterDialog 
  1493.      PrinterList 
  1494.      SetPrinter 
  1495.  
  1496.  
  1497. ΓòÉΓòÉΓòÉ <hidden> FontDialog - Description ΓòÉΓòÉΓòÉ
  1498.  
  1499. font = VRMethod( object, "FontDialog",
  1500.                          title,
  1501.                          familyname);
  1502.  
  1503. Pops up a dialog with a list of fonts available on your work station for the 
  1504. selected printer. 
  1505.  
  1506. Return 
  1507.  
  1508. Name of the selected font if successful, otherwise an empty string. 
  1509.  
  1510. Figure: Font Dialog. 
  1511.  
  1512.  
  1513. ΓòÉΓòÉΓòÉ <hidden> FontDialog - parameters ΓòÉΓòÉΓòÉ
  1514.  
  1515.  title               Title to appear in the font dialog. 
  1516.  familyname          This will set the default selected font in the dialog. 
  1517.                      This is the name of the font e.g. Helvetica and should not 
  1518.                      include the point size or attributes. 
  1519.  
  1520.  
  1521. ΓòÉΓòÉΓòÉ <hidden> FontDialog - Example ΓòÉΓòÉΓòÉ
  1522.  
  1523.  
  1524. fntstr = VRMethod( "PRT_1", "FontDialog", "Choose printer font", "CG Times");
  1525.  
  1526. ok = VRSet( "EF_1", "Value", fntstr);
  1527.  
  1528.  
  1529. ΓòÉΓòÉΓòÉ 4.8. Goto ΓòÉΓòÉΓòÉ
  1530.  
  1531.  
  1532. ΓòÉΓòÉΓòÉ <hidden> Goto - List ΓòÉΓòÉΓòÉ
  1533.  
  1534. Topics 
  1535.  
  1536.      Description 
  1537.      Parameters 
  1538.  
  1539.  
  1540. ΓòÉΓòÉΓòÉ <hidden> Goto - Description ΓòÉΓòÉΓòÉ
  1541.  
  1542. ok = VRMethod( object, "Goto",
  1543.                        x,
  1544.                        y,
  1545.                        use_points);
  1546.  
  1547. Move the GPI cursor to the given position on the page. 
  1548.  
  1549. Return 
  1550.  
  1551. TRUE (1) if successful else FALSE (0). 
  1552.  
  1553.  
  1554. ΓòÉΓòÉΓòÉ <hidden> Goto - Parameters ΓòÉΓòÉΓòÉ
  1555.  
  1556.  x                   X coordinate in millimetres or 1/10 inch depending on the 
  1557.                      Measures property from the left margin, unless use_points 
  1558.                      is 1 
  1559.  y                   Y coordinate in millimetres or 1/10 inch depending on the 
  1560.                      Measures property from the bottom margin, unless 
  1561.                      use_points is 1 
  1562.  use_points          flag indicating whether to use the default Measures or 
  1563.                      points. 
  1564.                      0 (or parameter absent) = Use default measure 
  1565.                      1 = use Points 
  1566.  
  1567.  
  1568. ΓòÉΓòÉΓòÉ 4.9. JobProperties ΓòÉΓòÉΓòÉ
  1569.  
  1570.  
  1571. ΓòÉΓòÉΓòÉ <hidden> JobProperties - List ΓòÉΓòÉΓòÉ
  1572.  
  1573. Topics 
  1574.  
  1575.      Description 
  1576.      Parameters 
  1577.  
  1578.  See Also 
  1579.  
  1580.      PrinterDialog 
  1581.      PrinterList 
  1582.      SetPrinter 
  1583.  
  1584.  
  1585. ΓòÉΓòÉΓòÉ <hidden> JobProperties - Description ΓòÉΓòÉΓòÉ
  1586.  
  1587. ok = VRMethod( object, "JobProperties");
  1588.  
  1589. Pops up the job properties dialog for the printer selected with PrinterDialog 
  1590. or with SetPrinter. If there is no selected printer, an error dialog is popped 
  1591. up and the method returns FALSE. 
  1592.  
  1593. Return 
  1594.  
  1595. TRUE (1) if successful else FALSE (0). 
  1596.  
  1597. Figure: Printer Job Properties Dialog for a Laserjet IIIP. 
  1598.  
  1599.  
  1600. ΓòÉΓòÉΓòÉ <hidden> JobProperties - Parameters ΓòÉΓòÉΓòÉ
  1601.  
  1602.  None 
  1603.  
  1604.  
  1605. ΓòÉΓòÉΓòÉ 4.10. LineFits ΓòÉΓòÉΓòÉ
  1606.  
  1607.  
  1608. ΓòÉΓòÉΓòÉ <hidden> LineFits - List ΓòÉΓòÉΓòÉ
  1609.  
  1610. Topics 
  1611.  
  1612.      Description 
  1613.      Parameters 
  1614.  
  1615.  See Also 
  1616.  
  1617.      BlockFits 
  1618.      PrintCentered 
  1619.      PrintJustified 
  1620.      PrintRight 
  1621.      PrintLeft 
  1622.      PrintLine 
  1623.      FontDialog 
  1624.  
  1625.  
  1626. ΓòÉΓòÉΓòÉ <hidden> LineFits - Description ΓòÉΓòÉΓòÉ
  1627.  
  1628. ok = VRMethod( object, "LineFits",
  1629.                        face_name,
  1630.                        points,
  1631.                        string);
  1632.  
  1633. Checks whether the text will fit onto the line or needs to be wrapped. 
  1634.  
  1635. Return 
  1636.  
  1637. TRUE (1) if the block of text will fit on the line else FALSE (0). 
  1638.  
  1639. Note: 
  1640. No text is actually printed. 
  1641.  
  1642.  
  1643. ΓòÉΓòÉΓòÉ <hidden> LineFits - Parameters ΓòÉΓòÉΓòÉ
  1644.  
  1645.  face_name           Name of the font used to print. This MUST be an outline 
  1646.                      font. If this is left empty, the previous font is used. 
  1647.  points              Point size of the font, If this is left empty, the 
  1648.                      previous font size is used. 
  1649.  string              The string to be printed. 
  1650.  
  1651.  
  1652. ΓòÉΓòÉΓòÉ 4.11. MoveX ΓòÉΓòÉΓòÉ
  1653.  
  1654.  
  1655. ΓòÉΓòÉΓòÉ <hidden> MoveX - List ΓòÉΓòÉΓòÉ
  1656.  
  1657. Topics 
  1658.  
  1659.      Description 
  1660.      Parameters 
  1661.  
  1662.  See Also 
  1663.  
  1664.      Goto 
  1665.      MoveY 
  1666.  
  1667.  
  1668. ΓòÉΓòÉΓòÉ <hidden> MoveX - Description ΓòÉΓòÉΓòÉ
  1669.  
  1670. ok = VRMethod( object, "MoveX",
  1671.                        relX,
  1672.                        points);
  1673.  
  1674. Moves the x position of the graphics printing cursor relX units relative to the 
  1675. current position. If points is TRUE (1), the cursor is moved relX points, 
  1676. otherwise the current Measures are used. 
  1677.  
  1678. Return 
  1679.  
  1680. TRUE (1) if the cursor was moved else FALSE (0). 
  1681.  
  1682.  
  1683. ΓòÉΓòÉΓòÉ <hidden> MoveX - Parameters ΓòÉΓòÉΓòÉ
  1684.  
  1685.  relX                Number of measurement units to move the cursor. This may 
  1686.                      be a negative value, in which case the cursor is moved to 
  1687.                      the left. 
  1688.  points              Boolean (1 or 0) indicating whether the measures should be 
  1689.                      in points (TRUE) or default Measures (FALSE). 
  1690.  
  1691.  
  1692. ΓòÉΓòÉΓòÉ 4.12. MoveY ΓòÉΓòÉΓòÉ
  1693.  
  1694.  
  1695. ΓòÉΓòÉΓòÉ <hidden> MoveY - List ΓòÉΓòÉΓòÉ
  1696.  
  1697. Topics 
  1698.  
  1699.      Description 
  1700.      Parameters 
  1701.  
  1702.  See Also 
  1703.  
  1704.      Goto 
  1705.      MoveX 
  1706.  
  1707.  
  1708. ΓòÉΓòÉΓòÉ <hidden> MoveY - Description ΓòÉΓòÉΓòÉ
  1709.  
  1710. ok = VRMethod( object, "MoveY",
  1711.                        relY,
  1712.                        points);
  1713.  
  1714. Moves the y position of the graphics printing cursor relY units relative to the 
  1715. current position. If points is TRUE (1), the cursor is moved relY points, 
  1716. otherwise the current Measures are used. 
  1717.  
  1718. Return 
  1719.  
  1720. TRUE (1) if the cursor was moved else FALSE (0). 
  1721.  
  1722.  
  1723. ΓòÉΓòÉΓòÉ <hidden> MoveY - Parameters ΓòÉΓòÉΓòÉ
  1724.  
  1725.  relY                Number of measurement units to move the cursor. This may 
  1726.                      be a negative value, in which case the cursor is moved to 
  1727.                      the left. 
  1728.  points              Boolean (1 or 0) indicating whether the measures should be 
  1729.                      in points (TRUE) or default Measures (FALSE). 
  1730.  
  1731.  
  1732. ΓòÉΓòÉΓòÉ 4.13. NewPage ΓòÉΓòÉΓòÉ
  1733.  
  1734.  
  1735. ΓòÉΓòÉΓòÉ <hidden> NewPage - List ΓòÉΓòÉΓòÉ
  1736.  
  1737. Topics 
  1738.  
  1739.      Description 
  1740.      Parameters 
  1741.  
  1742.  See Also 
  1743.  
  1744.      SetHeader 
  1745.      SetHeaderMode 
  1746.      SetFooter 
  1747.      SetMargins 
  1748.  
  1749.  
  1750. ΓòÉΓòÉΓòÉ <hidden> NewPage - Description ΓòÉΓòÉΓòÉ
  1751.  
  1752. ok = VRMethod( object, "NewPage");
  1753.  
  1754. Forces a new page to be printed with its header and footer. If this method is 
  1755. called inside a table, any headers defined for the table will also be printed. 
  1756.  
  1757. Warning: This method will not function when called within a table. Tables 
  1758. handle the wrapping over pages internally. 
  1759.  
  1760. Return 
  1761.  
  1762. TRUE (1) if successful else FALSE (0). 
  1763.  
  1764.  
  1765. ΓòÉΓòÉΓòÉ <hidden> NewPage - Parameters ΓòÉΓòÉΓòÉ
  1766.  
  1767. Parameters 
  1768.  
  1769.  None 
  1770.  
  1771.  
  1772. ΓòÉΓòÉΓòÉ 4.14. OpenPrintJob ΓòÉΓòÉΓòÉ
  1773.  
  1774.  
  1775. ΓòÉΓòÉΓòÉ <hidden> OpenPrintJob - List ΓòÉΓòÉΓòÉ
  1776.  
  1777. Topics 
  1778.  
  1779.      Description 
  1780.      Parameters 
  1781.      Example 
  1782.  
  1783.  See Also 
  1784.  
  1785.      PrinterDialog 
  1786.      SetPrinter 
  1787.      SetMargins 
  1788.      SetHeader 
  1789.      SetHeaderMode 
  1790.      SetFooter 
  1791.      ClosePrintJob 
  1792.  
  1793.  
  1794. ΓòÉΓòÉΓòÉ <hidden> OpenPrintJob - Description ΓòÉΓòÉΓòÉ
  1795.  
  1796. ok = VRMethod( object, "OpenPrintJob",
  1797.                        doc_name,
  1798.                        num_copies);
  1799.  
  1800. Opens the print job with the spooler. You should previously define the margins, 
  1801. header and and footer and, if you do not want to use the default printer, have 
  1802. selected a printer. 
  1803.  
  1804. Note:  If you have not selected a printer and there is no default printer for 
  1805. the system, an error dialog is popped up and the method returns FALSE. 
  1806.  
  1807. Return 
  1808.  
  1809. TRUE (1) if successful else FALSE (0). 
  1810.  
  1811.  
  1812. ΓòÉΓòÉΓòÉ <hidden> OpenPrintJob - Parameters ΓòÉΓòÉΓòÉ
  1813.  
  1814.  doc_name            The title of the document. This will aslo be passed to the 
  1815.                      spooler ad the document name. 
  1816.  num_copies          The number of copies to print. 
  1817.  
  1818.  
  1819. ΓòÉΓòÉΓòÉ <hidden> OpenPrintJob - Example ΓòÉΓòÉΓòÉ
  1820.  
  1821.  
  1822. ok = VRMethod( "PRT_1", "SetMargins", 25, 20, 20, 25, 0, 0);
  1823. ok = VRMethod( "PRT_1", "SetHeaderMode", header, facename, 10, 8, 28, 0);
  1824. ok = VRMethod( "PRT_1", "SetHeader", 3, ,
  1825.                        "$c|", "$lADD Consulting (CH)$r@",,
  1826.                        'Demo for VRPrinter Object for VX-REXX');
  1827. ok = VRMethod( "PRT_1", "SetFooter", facename, 8, 0, 14, '$|$rpage $#');
  1828. ok = VRMethod( "PRT_1", "OpenPrintJob", 'Document Title');
  1829.  
  1830. if \ok then
  1831.    return
  1832.  
  1833.  
  1834. ΓòÉΓòÉΓòÉ 4.15. PrintBitMap ΓòÉΓòÉΓòÉ
  1835.  
  1836.  
  1837. ΓòÉΓòÉΓòÉ <hidden> PrintBitMap - List ΓòÉΓòÉΓòÉ
  1838.  
  1839. Topics 
  1840.  
  1841.      Description 
  1842.      Parameters 
  1843.      Example 
  1844.  
  1845.  See Also 
  1846.  
  1847.      PrintBox 
  1848.      PrintObjectImage 
  1849.      PrintWinImage 
  1850.  
  1851.  
  1852. ΓòÉΓòÉΓòÉ <hidden> PrintBitMap - Description ΓòÉΓòÉΓòÉ
  1853.  
  1854. ok = VRMethod( object, "PrintBitMap",
  1855.                         bitmap_file,
  1856.                         lx, ly,
  1857.                         tx, ty,
  1858.                         th,
  1859.                         border_color);
  1860.  
  1861. Prints a bitmap from a file in the box given by the coordinates and framed in 
  1862. the given line style. 
  1863.  
  1864. The bit map will be stretched or compressed to fit and, if the printer supports 
  1865. colour, will be printed in colour. 
  1866.  
  1867. Return 
  1868.  
  1869. TRUE (1) if successful else FALSE (0). 
  1870.  
  1871.  
  1872. ΓòÉΓòÉΓòÉ <hidden> PrintBitMap - Parameters ΓòÉΓòÉΓòÉ
  1873.  
  1874.  bitmap_file         Full path to the bitmap file you want to print 
  1875.  lx                  Lower left X coordinate taken from the left margin in 
  1876.                      millimetres or 1/10 inch depending on the Measures 
  1877.                      property 
  1878.  ly                  Lower left Y coordinate taken from the bottom margin in 
  1879.                      millimetres or 1/10 inch depending on the Measures 
  1880.                      property 
  1881.  tx                  Upper right X coordinate taken from the left margin in 
  1882.                      millimetres or 1/10 inch depending on the Measures 
  1883.                      property 
  1884.  ty                  Upper right Y coordinate taken from the bottom margin in 
  1885.                      millimetres or 1/10 inch depending on the Measures 
  1886.                      property 
  1887.  th                  Thickness of the box line in TWIPS ( 56.7 TWIPS = 1mm) 
  1888.  border_color        The colour of the line around the bitmap. One of the 
  1889.                      colour strings defined by VX-REXX 
  1890.  
  1891.  
  1892. ΓòÉΓòÉΓòÉ <hidden> PrintBitMap - Example ΓòÉΓòÉΓòÉ
  1893.  
  1894.  
  1895. /********************************************************************/
  1896. /* Print the OS/2 logo in a box with a thick outline                */
  1897. /********************************************************************/
  1898.  
  1899. /**** Get the path to the bit map ***********************************/
  1900.  
  1901. set_path = VALUE( 'PATH', , 'OS2ENVIRONMENT');
  1902. bootdrive = substr( set_path, pos( '\OS2\SYSTEM', set_path ) -2, 2);
  1903. bmp_name = bootdrive || '\os2\bitmap\os2logo.bmp'
  1904.  
  1905. /**** Print the bit map with a blue border **************************/
  1906.  
  1907. ok = VRMethod( "PRT_1", "PrintBitMap", bmp_name, 40, 20, 130, 110, 200, "Blue");
  1908.  
  1909.  
  1910. ΓòÉΓòÉΓòÉ 4.16. PrintBox ΓòÉΓòÉΓòÉ
  1911.  
  1912.  
  1913. ΓòÉΓòÉΓòÉ <hidden> PrintBox - List ΓòÉΓòÉΓòÉ
  1914.  
  1915. Topics 
  1916.  
  1917.      Description 
  1918.      Parameters 
  1919.  
  1920.  See Also 
  1921.  
  1922.      PrintBitMap 
  1923.      PrintObjectImage 
  1924.      PrintWinImage 
  1925.  
  1926.  
  1927. ΓòÉΓòÉΓòÉ <hidden> PrintBox - Description ΓòÉΓòÉΓòÉ
  1928.  
  1929. ok = VRMethod( object, "PrintBox",
  1930.                        lx, ly,
  1931.                        tx, ty,
  1932.                        th, st,
  1933.                        line_color,
  1934.                        fill_color);
  1935.  
  1936. Prints a box at the given coordinates and framed in the given line thickness 
  1937. and filled with the given style. 
  1938.  
  1939. Return 
  1940.  
  1941. TRUE (1) if successful else FALSE (0). 
  1942.  
  1943. Note:  The position of the cursor is unaffected by this method. 
  1944.  
  1945.  
  1946. ΓòÉΓòÉΓòÉ <hidden> PrintBox - Parameters ΓòÉΓòÉΓòÉ
  1947.  
  1948.  lx                  Lower left X coordinate taken from the left margin in 
  1949.                      millimetres or 1/10 inch depending on the Measures 
  1950.                      property 
  1951.  ly                  Lower left Y coordinate taken from the bottom margin in 
  1952.                      millimetres or 1/10 inch depending on the Measures 
  1953.                      property 
  1954.  tx                  Upper right X coordinate taken from the left margin in 
  1955.                      millimetres or 1/10 inch depending on the Measures 
  1956.                      property 
  1957.  ty                  Upper right Y coordinate taken from the bottom margin in 
  1958.                      millimetres or 1/10 inch depending on the Measures 
  1959.                      property 
  1960.  th                  Thickness of the box line in TWIPS ( 56.7 TWIPS = 1mm) 
  1961.  st                  Style used for filling the box (see Fill Syles) 
  1962.  line_color          The colour of the line around the box. One of the colour 
  1963.                      strings defined by VX-REXX 
  1964.  fill_color          The colour used for the foregound of the fill pattern. One 
  1965.                      of the colour strings defined by VX-REXX 
  1966.  
  1967.  
  1968. ΓòÉΓòÉΓòÉ 4.17. PrintCentered ΓòÉΓòÉΓòÉ
  1969.  
  1970.  
  1971. ΓòÉΓòÉΓòÉ <hidden> PrintCentered - List ΓòÉΓòÉΓòÉ
  1972.  
  1973. Topics 
  1974.  
  1975.      Description 
  1976.      Parameters 
  1977.      Example 
  1978.  
  1979.  See Also 
  1980.  
  1981.      PrintJustified 
  1982.      PrintRight 
  1983.      PrintLeft 
  1984.      PrintLine 
  1985.      FontDialog 
  1986.  
  1987.  
  1988. ΓòÉΓòÉΓòÉ <hidden> PrintCentered - Description ΓòÉΓòÉΓòÉ
  1989.  
  1990. ok = VRMethod( object, "PrintCentered",
  1991.                        face_name,
  1992.                        points,
  1993.                        string);
  1994.  
  1995. Prints the given text in the given font and point size centred between the 
  1996. declared margins of the page. All the parameters must be present. 
  1997.  
  1998. The text will be wrapped over several lines if it is too long to fit on one 
  1999. line and the cursor is placed at the beginning of the next line at the end of 
  2000. the printing. 
  2001.  
  2002. Return 
  2003.  
  2004. TRUE (1) if successful else FALSE (0). 
  2005.  
  2006.  
  2007. ΓòÉΓòÉΓòÉ <hidden> PrintCentered - Parameters ΓòÉΓòÉΓòÉ
  2008.  
  2009.  face_name           Name of the font used to print. This MUST be an outline 
  2010.                      font. If this is left empty, the previous font is used. 
  2011.  points              Point size of the font, If this is left empty, the 
  2012.                      previous font size is used. 
  2013.  string              The string to be printed. 
  2014.  
  2015.  
  2016. ΓòÉΓòÉΓòÉ <hidden> PrintCentered - Examples ΓòÉΓòÉΓòÉ
  2017.  
  2018. /********************************************************************/
  2019. /* Print a text centred on the page (or in a cell) in Helvetica 10  */
  2020. /********************************************************************/
  2021.  
  2022. ok = VRMethod( "PRT_1", "PrintCentered", "Helvetica", 10, "whatever you want to print");
  2023.  
  2024. /**** The following text will have the same font and size ***********/
  2025.  
  2026. ok = VRMethod( "PRT_1", "PrintCentered",,,"Here is some more");
  2027.  
  2028.  
  2029. ΓòÉΓòÉΓòÉ 4.18. PrinterDialog ΓòÉΓòÉΓòÉ
  2030.  
  2031.  
  2032. ΓòÉΓòÉΓòÉ <hidden> PrinterDialog - List ΓòÉΓòÉΓòÉ
  2033.  
  2034. Topics 
  2035.  
  2036.      Description 
  2037.      Parameters 
  2038.  
  2039.  See Also 
  2040.  
  2041.      JobProperties 
  2042.      PrinterList 
  2043.      OpenPrintJob 
  2044.      SetPrinter 
  2045.  
  2046.  
  2047. ΓòÉΓòÉΓòÉ <hidden> PrinterDialog - Description ΓòÉΓòÉΓòÉ
  2048.  
  2049. ok = VRMethod( object, "PrinterDialog",
  2050.                        title,
  2051.                        "Buttons.");
  2052.  
  2053. Pops up a dialog with a list of printers available on your work station. You 
  2054. can set the current printer by either double-clicking on a printer or by 
  2055. selecting an item and clicking on the OK button. 
  2056.  
  2057. Initially the default printer will be highlighted. 
  2058.  
  2059. You can set the properties to use for any of the printers in the list with 
  2060. Properties button. These properties will be valid until you next call the 
  2061. Dialog. 
  2062.  
  2063. Return 
  2064.  
  2065. Name of the printer that was selected or an empty string if the Cancel button 
  2066. was pressed. 
  2067.  
  2068. Warning: If you change the button texts, take care that the text will fit on 
  2069. the button as the buttons are not resized to the text. ALL BUTTON TEXTS ARE 
  2070. LIMITED TO 32 CHARACTERS 
  2071.  
  2072. Figure: Printer Dialog. 
  2073.  
  2074.  
  2075. ΓòÉΓòÉΓòÉ <hidden> PrinterDialog - Parameters ΓòÉΓòÉΓòÉ
  2076.  
  2077.  title               Title to appear in the printers dialog. 
  2078.  Buttons.            Stem variable containing the texts for the buttons in the 
  2079.                      dialog. 
  2080.                      Buttons.0           Must be 3 
  2081.                      Buttons.1           New text for the OK button in the 
  2082.                                          dialog. 
  2083.                      Buttons.2           New text for the Job properties... 
  2084.                                          button in the dialog. 
  2085.                      Buttons.3           New text for the Cancel button in the 
  2086.                                          dialog. 
  2087.  
  2088.  
  2089. ΓòÉΓòÉΓòÉ 4.19. PrinterList ΓòÉΓòÉΓòÉ
  2090.  
  2091.  
  2092. ΓòÉΓòÉΓòÉ <hidden> PrinterList - List ΓòÉΓòÉΓòÉ
  2093.  
  2094. Topics 
  2095.  
  2096.      Description 
  2097.      Parameters 
  2098.      Example 
  2099.  
  2100.  See Also 
  2101.  
  2102.      PrinterDialog 
  2103.      SetPrinter 
  2104.  
  2105.  
  2106. ΓòÉΓòÉΓòÉ <hidden> PrinterList - Description ΓòÉΓòÉΓòÉ
  2107.  
  2108. ok = VRMethod( object, "PrinterList",
  2109.                        "printers.");
  2110.  
  2111. This method returns a list of printer names that you can use to create your own 
  2112. printer selection dialog. You can set the selected printer with a call to 
  2113. SetPrinter using the index of the printer name. 
  2114.  
  2115. Return 
  2116.  
  2117. TRUE (1) if successful else FALSE (0). 
  2118.  
  2119.  
  2120. ΓòÉΓòÉΓòÉ <hidden> PrinterList - Parameters ΓòÉΓòÉΓòÉ
  2121.  
  2122.  "printers."         Quoted name of a stem variable to contain the list of 
  2123.                      available printers. 
  2124.                      printers.0 will contain the number of printers in the 
  2125.                      list. 
  2126.  
  2127.  
  2128. ΓòÉΓòÉΓòÉ <hidden> PrinterList - Example ΓòÉΓòÉΓòÉ
  2129.  
  2130. /****************************************************************/
  2131. /* Get the list of printers into a stem variable                */
  2132. /****************************************************************/
  2133.  
  2134. ok = VRMethod( "PRT_1", "PrinterList", "printers.");
  2135.  
  2136.  
  2137. ΓòÉΓòÉΓòÉ 4.20. PrintFile ΓòÉΓòÉΓòÉ
  2138.  
  2139.  
  2140. ΓòÉΓòÉΓòÉ <hidden> PrintFile - List ΓòÉΓòÉΓòÉ
  2141.  
  2142. Topics 
  2143.  
  2144.      Description 
  2145.      Parameters 
  2146.  
  2147.  See Also 
  2148.  
  2149.      OpenPrintJob 
  2150.      ClosePrintJob 
  2151.      PrintBitMap 
  2152.  
  2153.  
  2154. ΓòÉΓòÉΓòÉ <hidden> PrintFile - Description ΓòÉΓòÉΓòÉ
  2155.  
  2156. ok = VRMethod( object, "PrintFile",
  2157.                        face_name,
  2158.                        points,
  2159.                        style,
  2160.                        file_name);
  2161.  
  2162. Prints the given file in the given font, point size and style. All the 
  2163. parameters must be present. 
  2164.  
  2165. A print job must have been opened prior to calling this method. 
  2166.  
  2167. Return 
  2168.  
  2169. TRUE (1) if successful else FALSE (0). 
  2170.  
  2171. Warning: Only print plain text files with this method. printing any other kind 
  2172. of file could produce unexpected results. 
  2173.  
  2174.  
  2175. ΓòÉΓòÉΓòÉ <hidden> PrintFile - Parameters ΓòÉΓòÉΓòÉ
  2176.  
  2177.  face_name           Name of the font used to print. This MUST be an outline 
  2178.                      font. If this is left empty, the previous font is used. 
  2179.  points              Point size of the font, If this is left empty, the 
  2180.                      previous font size is used. 
  2181.  style               The style to print in: 
  2182.                      "L" or empty = Left aligned 
  2183.                      "R" = Right aligned "C" = Centred "J" = Justified 
  2184.  file_name           fully qualified name of the file to print. 
  2185.  
  2186.  
  2187. ΓòÉΓòÉΓòÉ 4.21. PrintJustified ΓòÉΓòÉΓòÉ
  2188.  
  2189.  
  2190. ΓòÉΓòÉΓòÉ <hidden> PrintJustified - List ΓòÉΓòÉΓòÉ
  2191.  
  2192. Topics 
  2193.  
  2194.      Description 
  2195.      Parameters 
  2196.      Example 
  2197.  
  2198.  See Also 
  2199.  
  2200.      PrintCentered 
  2201.      PrintRight 
  2202.      PrintLeft 
  2203.      PrintLine 
  2204.      FontDialog 
  2205.  
  2206.  
  2207. ΓòÉΓòÉΓòÉ <hidden> PrintJustified - Description ΓòÉΓòÉΓòÉ
  2208.  
  2209. ok = VRMethod( object, "PrintJustified",
  2210.                        face_name,
  2211.                        points,
  2212.                        string);
  2213.  
  2214. Prints the given text in the given font and point size justified between the 
  2215. declared margins of the page. All the parameters must be present. 
  2216.  
  2217. The text will be wrapped over several lines if it is too long to fit on one 
  2218. line and the cursor is placed at the beginning of the next line at the end of 
  2219. the printing. 
  2220.  
  2221. Return 
  2222.  
  2223. TRUE (1) if successful else FALSE (0). 
  2224.  
  2225.  
  2226. ΓòÉΓòÉΓòÉ <hidden> PrintJustified - Parameters ΓòÉΓòÉΓòÉ
  2227.  
  2228.  face_name           Name of the font used to print. This MUST be an outline 
  2229.                      font. If this is left empty, the previous font is used. 
  2230.  points              Point size of the font, If this is left empty, the 
  2231.                      previous font size is used. 
  2232.  string              The string to be printed. 
  2233.  
  2234.  
  2235. ΓòÉΓòÉΓòÉ <hidden> PrintJustified - Example ΓòÉΓòÉΓòÉ
  2236.  
  2237. /********************************************************************/
  2238. /* Print a text justified on the page (or in a cell) in Helv 10     */
  2239. /********************************************************************/
  2240.  
  2241. ok = VRMethod( "PRT_1", "PrintJustified", "Helvetica", 10, "whatever you want to print");
  2242.  
  2243. /**** The following text will have the same font and size ***********/
  2244.  
  2245. ok = VRMethod( "PRT_1", "PrintJustified",,,"Here is some more");
  2246.  
  2247.  
  2248. ΓòÉΓòÉΓòÉ 4.22. PrintLeft ΓòÉΓòÉΓòÉ
  2249.  
  2250.  
  2251. ΓòÉΓòÉΓòÉ <hidden> PrintLeft - List ΓòÉΓòÉΓòÉ
  2252.  
  2253. Topics 
  2254.  
  2255.      Description 
  2256.      Parameters 
  2257.      Example 
  2258.  
  2259.  See Also 
  2260.  
  2261.      PrintCentered 
  2262.      PrintJustified 
  2263.      PrintRight 
  2264.      PrintLine 
  2265.      FontDialog 
  2266.  
  2267.  
  2268. ΓòÉΓòÉΓòÉ <hidden> PrintLeft - Description ΓòÉΓòÉΓòÉ
  2269.  
  2270. ok = VRMethod( object, "PrintLeft",
  2271.                        face_name,
  2272.                        points,
  2273.                        string);
  2274.  
  2275. Prints the given text in the given font and point size. All the parameters must 
  2276. be present. 
  2277.  
  2278. The text will be wrapped over several lines if it is too long to fit on one 
  2279. line and the cursor is placed at the end of the text at the end of the 
  2280. printing. 
  2281.  
  2282. Return 
  2283.  
  2284. TRUE (1) if successful else FALSE (0). 
  2285.  
  2286. Note: 
  2287. Remember to add a space at the end of a string if you call this method several 
  2288. times, otherwise the texts will be "stuck" together. 
  2289.  
  2290.  
  2291. ΓòÉΓòÉΓòÉ <hidden> PrintLeft - Parameters ΓòÉΓòÉΓòÉ
  2292.  
  2293.  face_name           Name of the font used to print. This MUST be an outline 
  2294.                      font. If this is left empty, the previous font is used. 
  2295.  points              Point size of the font, If this is left empty, the 
  2296.                      previous font size is used. 
  2297.  string              The string to be printed. 
  2298.  
  2299.  
  2300. ΓòÉΓòÉΓòÉ <hidden> PrintLeft - Example ΓòÉΓòÉΓòÉ
  2301.  
  2302. /********************************************************************/
  2303. /* Print a text on the page (or in a cell) in Helvetica 10          */
  2304. /********************************************************************/
  2305.  
  2306. ok = VRMethod( "PRT_1", "PrintLeft", 'Helvetica', 10, 'whatever you want to print. ');
  2307.  
  2308. /**** The following text will have the same font and size ***********/
  2309.  
  2310. ok = VRMethod( "PRT_1", "PrintLeft",,,'Here is some more');
  2311.  
  2312.  
  2313. ΓòÉΓòÉΓòÉ 4.23. PrintLine ΓòÉΓòÉΓòÉ
  2314.  
  2315.  
  2316. ΓòÉΓòÉΓòÉ <hidden> PrintLine - List ΓòÉΓòÉΓòÉ
  2317.  
  2318. Topics 
  2319.  
  2320.      Description 
  2321.      Parameters 
  2322.      Example 
  2323.  
  2324.  See Also 
  2325.  
  2326.      PrintCentered 
  2327.      PrintJustified 
  2328.      PrintRight 
  2329.      PrintLeft 
  2330.      FontDialog 
  2331.  
  2332.  
  2333. ΓòÉΓòÉΓòÉ <hidden> PrintLine - Description ΓòÉΓòÉΓòÉ
  2334.  
  2335. ok = VRMethod( object, "PrintLine",
  2336.                        face_name,
  2337.                        points,
  2338.                        string);
  2339.  
  2340. Prints the given text in the given font and point size aligned on the left 
  2341. margin of the page. All the parameters must be present. 
  2342.  
  2343. The text will be wrapped over several lines if it is too long to fit on one 
  2344. line and the cursor is placed at the beginning of the next line at the end of 
  2345. the printing. 
  2346.  
  2347. Return 
  2348.  
  2349. TRUE (1) if successful else FALSE (0). 
  2350.  
  2351.  
  2352. ΓòÉΓòÉΓòÉ <hidden> PrintLine - Parameters ΓòÉΓòÉΓòÉ
  2353.  
  2354.  face_name           Name of the font used to print. This MUST be an outline 
  2355.                      font. If this is left empty, the previous font is used. 
  2356.  points              Point size of the font, If this is left empty, the 
  2357.                      previous font size is used. 
  2358.  string              The string to be printed. 
  2359.  
  2360.  
  2361. ΓòÉΓòÉΓòÉ <hidden> PrintLine - Example ΓòÉΓòÉΓòÉ
  2362.  
  2363. /********************************************************************/
  2364. /* Print a text on the page (or in a cell) in Helvetica 10          */
  2365. /********************************************************************/
  2366.  
  2367. ok = VRMethod( "PRT_1", "PrintLine", 'Helvetica', 10, 'whatever you want to print');
  2368.  
  2369. /**** The following text will have the same font and size ***********/
  2370.  
  2371. ok = VRMethod( "PRT_1", "PrintLine",,,'Here is some more');
  2372.  
  2373.  
  2374. ΓòÉΓòÉΓòÉ 4.24. PrintObjectImage ΓòÉΓòÉΓòÉ
  2375.  
  2376.  
  2377. ΓòÉΓòÉΓòÉ <hidden> PrintObjectImage - List ΓòÉΓòÉΓòÉ
  2378.  
  2379. Topics 
  2380.  
  2381.      Description 
  2382.      Parameters 
  2383.  
  2384.  See Also 
  2385.  
  2386.      PrintBitMap 
  2387.      PrintBox 
  2388.      PrintWinImage 
  2389.  
  2390.  
  2391. ΓòÉΓòÉΓòÉ <hidden> PrintObjectImage - Description ΓòÉΓòÉΓòÉ
  2392.  
  2393. ok = VRMethod( prt, "PrintObjectImage",
  2394.                     object,
  2395.                     lx, ly,
  2396.                     tx, ty,
  2397.                     th,
  2398.                     border_color);
  2399.  
  2400. Prints an image of the object. If you pass the name of a window the client area 
  2401. will be printed without any frame controls. 
  2402.  
  2403. Return 
  2404.  
  2405. TRUE (1) if successful else FALSE (0). 
  2406.  
  2407.  
  2408. ΓòÉΓòÉΓòÉ <hidden> PrintObjectImage - Parameters ΓòÉΓòÉΓòÉ
  2409.  
  2410.  object              Name of the VX-REXX visible object to print e.g. "Window1" 
  2411.  lx                  Lower left X coordinate taken from the left margin in 
  2412.                      millimetres or 1/10 inch depending on the Measures 
  2413.                      property 
  2414.  ly                  Lower left Y coordinate taken from the bottom margin in 
  2415.                      millimetres or 1/10 inch depending on the Measures 
  2416.                      property 
  2417.  tx                  Upper right X coordinate taken from the left margin in 
  2418.                      millimetres or 1/10 inch depending on the Measures 
  2419.                      property. if this parameter is left out the image will be 
  2420.                      printed with the same width as the object on the screen. 
  2421.  ty                  Upper right Y coordinate taken from the bottom margin in 
  2422.                      millimetres or 1/10 inch depending on the Measures 
  2423.                      property. if this parameter is left out the image will be 
  2424.                      printed with the same height as the object on the screen. 
  2425.  th                  Thickness of the box line in TWIPS ( 56.7 TWIPS = 1mm) 
  2426.  border_color        The colour of the line around the image. One of the colour 
  2427.                      strings defined by VX-REXX 
  2428.  
  2429.  
  2430. ΓòÉΓòÉΓòÉ 4.25. PrintRight ΓòÉΓòÉΓòÉ
  2431.  
  2432.  
  2433. ΓòÉΓòÉΓòÉ <hidden> PrintRight - List ΓòÉΓòÉΓòÉ
  2434.  
  2435. Topics 
  2436.  
  2437.      Description 
  2438.      Parameters 
  2439.      Example 
  2440.  
  2441.  See Also 
  2442.  
  2443.      PrintCentered 
  2444.      PrintJustified 
  2445.      PrintLeft 
  2446.      PrintLine 
  2447.      FontDialog 
  2448.     
  2449.  
  2450.  
  2451. ΓòÉΓòÉΓòÉ <hidden> PrintRight - Description ΓòÉΓòÉΓòÉ
  2452.  
  2453. ok = VRMethod( object, "PrintRight",
  2454.                        face_name,
  2455.                        points,
  2456.                        string);
  2457.  
  2458. Prints the given text in the given font and point size right justified with 
  2459. relation to the right margin of the page. All the parameters must be present. 
  2460.  
  2461. The text will be wrapped over several lines if it is too long to fit on one 
  2462. line and the cursor is placed at the beginning of the next line at the end of 
  2463. the printing. 
  2464.  
  2465. Return 
  2466.  
  2467. TRUE (1) if successful else FALSE (0). 
  2468.  
  2469.  
  2470. ΓòÉΓòÉΓòÉ <hidden> PrintRight - Parameters ΓòÉΓòÉΓòÉ
  2471.  
  2472.  face_name           Name of the font used to print. This MUST be an outline 
  2473.                      font. If this is left empty, the previous font is used. 
  2474.  points              Point size of the font, If this is left empty, the 
  2475.                      previous font size is used. 
  2476.  string              The string to be printed. 
  2477.  
  2478.  
  2479. ΓòÉΓòÉΓòÉ <hidden> PrintRight - Example ΓòÉΓòÉΓòÉ
  2480.  
  2481. /********************************************************************/
  2482. /* Print a text right aligned on the page (or in a cell)            */
  2483. /********************************************************************/
  2484.  
  2485. ok = VRMethod( "PRT_1", "PrintRight", 'Helvetica', 10, 'whatever you want to print');
  2486.  
  2487. /**** The following text will have the same font and size ***********/
  2488.  
  2489. ok = VRMethod( "PRT_1", "PrintRight",,,'Here is some more');
  2490.  
  2491.  
  2492. ΓòÉΓòÉΓòÉ 4.26. PrintWinImage ΓòÉΓòÉΓòÉ
  2493.  
  2494.  
  2495. ΓòÉΓòÉΓòÉ <hidden> PrintWinImage - List ΓòÉΓòÉΓòÉ
  2496.  
  2497. Topics 
  2498.  
  2499.      Description 
  2500.      Parameters 
  2501.  
  2502.  See Also 
  2503.  
  2504.      PrintBitMap 
  2505.      PrintBox 
  2506.      PrintObjectImage 
  2507.  
  2508.  
  2509. ΓòÉΓòÉΓòÉ <hidden> PrintWinImage - Description ΓòÉΓòÉΓòÉ
  2510.  
  2511. ok = VRMethod( prt, "PrintWinImage",
  2512.                     hwnd,
  2513.                     lx, ly,
  2514.                     tx, ty,
  2515.                     th,
  2516.                     border_color);
  2517.  
  2518. Prints an image of the contents of a window. 
  2519.  
  2520. Return 
  2521.  
  2522. TRUE (1) if successful else FALSE (0). 
  2523.  
  2524.  
  2525. ΓòÉΓòÉΓòÉ <hidden> PrintWinImage - Parameters ΓòÉΓòÉΓòÉ
  2526.  
  2527.  hwnd                Handle of the window whose contents you want to print. 
  2528.                      This should be in the form ?HWNDxxxxx as returned by 
  2529.                      VX-REXX "screen" methods etc.. 
  2530.  lx                  Lower left X coordinate taken from the left margin in 
  2531.                      millimetres or 1/10 inch depending on the Measures 
  2532.                      property 
  2533.  ly                  Lower left Y coordinate taken from the bottom margin in 
  2534.                      millimetres or 1/10 inch depending on the Measures 
  2535.                      property 
  2536.  tx                  Upper right X coordinate taken from the left margin in 
  2537.                      millimetres or 1/10 inch depending on the Measures 
  2538.                      property. if this parameter is left out the image will be 
  2539.                      printed with the same width as the object on the screen. 
  2540.  ty                  Upper right Y coordinate taken from the bottom margin in 
  2541.                      millimetres or 1/10 inch depending on the Measures 
  2542.                      property. if this parameter is left out the image will be 
  2543.                      printed with the same height as the object on the screen. 
  2544.  th                  Thickness of the box line in TWIPS ( 56.7 TWIPS = 1mm) 
  2545.  border_color        The colour of the line around the image. One of the colour 
  2546.                      strings defined by VX-REXX 
  2547.  
  2548.  
  2549. ΓòÉΓòÉΓòÉ 4.27. ResetColHeader ΓòÉΓòÉΓòÉ
  2550.  
  2551.  
  2552. ΓòÉΓòÉΓòÉ <hidden> ResetColHeader - List ΓòÉΓòÉΓòÉ
  2553.  
  2554. Topics 
  2555.  
  2556.      Description 
  2557.      Parameters 
  2558.  
  2559.  See Also 
  2560.  
  2561.      DefineTable 
  2562.  
  2563.  
  2564. ΓòÉΓòÉΓòÉ <hidden> ResetColHeader - Description ΓòÉΓòÉΓòÉ
  2565.  
  2566. ok = VRMethod( object, "ResetColHeader",
  2567.                        col_num,
  2568.                        text);
  2569.  
  2570. Changes the text in the table header for the given column. 
  2571.  
  2572. Return 
  2573.  
  2574. TRUE (1) if successful else FALSE (0). 
  2575.  
  2576.  
  2577. ΓòÉΓòÉΓòÉ <hidden> ResetColHeader - Parameters ΓòÉΓòÉΓòÉ
  2578.  
  2579.  col_num             Number of the column (1..n) whose header text you want to 
  2580.                      change 
  2581.  text                New header text for the column 
  2582.  
  2583.  
  2584. ΓòÉΓòÉΓòÉ 4.28. ResetHeader ΓòÉΓòÉΓòÉ
  2585.  
  2586.  
  2587. ΓòÉΓòÉΓòÉ <hidden> ResetHeader - List ΓòÉΓòÉΓòÉ
  2588.  
  2589. Topics 
  2590.  
  2591.      Description 
  2592.      Parameters 
  2593.  
  2594.  See Also 
  2595.  
  2596.      SetHeader 
  2597.      SetHeaderMode 
  2598.      SetHeaderLineFont 
  2599.      SetFooter 
  2600.  
  2601.  
  2602. ΓòÉΓòÉΓòÉ <hidden> ResetHeader - Description ΓòÉΓòÉΓòÉ
  2603.  
  2604. ok = VRMethod( object, "ResetHeader",
  2605.                        numlines,
  2606.                        text
  2607.                        [, text]);
  2608.  
  2609. Redefines the text lines for the header printed on each page of document. The 
  2610. text variable can contain Formatting Flags. 
  2611.  
  2612. If you declare less lines than were originally defined for the header, the 
  2613. extra lines will be destroyed and cannot be re-used. 
  2614.  
  2615. Return 
  2616.  
  2617. TRUE (1) if successful else FALSE (0). 
  2618.  
  2619. Warning: You should only call this method after opening a print job to modify 
  2620. the header for the following pages 
  2621.  
  2622.  
  2623. ΓòÉΓòÉΓòÉ <hidden> ResetHeader - Parameters ΓòÉΓòÉΓòÉ
  2624.  
  2625.  numlines            The number of lines in the header ( 1 to 5) 
  2626.  text                The text to printed on the line. there should be numlines 
  2627.                      text variables. An empty variable will leave the original 
  2628.                      header text for that line. 
  2629.  
  2630.  
  2631. ΓòÉΓòÉΓòÉ 4.29. SetFooter ΓòÉΓòÉΓòÉ
  2632.  
  2633.  
  2634. ΓòÉΓòÉΓòÉ <hidden> SetFooter - List ΓòÉΓòÉΓòÉ
  2635.  
  2636. Topics 
  2637.  
  2638.      Description 
  2639.      Parameters 
  2640.      Example 
  2641.  
  2642.  See Also 
  2643.  
  2644.      SetHeader 
  2645.      SetHeaderMode 
  2646.      FontDialog 
  2647.  
  2648.  
  2649. ΓòÉΓòÉΓòÉ <hidden> SetFooter - Description ΓòÉΓòÉΓòÉ
  2650.  
  2651. ok = VRMethod( object, "SetFooter",
  2652.                        facename,
  2653.                        points,
  2654.                        fill,
  2655.                        line,
  2656.                        text,
  2657.                        line_color,
  2658.                        fill_color,
  2659.                        text_color);
  2660.  
  2661. Defines the footer printed on each page of document. The text variable can 
  2662. contain Formatting Flags.  If you don't define any colours, the default colour 
  2663. will be used. 
  2664.  
  2665. Return 
  2666.  
  2667. TRUE (1) if successful else FALSE (0). 
  2668.  
  2669.  
  2670. ΓòÉΓòÉΓòÉ <hidden> SetFooter - Parameters ΓòÉΓòÉΓòÉ
  2671.  
  2672.  facename            name of the font used in printing the footer text 
  2673.  points              Point size for the font 
  2674.  fill                Fill style for the footer area (see Fill Syles) 
  2675.  line                Line thickness for a box surrounding the footer 
  2676.  text                Text to be printed in the footer 
  2677.  line_color          The colour of the line around the header. One of the 
  2678.                      colour strings defined by VX-REXX 
  2679.  fill_color          The colour used for the foregound of the fill pattern. One 
  2680.                      of the colour strings defined by VX-REXX 
  2681.  text_color          The colour for printing the text. One of the colour 
  2682.                      strings defined by VX-REXX 
  2683.  
  2684.  
  2685. ΓòÉΓòÉΓòÉ <hidden> SetFooter - Example ΓòÉΓòÉΓòÉ
  2686.  
  2687. /****************************************************************/
  2688. /* Set the footer with the page number right justified and the  */
  2689. /* document title left aligned with an unfilled blue box around */
  2690. /* it and with black text.                                      */
  2691. /****************************************************************/
  2692.  
  2693. ok = VRMethod( "PRT_1", "SetFooter", 'Helvetica', 8, 0, 14, '$|$rpage $#', "Blue", , "Black");
  2694.  
  2695.  
  2696. ΓòÉΓòÉΓòÉ 4.30. SetHeader ΓòÉΓòÉΓòÉ
  2697.  
  2698.  
  2699. ΓòÉΓòÉΓòÉ <hidden> SetHeader - List ΓòÉΓòÉΓòÉ
  2700.  
  2701. Topics 
  2702.  
  2703.      Description 
  2704.      Parameters 
  2705.      Example 
  2706.  
  2707.  See Also 
  2708.  
  2709.      SetHeaderMode 
  2710.      ResetHeader 
  2711.      SetHeaderLineFont 
  2712.      SetFooter 
  2713.  
  2714.  
  2715. ΓòÉΓòÉΓòÉ <hidden> SetHeader - Description ΓòÉΓòÉΓòÉ
  2716.  
  2717. ok = VRMethod( object, "SetHeader",
  2718.                        numlines,
  2719.                        text
  2720.                        [, text]);
  2721.  
  2722. Defines the text lines for the header printed on each page of document. The 
  2723. text variable can contain Formatting Flags. 
  2724.  
  2725. Return 
  2726.  
  2727. TRUE (1) if successful else FALSE (0). FALSE is also returned if there has been 
  2728. no previous call to SetHeaderMode. 
  2729.  
  2730. Warning: You MUST make a call to the SetHeaderMode method before calling this 
  2731. method 
  2732.  
  2733.  
  2734. ΓòÉΓòÉΓòÉ <hidden> SetHeader - Parameters ΓòÉΓòÉΓòÉ
  2735.  
  2736.  numlines            The number of lines in the header ( 1 to 5) 
  2737.  text                The text to printed on the line. there should be numlines 
  2738.                      text variables 
  2739.  
  2740.  
  2741. ΓòÉΓòÉΓòÉ <hidden> SetHeader - Example ΓòÉΓòÉΓòÉ
  2742.  
  2743. /****************************************************************/
  2744. /* Set the header with the doc title on the first line centred, */
  2745. /* the date on the second line right justified and some other   */
  2746. /* text. There are 3 lines in the header.                       */
  2747. /****************************************************************/
  2748.  
  2749. ok = VRMethod( "PRT_1", "SetHeader", 3, ,
  2750.                        "$c|",,
  2751.                        "$lADD Consulting (CH)$r@",,
  2752.                        'Demo for VRPrinter Object for VX-REXX');
  2753.  
  2754.  
  2755. ΓòÉΓòÉΓòÉ 4.31. SetHeaderLineFont ΓòÉΓòÉΓòÉ
  2756.  
  2757.  
  2758. ΓòÉΓòÉΓòÉ <hidden> SetHeaderLineFont - List ΓòÉΓòÉΓòÉ
  2759.  
  2760. Topics 
  2761.  
  2762.      Description 
  2763.      Parameters 
  2764.      Example 
  2765.  
  2766.  See Also 
  2767.  
  2768.      SetHeaderMode 
  2769.      SetHeader 
  2770.  
  2771.  
  2772. ΓòÉΓòÉΓòÉ <hidden> SetHeaderLineFont - Description ΓòÉΓòÉΓòÉ
  2773.  
  2774. ok = VRMethod( object, "SetHeaderLineFont",
  2775.                        linenum,
  2776.                        font,
  2777.                        points);
  2778.  
  2779. Sets the font for one line in the header to a different size or font from that 
  2780. defined in SetHeaderMode. 
  2781.  
  2782. Return 
  2783.  
  2784. TRUE (1) if successful else FALSE (0). FALSE is also returned if there has been 
  2785. no previous call to SetHeaderMode and SetHeader. 
  2786.  
  2787. Warning: You MUST make a call to the SetHeaderMode and SetHeader methods before 
  2788. calling this method 
  2789.  
  2790.  
  2791. ΓòÉΓòÉΓòÉ <hidden> SetHeaderLineFont - Parameters ΓòÉΓòÉΓòÉ
  2792.  
  2793.  linenum             The line number in the header whose font is to be set 
  2794.  font                The font to use for printing the line 
  2795.  points              The point size to be used for printing 
  2796.  
  2797.  
  2798. ΓòÉΓòÉΓòÉ <hidden> SetHeaderLineFont - Example ΓòÉΓòÉΓòÉ
  2799.  
  2800.  
  2801. /****************************************************************/
  2802. /* Print the header on all the pages with default 10 pt         */
  2803. /* Helvetica bold, a .05mm line around and halftone fill.       */
  2804. /****************************************************************/
  2805.  
  2806. ok = VRMethod( "PRT_1", "SetHeaderMode", 1, 'Helvetica Bold', 10, 8, 28, 1);
  2807.  
  2808. /****************************************************************/
  2809. /* Set the header with the doc title on the first line centred, */
  2810. /* the date on the second line right justified and some other   */
  2811. /* text. There are 3 lines in the header.                       */
  2812. /****************************************************************/
  2813.  
  2814. ok = VRMethod( "PRT_1", "SetHeader", 3, ,
  2815.                        "$c|",,
  2816.                        "$lADD Consulting (CH)$r@",,
  2817.                        'Demo for VRPrinter Object for VX-REXX');
  2818.  
  2819. /****************************************************************/
  2820. /* Change the point size for the first line.                    */
  2821. /****************************************************************/
  2822.  
  2823. ok = VRMethod( "PRT_1", "SetHeaderLineFont", 1, , 12);
  2824.  
  2825. /****************************************************************/
  2826. /* Change the font and point size for the third line.           */
  2827. /****************************************************************/
  2828.  
  2829. ok = VRMethod( "PRT_1", "SetHeaderLineFont", 3, "Helvetica", 8);
  2830.  
  2831.  
  2832. ΓòÉΓòÉΓòÉ 4.32. SetHeaderMode ΓòÉΓòÉΓòÉ
  2833.  
  2834.  
  2835. ΓòÉΓòÉΓòÉ <hidden> SetHeaderMode - List ΓòÉΓòÉΓòÉ
  2836.  
  2837. Topics 
  2838.  
  2839.      Description 
  2840.      Parameters 
  2841.      Example 
  2842.  
  2843.  See Also 
  2844.  
  2845.      SetFooter 
  2846.      SetHeader 
  2847.      SetHeaderLineFont 
  2848.      FontDialog 
  2849.  
  2850.  
  2851. ΓòÉΓòÉΓòÉ <hidden> SetHeaderMode - Description ΓòÉΓòÉΓòÉ
  2852.  
  2853. ok = VRMethod( object, "SetHeaderMode",
  2854.                        print,
  2855.                        facename,
  2856.                        points,
  2857.                        fill,
  2858.                        line,
  2859.                        all_pages,
  2860.                        line_color,
  2861.                        fill_color,
  2862.                        text_color);
  2863.  
  2864. Define the way the header is printed. Unless you specify different fonts for 
  2865. each line with SetHeaderLineFont, the text will be printed in the font and 
  2866. point size defined with this method. If you don't define any colours, the 
  2867. default colour will be used. 
  2868.  
  2869. Return 
  2870.  
  2871. TRUE (1) if successful else FALSE (0). 
  2872.  
  2873.  
  2874. ΓòÉΓòÉΓòÉ <hidden> SetHeaderMode - Parameters ΓòÉΓòÉΓòÉ
  2875.  
  2876.  print               0 = Never print the header 
  2877.                      1 = print the header 
  2878.  facename            name of the default font used in printing the header text. 
  2879.  points              Default point size for printing the header. 
  2880.  fill                Fill style for the header area (see Fill Syles) 
  2881.  line                Line thickness for a box surrounding the header 
  2882.  all_pages           0 = print header on first page only 
  2883.                      1 = print header on all the pages 
  2884.  line_color          The colour of the line around the header. One of the 
  2885.                      colour strings defined by VX-REXX 
  2886.  fill_color          The colour used for the foregound of the fill pattern. One 
  2887.                      of the colour strings defined by VX-REXX 
  2888.  text_color          The colour for printing the text. One of the colour 
  2889.                      strings defined by VX-REXX 
  2890.  
  2891.  
  2892. ΓòÉΓòÉΓòÉ <hidden> SetHeaderMode - Example ΓòÉΓòÉΓòÉ
  2893.  
  2894.  
  2895. /****************************************************************/
  2896. /* Print the header on all the pages in 10 pt Helvetica bold    */
  2897. /* with a .05mm blue line around and filled with cyan halftone. */
  2898. /****************************************************************/
  2899.  
  2900. ok = VRMethod( "PRT_1", "SetHeaderMode", 1, 'Helvetica Bold', 10, 8, 28, 1, "Blue", "Cyan");
  2901.  
  2902.  
  2903. ΓòÉΓòÉΓòÉ 4.33. SetMargins ΓòÉΓòÉΓòÉ
  2904.  
  2905.  
  2906. ΓòÉΓòÉΓòÉ <hidden> SetMargins - List ΓòÉΓòÉΓòÉ
  2907.  
  2908. Topics 
  2909.  
  2910.      Description 
  2911.      Parameters 
  2912.      Example 
  2913.  
  2914.  See Also 
  2915.  
  2916.      SetFooter 
  2917.      SetHeader 
  2918.      SetHeaderMode 
  2919.  
  2920.  
  2921. ΓòÉΓòÉΓòÉ <hidden> SetMargins - Description ΓòÉΓòÉΓòÉ
  2922.  
  2923. ok = VRMethod( object, "SetMargins",
  2924.                        lm, rm,
  2925.                        tm, bm,
  2926.                        pb, ps,
  2927.                        line_color,
  2928.                        fill_color);
  2929.  
  2930. Defines the printing margins for the job and whether the printing area has a 
  2931. border and a fill style. If you don't define any colours, the default colour 
  2932. will be used. 
  2933.  
  2934. The border, if defined, will be printed just outside the margins. 
  2935.  
  2936. Return 
  2937.  
  2938. TRUE (1) if successful else FALSE (0). 
  2939.  
  2940.  
  2941. ΓòÉΓòÉΓòÉ <hidden> SetMargins - Parameters ΓòÉΓòÉΓòÉ
  2942.  
  2943.  lm                  Left margin in millimetres or 1/10 inch depending on the 
  2944.                      Measures property from page edge 
  2945.  rm                  Right margin in millimetres or 1/10 inch depending on the 
  2946.                      Measures property from page edge 
  2947.  tm                  Top margin in millimeteres from page edge 
  2948.  bm                  Bottom margin in millimetres or 1/10 inch depending on the 
  2949.                      Measures property from page edge 
  2950.  pb                  Thickness of line making a border around the page 
  2951.  ps                  Fill style for the page (see Fill Syles) 
  2952.  line_color          The colour of the line around the header. One of the 
  2953.                      colour strings defined by VX-REXX 
  2954.  fill_color          The colour used for the foregound of the fill pattern. One 
  2955.                      of the colour strings defined by VX-REXX 
  2956.  
  2957.  
  2958. ΓòÉΓòÉΓòÉ <hidden> SetMargins - Example ΓòÉΓòÉΓòÉ
  2959.  
  2960. /****************************************************************/
  2961. /* Set the margins to left 25mm right 20mm top 20mm bottom 25mm */
  2962. /* and set the page to filled with green halftone with a black  */
  2963. /* 1mm border.                                                  */
  2964. /****************************************************************/
  2965.  
  2966. ok = VRMethod( "PRT_1", "SetMargins", 25, 20, 20, 25, 56, 8, "Black", "Green");
  2967.  
  2968.  
  2969. ΓòÉΓòÉΓòÉ 4.34. SetPrinter ΓòÉΓòÉΓòÉ
  2970.  
  2971.  
  2972. ΓòÉΓòÉΓòÉ <hidden> SetPrinter - List ΓòÉΓòÉΓòÉ
  2973.  
  2974. Topics 
  2975.  
  2976.      Description 
  2977.      Parameters 
  2978.  
  2979.  See Also 
  2980.  
  2981.      PrinterList 
  2982.      OpenPrintJob 
  2983.  
  2984.  
  2985. ΓòÉΓòÉΓòÉ <hidden> SetPrinter - Description ΓòÉΓòÉΓòÉ
  2986.  
  2987. ok = VRMethod( object, "SetPrinter",
  2988.                        idx);
  2989.  
  2990. For programs that do not use PrinterDialog, the printer MUST be set using this 
  2991. method if you do not want to use the default printer. The index refers to the 
  2992. position of the chosen printer name in the the stem variable returned by 
  2993. PrinterList and is 1 based. 
  2994.  
  2995. Return 
  2996.  
  2997. TRUE (1) if successful else FALSE (0). 
  2998.  
  2999.  
  3000. ΓòÉΓòÉΓòÉ <hidden> SetPrinter - Parameters ΓòÉΓòÉΓòÉ
  3001.  
  3002.  idx                 Index of the printer in the list returned by PrinterList 
  3003.                      If this variable is missing or set to 0, the default 
  3004.                      printer will be selected. 
  3005.  
  3006.  
  3007. ΓòÉΓòÉΓòÉ 4.35. SetProgressTexts ΓòÉΓòÉΓòÉ
  3008.  
  3009.  
  3010. ΓòÉΓòÉΓòÉ <hidden> SetProgressTexts - List ΓòÉΓòÉΓòÉ
  3011.  
  3012. Topics 
  3013.  
  3014.      Description 
  3015.      Parameters 
  3016.  
  3017.  See Also 
  3018.  
  3019.      ShowProgress 
  3020.  
  3021.  
  3022. ΓòÉΓòÉΓòÉ <hidden> SetProgressTexts - Description ΓòÉΓòÉΓòÉ
  3023.  
  3024. ok = VRMethod( object, "SetProgressTexts",
  3025.                        "texts.");
  3026.  
  3027. This method allows to customise the Progress dialog. Any of the input stem 
  3028. parameter fields may be left blank, in which case they assume the defaut 
  3029. values. 
  3030.  
  3031. Return 
  3032.  
  3033. TRUE (1) if successful else FALSE (0). 
  3034.  
  3035.  
  3036. ΓòÉΓòÉΓòÉ <hidden> SetProgressTexts - Parameters ΓòÉΓòÉΓòÉ
  3037.  
  3038.  texts.              Stem variable containing the new title and texts for the 
  3039.                      progress dialog. 
  3040.                      texts.0             Must be 5 
  3041.                      texts.1             New text for the title of the dialog. 
  3042.                                          By default this is: "Printing - 
  3043.                                          Progress". 
  3044.                      texts.2             New text for the 1st line in the 
  3045.                                          dialog. By default this is the 
  3046.                                          document name. 
  3047.                      texts.3             New text for the 2nd line in the 
  3048.                                          dialog. by default this test is: 
  3049.                                          "Printing page %u". If you replace 
  3050.                                          this text, you must include the %u 
  3051.                                          flag for the page number that is 
  3052.                                          printing. 
  3053.                      texts.4             New text for the 3rd line in the 
  3054.                                          dialog. By default this is the name of 
  3055.                                          the printer where he job is printing. 
  3056.                      texts.5             New text for the Abort button in the 
  3057.                                          dialog. 
  3058.  
  3059.  
  3060. ΓòÉΓòÉΓòÉ 4.36. StartCol ΓòÉΓòÉΓòÉ
  3061.  
  3062.  
  3063. ΓòÉΓòÉΓòÉ <hidden> StartCol - List ΓòÉΓòÉΓòÉ
  3064.  
  3065. Topics 
  3066.  
  3067.      Description 
  3068.      Parameters 
  3069.  
  3070.  See Also 
  3071.  
  3072.      DefineTable 
  3073.      StartTable 
  3074.      StartRow 
  3075.  
  3076.  
  3077. ΓòÉΓòÉΓòÉ <hidden> StartCol - Description ΓòÉΓòÉΓòÉ
  3078.  
  3079. ok = VRMethod( object, "StartCol",
  3080.                        column);
  3081.  
  3082. Instructs the program to direct all text printing calls to print within the 
  3083. borders set for the column. 
  3084.  
  3085. Columns are numbers start at 1. 
  3086.  
  3087. Return 
  3088.  
  3089. TRUE (1) if successful else FALSE (0). 
  3090.  
  3091. Note: 
  3092. A Table must have been previously declared. 
  3093.  
  3094.  
  3095. ΓòÉΓòÉΓòÉ <hidden> StartCol - Parameters ΓòÉΓòÉΓòÉ
  3096.  
  3097.  column              Number of the column to start printing. 
  3098.  
  3099.  
  3100. ΓòÉΓòÉΓòÉ 4.37. StartRow ΓòÉΓòÉΓòÉ
  3101.  
  3102.  
  3103. ΓòÉΓòÉΓòÉ <hidden> StartRow - List ΓòÉΓòÉΓòÉ
  3104.  
  3105. Topics 
  3106.  
  3107.      Description 
  3108.      Parameters 
  3109.  
  3110.  See Also 
  3111.  
  3112.      DefineTable 
  3113.      StartTable 
  3114.      StartCol 
  3115.      EndRow 
  3116.  
  3117.  
  3118. ΓòÉΓòÉΓòÉ <hidden> StartRow - Description ΓòÉΓòÉΓòÉ
  3119.  
  3120. ok = VRMethod( object, "StartRow");
  3121.  
  3122. Instructs the program that a new row in a table is to be started. All printing 
  3123. commands following this call will be directed into the last column that was 
  3124. declared. You MUST follow this call by a call to StartCol otherwise you may 
  3125. generate an Access Violation. 
  3126.  
  3127. Return 
  3128.  
  3129. TRUE (1) if successful else FALSE (0). 
  3130.  
  3131. Note: 
  3132. A table must have been previously declared. 
  3133.  
  3134.  
  3135. ΓòÉΓòÉΓòÉ <hidden> StartRow - Parameters ΓòÉΓòÉΓòÉ
  3136.  
  3137.  None 
  3138.  
  3139.  
  3140. ΓòÉΓòÉΓòÉ 4.38. StartTable ΓòÉΓòÉΓòÉ
  3141.  
  3142.  
  3143. ΓòÉΓòÉΓòÉ <hidden> StartTable - List ΓòÉΓòÉΓòÉ
  3144.  
  3145. Topics 
  3146.  
  3147.      Description 
  3148.      Parameters 
  3149.      Example 
  3150.  
  3151.  See Also 
  3152.  
  3153.      DefineTable 
  3154.      StartRow 
  3155.      StartCol 
  3156.      EndRow 
  3157.      EndTable 
  3158.      ResetColHeader 
  3159.  
  3160.  
  3161. ΓòÉΓòÉΓòÉ <hidden> StartTable - Description ΓòÉΓòÉΓòÉ
  3162.  
  3163. ok = VRMethod( object, "StartTable",
  3164.                        fill,
  3165.                        line,
  3166.                        numcols,
  3167.                        lm,
  3168.                        width
  3169.                        [, width]);
  3170.  
  3171. Defines a table for printing. If there are not the right number of lm, rm pairs 
  3172. the method will return FALSE. 
  3173.  
  3174. This call only prepares the internal structures for handling a table, to start 
  3175. printing the table you must call StartRow and StartCol. 
  3176.  
  3177. Return 
  3178.  
  3179. TRUE (1) if successful else FALSE (0). 
  3180.  
  3181.  
  3182. ΓòÉΓòÉΓòÉ <hidden> StartTable - Parameters ΓòÉΓòÉΓòÉ
  3183.  
  3184.  fill                Fill style used for the table. This applies to all the 
  3185.                      cells. 
  3186.  line                Thickness of the separator lines for the table in TWIPS 
  3187.  numcols             The number of columns in the table; There MUST be a width 
  3188.                      variable for each column 
  3189.  lm                  Left edge of the table in millimetres or 1/10 inch 
  3190.                      depending on the Measures property from the left margin 
  3191.  width               Width of the column in millimetres or 1/10 inch depending 
  3192.                      on the Measures property. There must be numcols width 
  3193.                      variables 
  3194.  
  3195.  
  3196. ΓòÉΓòÉΓòÉ <hidden> StartTable - Example ΓòÉΓòÉΓòÉ
  3197.  
  3198. /************************************************************************/
  3199. /* Declare a table with no fill style, 0.5 mm separator lines and       */
  3200. /* 3 columns                                                            */
  3201. /************************************************************************/
  3202.  
  3203. ok = VRMethod( "PRT_1", "StartTable", 0, 24, 3,,
  3204.                         30,45,,
  3205.                         75,50,,
  3206.                         125,40);
  3207.  
  3208. if rcy then do
  3209.  
  3210.     /**** Start printing in the table **********************************/
  3211.  
  3212.     ok = VRMethod( "PRT_1", "StartRow");
  3213.  
  3214.     /**** Start printing in column 2 ***********************************/
  3215.  
  3216.     ok = VRMethod( "PRT_1", "StartCol", 1);
  3217.     ok = VRMethod( "PRT_1", "PrintRight", 'Helvetica', 10, textvar);
  3218.  
  3219.     /**** Start printing in column 2 ***********************************/
  3220.  
  3221.     ok = VRMethod( "PRT_1", "StartCol", 2);
  3222.     ok = VRMethod( "PRT_1", "PrintJustified", 'Helvetica Bold', 10, textvar);
  3223.     ok = VRMethod( "PRT_1", "PrintJustified",,,textvar);
  3224.     ok = VRMethod( "PRT_1", "PrintJustified",,,textvar);
  3225.  
  3226.     /**** Start printing in column 3 ***********************************/
  3227.  
  3228.     ok = VRMethod( "PRT_1", "StartCol", 3);
  3229.     ok = VRMethod( "PRT_1", "PrintCentered", 'Helvetica Bold', 14, textvar);
  3230.  
  3231.     /**** Print the row ************************************************/
  3232.  
  3233.     ok = VRMethod( "PRT_1", "EndRow");
  3234.  
  3235.     /**** Start a new row **********************************************/
  3236.  
  3237.     ok = VRMethod( "PRT_1", "StartRow");
  3238.     ok = VRMethod( "PRT_1", "StartCol", 1);
  3239.     ok = VRMethod( "PRT_1", "PrintRight", 'Times New Roman', 10, textvar);
  3240.     ok = VRMethod( "PRT_1", "StartCol", 2);
  3241.     ok = VRMethod( "PRT_1", "PrintLeft", 'Helvetica Bold', 10, textvar);
  3242.     ok = VRMethod( "PRT_1", "PrintCentered",,,textvar);
  3243.     ok = VRMethod( "PRT_1", "PrintJustified",,,textvar);
  3244.     ok = VRMethod( "PRT_1", "PrintRight",,,textvar);
  3245.     ok = VRMethod( "PRT_1", "StartCol", 3);
  3246.     ok = VRMethod( "PRT_1", "PrintJustified", 'Times New Roman', 8, textvar);
  3247.  
  3248.     /**** Print the row ************************************************/
  3249.  
  3250.     ok = VRMethod( "PRT_1", "EndRow");
  3251.  
  3252.     /**** Destroy the table data structures ****************************/
  3253.  
  3254.     ok = VRMethod( object, "EndTable");
  3255. end
  3256.  
  3257.  
  3258. ΓòÉΓòÉΓòÉ 4.39. Tab ΓòÉΓòÉΓòÉ
  3259.  
  3260.  
  3261. ΓòÉΓòÉΓòÉ <hidden> Tab - List ΓòÉΓòÉΓòÉ
  3262.  
  3263. Topics 
  3264.  
  3265.      Description 
  3266.      Parameters 
  3267.  
  3268.  
  3269. ΓòÉΓòÉΓòÉ <hidden> Tab - Description ΓòÉΓòÉΓòÉ
  3270.  
  3271. ok = VRMethod( object, "Tab");
  3272.  
  3273. Move to the next tab position on the line. Tabs are set when a print job is 
  3274. opened and are placed every 10 millimetres or 1/2 inch depending on the 
  3275. Measures property starting at the left margin. 
  3276.  
  3277. Return 
  3278.  
  3279. TRUE (1) if successful else FALSE (0). 
  3280.  
  3281.  
  3282. ΓòÉΓòÉΓòÉ <hidden> Tab - Parameters ΓòÉΓòÉΓòÉ
  3283.  
  3284.  None 
  3285.