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