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