home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
prtgrafc.zip
/
PRTGRAFC.INF
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1995-12-31
|
176KB
|
3,608 lines
ΓòÉΓòÉΓòÉ 1. PrtGraph C Library ΓòÉΓòÉΓòÉ
The PrtGraph C Library (prtgrafc.dll) gives you high level, application
oriented access to complex graphic printing functionality.
With this library you will be able to create professional style reports and
outputs for your programs without having to resort to the lengthy and tedious
process of programming the OS/2 Gpi interface. You can create reports and
documents with text in up to 25 different font faces that can be justified,
right or left aligned or centred. You can include bitmap images and boxes and
print tables with or without running headers.
The PrtGraph C Library allows you to define page headers and footers and gives
you access to a list of the printers connected to your work-station and their
Job Properties dialogs as well as to the font dialog for the chosen printer.
ΓòÉΓòÉΓòÉ 1.1. Whats new in version 2.1 ΓòÉΓòÉΓòÉ
The PrtGraph C Library has been aligned with the PrtGraph REXX Library, the
VRPrinter Object for VX-REXX and the PrtGraph Class Library.
In version 2.0 we introduced properties which are all accessed through the same
functions.
The memory usage of the library has been reduced and the code efficiency
improved.
In this version the following functions have been added:
PrtGMoveX
PrtGMoveY
PrtGPrintWinImage
PrtGNewPage will now prepare the job to start a new page from within a table
when the next PrtGEndRow call is made.
ΓòÉΓòÉΓòÉ 1.2. Shareware Software ΓòÉΓòÉΓòÉ
DEFINITION OF SHAREWARE SOFTWARE
Shareware Software distribution gives users a chance to try software before
buying it. If you try a Shareware software program and continue using it, you
are expected to register. Individual programs differ on details -- some request
registration while others require it, some specify a maximum trial period.
With registration, you get anything from the simple right to continue using
the software to an updated program with printed manual.
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as stated
below. Shareware software authors are accomplished programmers, just like
commercial authors, and the programs are of comparable quality. (In both cases,
there are good programs and bad ones!) The main difference is in the method of
distribution. The author specifically grants the right to copy and distribute
the software, either to all and sundry or to a specific group. For example,
some authors require written permission before a commercial disk vendor may
copy their Shareware software.
Shareware software is a distribution method, not a type of software. You should
find software that suits your needs and pocketbook, whether it's commercial or
Shareware software. The Shareware software system makes fitting your needs
easier, because you can try before you buy. And because the overhead is low,
prices are low also. Shareware software has the ultimate money-back guarantee
-- if you don't use the product, you don't pay for it.
When you register the PrtGraph C Library you will be sent a registered version
of the DLL by e-mail. This version has the "nag" popup removed and you have the
right to freely distribute software that includes the DLL.
If you are satisfied with the PrtGraph C Library we ask you to freely
distribute the shareware version to your freinds and colleagues.
If you have any suggestions for enhancements or find any bugs in the software
please contact us at one of our Contact Addresses
ΓòÉΓòÉΓòÉ 1.3. Registering your license ΓòÉΓòÉΓòÉ
Printer is a "Shareware software program" and is provided at no charge to the
user for evaluation. Feel free to share it with your friends, but please do not
give it away altered or as part of another system. The essence of
"user-supported" software is to provide personal computer users with quality
software without high prices, and yet to provide incentive for programmers to
continue to develop new products. If you find this program useful and find that
you are using Printer and continue to use Printer after a reasonable trial
period of 30 days, you must make a registration payment of $45.00 to ADD
Consulting (CH).
If you have already registered either PrtGraph for REXX or VRPrinter you can
register for $20.00.
You can register through the CompuServe Shareware Registration facility:
GO SWREG registration Number 6201 for new registrations
GO SWREG registration Number 6202 for registered users of another ADD
Consulting printing library
The registration fee will license one copy for use on any one computer at any
one time. You must treat this software just like a book. An example is that
this software may be used by any number of people and may be freely moved from
one computer location to another, so long as there is no possibility of it
being used at one location while it's being used at another. Just as a book
cannot be read by two different persons at the same time.
Payment of the registration fee gives you the right to distribute programs
that include the object and the DLL without paying any other "run-time"
licenses.
Site-License arrangements may be made by contacting ADD Consulting (CH).
ΓòÉΓòÉΓòÉ 1.4. Distributing the PrtGraph C Library ΓòÉΓòÉΓòÉ
Anyone distributing the PrtGraph C Library for any kind of remuneration must
first contact ADD Consulting (CH) at our address below for authorization. This
authorization will be automatically granted to distributors recognized by the
(ASP) as adhering to its guidelines for shareware distributors, and such
distributors may begin offering Printer immediately, however ADD Consulting
(CH) should still be advised so that the distributor can be kept up-to-date
with the latest version of Printer.
Registered users are free to distribute programs that use the the PrtGraph C
Library with no additional run-time fees.
ΓòÉΓòÉΓòÉ 1.5. Contact Address ΓòÉΓòÉΓòÉ
You can contact ADD Consulting at the addresses below:
ADD Consulting (CH)
Mr. Peter Kanis
Via Suro 9
CH-7403 RhДzБns
Switzerland
Tel: +41 (0)81 630 2011
Fax: +41 (0)81 630 2015
CompuServe: 100275,350 (Peter Kanis)
INTERNET: kanis@ibm.net
ADD Consulting (RUS)
Mr. Michael V. Schelkin
18-29 Molodezhnaya Street
Jukovsky
140160 Moscow Region
Russia
Tel: +7 095 556 8533
Internet: michael@schelkin.msk.ru
ΓòÉΓòÉΓòÉ 1.6. Rights And Limitations ΓòÉΓòÉΓòÉ
ADD Consulting makes no warranties as to the information in this guide.
Additionally, ADD Consulting is not responsible or liable for any loss or
damage of any kind resulting from use of this product.
The Software is protected by international copyright laws. All rights reserved.
No part of the computer program, documentation or related files may be
reproduced photocopied, stored on a retrieval system, or transmitted except as
provided by copyright law or by express permission of the copyright owner.
DISCLAIMER - AGREEMENT
Users of the PrtGraph C Library shall accept this disclaimer of warranty:
ADD CONSULTING SUPPLIES THIS PRODUCT AS IS WITHOUT WARANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARANTIES OF
MERCANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ADD CONSULTING ASSUMES NO
LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE
OF THE PRODUCT.
Some jurisdictions do not allow the exclusion or limitations for consequential
or incidental damages, so the above may not apply to you.
ΓòÉΓòÉΓòÉ 2. The DEMO program ΓòÉΓòÉΓòÉ
Included in this package is a demonstration program written in C and its source
code. The demo shows you many of the possibilities offered by the DLL, but the
limits are set by your imagination.
Figure: Demo Program.
ΓòÉΓòÉΓòÉ 3. Setting up a print job ΓòÉΓòÉΓòÉ
Setting up a print job requires several steps:
Link the library with your executable or DLL using PRTGRAFC.LIB
Intialise the printing environment with PrtGInit
Choose a printer with either PrtGPrinterDlg or PrtGPrinterList and
PrtGSetPrinter
If necessary set the job properties with PrtGJobProps
Set the page margins with PrtGSetMargins
Set up any header text with PrtGDefineHeader, PrtGAddHeaderLine and
PrtGSetHeader
Set up any footer with PrtGDefineFooter and PrtGSetFooter
Open the print job with PrtGOpenPrintJob
Print your texts, tables, bitmaps etc..
Close the print job with PrtGClosePrintJob
Since headers and footers often contain constants like the date or the
document title and variables like the page number, the texts defined for
these can contain special formatting characters.
NOTE
All the input parameters that denote positions are by default in
millimetres or 1/10 inch depending on the Measures property. You can
convert from inches using the formula:
mm = 254 * inch
All the line widths are defined in TWIPS:
1 Point = 20 TWIPS
1 mm = 56.7 TWIPS (rounded to 57 for internal calculation)
Warning:
If you wish to print several documents concurrently (i.e. in parrallel
threads) you must initialise and terminate the environment for each thead with
PrtGInit and PrtGTerm.
ΓòÉΓòÉΓòÉ 4. Formatting Characters ΓòÉΓòÉΓòÉ
To help define header and footer texts with PrtGDefineHeader and
PrtGDefineFooter the following special formatting flags are defined:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
Γöé$ ΓöéIf followed by one of the other characters in this tableΓöé
Γöé Γöéit indicates a formatting character follows, otherwise Γöé
Γöé Γöéit is taken as a literal '$' Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöél ΓöéLeft align the following text Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöér ΓöéRight align the following text Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéc ΓöéCentre the following text Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé@ ΓöéInsert the current date formatted acording to the systemΓöé
Γöé Γöésettings. This is read every time a job is started; so Γöé
Γöé Γöéyou can change the date format from job to job in the Γöé
Γöé Γöésame sesssion. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé# Γöéinsert the current page number (always arabic) Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéΓûî or | ΓöéInsert the title of the document (see PrtGOpenPrintJob) Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
Example
'$Γûî$rpage $#' would give:
Document Title page 1
'$r@ page $#' would give (where date is defined as ISO with '/' separator):
1995/03/18 page 1
Warning:
Formatting characters only apply to the page and table header and page footer
texts.
ΓòÉΓòÉΓòÉ 5. Fill Styles ΓòÉΓòÉΓòÉ
Several of the PrtGraph C Library refer to a fill style. You can see the effect
of a style for any printer by running the DEMO program and printing the box
styles option. The you pass to any of these functions are translated into
PATSYM_????? constants, and the output is, to a certain extent, device
dependent. For an idea of what you will obtain see the pictures below (see also
.
ΓòÉΓòÉΓòÉ 6. Returns ΓòÉΓòÉΓòÉ
Many of the PrtGraph C Library functions return a USHORT value. These will be
one of the following:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéConstant ΓöéVal ΓöéExplanation Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_OK Γöé0 ΓöéOperation completed successfully. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_INV_HANDLE Γöé1 ΓöéAn invalid handle passed to a function. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_NO_PRINTER Γöé2 ΓöéNo printer has been defined on the Γöé
Γöé Γöé Γöéwork-station. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_PARAMETER Γöé3 ΓöéA parameter passed to the function was Γöé
Γöé Γöé Γöéout of range. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_INV_BITMAP Γöé4 ΓöéThe bitmap read from a file was not a Γöé
Γöé Γöé Γöévalid bitmap. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_INV_FILENAME Γöé5 ΓöéThe file opened to read a bitmap either Γöé
Γöé Γöé Γöédid not exist or an I/O error occured. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_INV_FONT Γöé6 ΓöéThe font requested for a write operationΓöé
Γöé Γöé Γöécould not be loaded. This could be Γöé
Γöé Γöé Γöébecause there are too many fonts Γöé
Γöé Γöé Γöédeclared for the job or the face name isΓöé
Γöé Γöé Γöéinvalid. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_JOB_OPEN Γöé7 ΓöéFailed to open the print job. Usually Γöé
Γöé Γöé Γöécaused by an invalid device context Γöé
Γöé Γöé Γöébeing selected when using PrtGSetPrinterΓöé
Γöé Γöé Γöé. Using PrtGPrinterDlg to set the Γöé
Γöé Γöé Γöéprinter context is always safer. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_NOT_TABLE Γöé8 ΓöéA call was made to a table related Γöé
Γöé Γöé Γöéfunction outside of a PrtGStartTable, Γöé
Γöé Γöé ΓöéPrtGEndTable pair. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_TABLE_HEADER Γöé9 ΓöéAn error occured trying to print a Γöé
Γöé Γöé Γöérunning header for a table, check the Γöé
Γöé Γöé Γöédefinition. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_NO_JOB Γöé10 ΓöéA printing function was called when no Γöé
Γöé Γöé Γöéjob had been opened. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_PRINTING Γöé9 ΓöéA print setup function was called when aΓöé
Γöé Γöé Γöéjob was running. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_READONLY Γöé12 ΓöéYou tried setting a read only property. Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_INV_PROP Γöé13 ΓöéAn invalid property was requested Γöé
Γöé Γöé Γöérequested Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRTGR_ERR_INV_VALUE Γöé14 ΓöéYou tried setting a property to an Γöé
Γöé Γöé Γöéinvalid value Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
ΓòÉΓòÉΓòÉ 7. Constants ΓòÉΓòÉΓòÉ
Constants are described in the following sections:
Lines and Fill Styles
Print Styles for Files
Printer Properties
ΓòÉΓòÉΓòÉ 7.1. Lines and Fill Styles ΓòÉΓòÉΓòÉ
The following constants define Fill Styles and line thicknesses:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéConstant ΓöéValue ΓöéDescription Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_NONE Γöé(ULONG)0 ΓöéNo fill for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_FULL Γöé(ULONG)1 Γöéfull fill for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_90 Γöé(ULONG)2 Γöé90% tone fill for a box, header, footer Γöé
Γöé Γöé Γöéor table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_80 Γöé(ULONG)3 Γöé80% fill for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_75 Γöé(ULONG)4 Γöé75% fill for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_70 Γöé(ULONG)5 Γöé70% fill for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_60 Γöé(ULONG)6 Γöé60% fill for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_HALF Γöé(ULONG)7 ΓöéHalf tone fill for a box, header, footerΓöé
Γöé Γöé Γöéor table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_LIGHT Γöé(ULONG)8 ΓöéLight tone fill for a box, header, Γöé
Γöé Γöé Γöéfooter or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_VERT Γöé(ULONG)9 ΓöéVertical line fill for a box, header, Γöé
Γöé Γöé Γöéfooter or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_HORIZ Γöé(ULONG)10 ΓöéHorizontal line fill for a box, header, Γöé
Γöé Γöé Γöéfooter or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_DIAGR45 Γöé(ULONG)11 Γöé45┬░ Diagonal left to right line fill forΓöé
Γöé Γöé Γöéa box, header, footer or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_DIAGR33 Γöé(ULONG)12 Γöé33┬░ Diagonal left to right line fill forΓöé
Γöé Γöé Γöéa box, header, footer or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_DIAGL45 Γöé(ULONG)13 Γöé45┬░ Diagonal right to left line fill forΓöé
Γöé Γöé Γöéa box, header, footer or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéFILL_DIAGL33 Γöé(ULONG)14 Γöé33┬░ Diagonal right to left line fill forΓöé
Γöé Γöé Γöéa box, header, footer or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéLINE_NONE Γöé(ULONG)0 ΓöéNo line for a box, header, footer or Γöé
Γöé Γöé Γöétable Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéLINE_THIN Γöé(ULONG)14 ΓöéThin line 0.25mm thick for a box, Γöé
Γöé Γöé Γöéheader, footer or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéLINE_MEDIUM Γöé(ULONG)28 ΓöéMedium line 0.5mm thick for a box, Γöé
Γöé Γöé Γöéheader, footer or table Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéLINE_THICK Γöé(ULONG)56 ΓöéThick line 1mm thick for a box, header, Γöé
Γöé Γöé Γöéfooter or table Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
ΓòÉΓòÉΓòÉ 7.2. Print Styles for Files ΓòÉΓòÉΓòÉ
The following constants define printing styles for printing files:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéConstant ΓöéVal ΓöéDescription Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_CENTER Γöé0 ΓöéPrint the lines from the file centered Γöé
Γöé Γöé Γöébeween the margins Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_JUSTIFIED Γöé1 ΓöéPrint the lines from the file justified Γöé
Γöé Γöé Γöébetween the margins Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_RIGHT Γöé2 ΓöéPrint the lines from the file right Γöé
Γöé Γöé Γöéaligned Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_LEFT Γöé3 ΓöéPrint the lines from the file left Γöé
Γöé Γöé Γöéaligned Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
ΓòÉΓòÉΓòÉ 7.3. Printer Properties ΓòÉΓòÉΓòÉ
The following constants define measurement types:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéConstant ΓöéValue ΓöéDescription Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéMSR_METRIC Γöé"Metric" ΓöéDefines all measures to be in Γöé
Γöé Γöé Γöémillimetres Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéMSR_INCH Γöé"Inch" ΓöéDefines all measures to be in units of Γöé
Γöé Γöé Γöé1/10th inch Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
The following constants are used to access the printer properties:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéConstant ΓöéVal ΓöéSee property Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_LEFTMARGIN Γöé0 ΓöéLeftMargin Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_RIGHTMARGIN Γöé1 ΓöéRightMargin Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_TOPMARGIN Γöé2 ΓöéTopMargin Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_BOTTOMMARGIN Γöé3 ΓöéBottomMargin Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_PAGEWIDTH Γöé4 ΓöéPageWidth Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_PAGEHEIGHT Γöé5 ΓöéPageHeight Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_PRINTING Γöé6 ΓöéPrinting Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_CURRENTPRINTER Γöé7 ΓöéCurrentPrinter Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_CURRENTDEVICE Γöé8 ΓöéCurrentDevice Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_DEFAULTPRINTER Γöé9 ΓöéDefaultPrinter Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_LINESPACE Γöé10 ΓöéLineSpace Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_VERSION Γöé11 ΓöéVersion Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_PRINTCOLOR Γöé12 ΓöéPrintColor Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_COLORENABLED Γöé13 ΓöéColorEnabled Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_MEASURES Γöé14 ΓöéMeasures Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_PAGENUM Γöé15 ΓöéPageNum Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_JOBNAME Γöé16 ΓöéJobName Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_MINLEFTMAR Γöé17 ΓöéMinLeftMar Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_MINRIGHTMAR Γöé18 ΓöéMinRightMar Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_MINTOPMAR Γöé19 ΓöéMinTopMar Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_MINBOTTOMMAR Γöé20 ΓöéMinBottomMar Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_FORMNAME Γöé21 ΓöéFormName Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_FORMWIDTH Γöé22 ΓöéFormWidth Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_FORMHEIGHT Γöé23 ΓöéFormHeight Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_WORDBREAK Γöé24 ΓöéWordBreak Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPRT_SHOWPROGRESS Γöé25 ΓöéShowProgress Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
ΓòÉΓòÉΓòÉ 8. Data Types ΓòÉΓòÉΓòÉ
The following sections describe the data types exported by the PrtGraph C
Library.
HFOOTER
HGRPRT
HHEADER
HTABLE
PFNNP
PROP_TYPE
ΓòÉΓòÉΓòÉ 8.1. HFOOTER ΓòÉΓòÉΓòÉ
typedef LHANDLE HFOOTER;
Handle to a footer definition. This definition is independent of HGRPRT and the
object is only merged with the print job definition after a call to
PrtGSetFooter. The Object can, therefore, be used in several print jobs in an
application. The object is destroyed by calling PrtGDestroyFtrDef
ΓòÉΓòÉΓòÉ 8.2. HGRPRT ΓòÉΓòÉΓòÉ
typedef LHANDLE HGRPRT;
Handle to the graphics printing environment. All printing operations require a
variable of this type to have been previously initialised by a call to
PrtGInit.
ΓòÉΓòÉΓòÉ 8.3. HHEADER ΓòÉΓòÉΓòÉ
typedef LHANDLE HHEADER;
Handle to a page header definition. This definition is independent of HGRPRT
and the object is only merged with the print job definition after a call to
PrtGSetHeader. The Object can, therefore, be used in several print jobs in an
application. The object is destroyed by calling PrtGDestroyHdrDef
ΓòÉΓòÉΓòÉ 8.4. HTABLE ΓòÉΓòÉΓòÉ
typedef LHANDLE HTABLE;
Handle to a table definition. This definition is independent of HGRPRT and the
object is only merged with the print job definition after a call to
PrtGStartTable. The Object can, therefore, be used in several print jobs in an
application. The object is destroyed by calling PrtGDestroyTblDef
ΓòÉΓòÉΓòÉ 8.5. PFNNP ΓòÉΓòÉΓòÉ
typedef BOOL (APIENTRY FNNP)(HGRPRT, USHORT, BOOL);
typedef FNNP *PFNNP;
Hook function for new page. A call will be made to this function every time a
new page is created internally by the library and before the page is printed.
The format of the function is:
VOID MyNewPageFunc( HGRPRT hp,
USHORT page_num,
BOOL in_table);
Parameters
hp Handle to the printing environment returned by PrtGInit
page_num The number of the page that is about to be printed
in_table is set to true if a table is being printed that will
continue over to the new page.
Description
This function is supplied so that you can modify page headers or column
headers when a new page is printed.
ΓòÉΓòÉΓòÉ 8.6. PROP_TYPE ΓòÉΓòÉΓòÉ
typedef union
{
BOOL flag;
ULONG numeric;
PSZ string;
} PROP_TYPE;
This union type is used to set or get the value of a printer property.
ΓòÉΓòÉΓòÉ 9. Properties ΓòÉΓòÉΓòÉ
The following sections describe the properties of a printer in the PrtGraph C
Library and which can be accessed using with the relevannt Printer Properties
Constant:
BottomMargin
ColorEnabled
CurrentDevice
CurrentPrinter
DefaultPrinter
FormHeight
FormName
FormWidth
JobName
LeftMargin
LineSpace
Measures
MinBottomMar
MinLeftMar
MinRightMar
MinTopMar
PageHeight
PageNum
PageWidth
Printing
PrintColor
RightMargin
ShowProgress
TopMargin
Version
WordBreak
ΓòÉΓòÉΓòÉ 9.1. BottomMargin ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> BottomMargin - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
LeftMargin
RightMargin
TopMargin
PageHeight
PageWidth
ΓòÉΓòÉΓòÉ <hidden> BottomMargin - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_BOTTOMMARGIN);
The distance of the bottom margin from the lower edge of the page. The measure
is in mm or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.2. ColorEnabled ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> ColorEnabled - List ΓòÉΓòÉΓòÉ
Data Type
BOOL
Possible Values
1 (TRUE)
0 (FALSE)
See Also
PrintColor
ΓòÉΓòÉΓòÉ <hidden> ColorEnabled - Description ΓòÉΓòÉΓòÉ
flag = PrtGGet( printer, PRT_COLORENABLED);
Boolean property indicating whether color printing is enabled or not.
ΓòÉΓòÉΓòÉ 9.3. CurrentDevice ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> CurrentDevice - List ΓòÉΓòÉΓòÉ
Data Type
PSZ
See Also
CurrentPrinter
PrtGPrinterDialog
ΓòÉΓòÉΓòÉ <hidden> CurrentDevice - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_CURRENTDEVICE);
The name of the printer device selected for the printer object. This is the
same as the Physical Name seen in printer settings notebook.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.4. CurrentPrinter ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> CurrentPrinter - list ΓòÉΓòÉΓòÉ
Data Type
PSZ
See Also
CurrentDevice
PrtGPrinterDialog
ΓòÉΓòÉΓòÉ <hidden> CurrentPrinter - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_CURRENTPRINTER);
The name of the printer selected for the printer object. This is the same as
the name seen on the desktop printer object.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.5. DefaultPrinter ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> DefaultPrinter - List ΓòÉΓòÉΓòÉ
Data Type
PSZ
See Also
CurrentDevice
CurrentPrinter
PrtGPrinterDialog
ΓòÉΓòÉΓòÉ <hidden> DefaultPrinter - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_DEFAULTPRINTER);
The name of the default system printer. This is the same as the name seen on
the desktop printer object.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.6. FormHeight ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> FormHeight - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
FormName
FormWidth
ΓòÉΓòÉΓòÉ <hidden> FormHeight - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_FORMHEIGHT);
The height of the currently selected form for the current printer in mm or 1/10
inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.7. FormName ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> FormName - List ΓòÉΓòÉΓòÉ
Data Type
PSZ
See Also
FormHeight
FormWidth
ΓòÉΓòÉΓòÉ <hidden> FormName - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_FORMNAME);
The name of the currently selected form for the current printer.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.8. FormWidth ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> FormWidth - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
FormHeight
FormName
ΓòÉΓòÉΓòÉ <hidden> FormWidth - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_FORMWIDTH);
The width of the currently selected form for the current printer in mm or 1/10
inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.9. JobName ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> JobName - List ΓòÉΓòÉΓòÉ
Data Type
PSZ
ΓòÉΓòÉΓòÉ <hidden> JobName - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_JOBNAME);
The document name of the current print job.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.10. LeftMargin ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> LeftMargin - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
BottomMargin
RightMargin
TopMargin
PageHeight
PageWidth
ΓòÉΓòÉΓòÉ <hidden> LeftMargin - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_LEFTMARGIN);
The distance of the left margin from the left edge of the page. The measure is
in mm or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.11. LineSpace ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> LineSpace - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
PrtGPrintCentered
PrtGPrintJustified
PrtGPrintLeft
PrtGPrintLine
PrtGPrintRight
ΓòÉΓòÉΓòÉ <hidden> LineSpace - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_LINESPACE);
Line spacing as a percentage of the font size. The default value is set to
single space = 120%. All writes following this call will use this inter-line
spacing.
ΓòÉΓòÉΓòÉ 9.12. Measures ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Measures - List ΓòÉΓòÉΓòÉ
Data Type
PSZ
Possible Values
"Metric" (MSR_METRIC)
"Inch" (MSR_INCH)
See Also
PrtGSetFooter
PrtGSetHeader
PrtGSetHeaderLineFont
PrtGSetMargins
ΓòÉΓòÉΓòÉ <hidden> Measures - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_MEASURES);
The units to use for distances on the printing page. These can be either mm
(the default) or in 1/10 inch units.
ΓòÉΓòÉΓòÉ 9.13. MinBottomMar ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> MinBottomMar - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
MinLeftMar
MinRightMar
MinTopMar
ΓòÉΓòÉΓòÉ <hidden> MinBottomMar - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_MINBOTTOMMAR);
The minimum bottom margin allowed for the selected printer. The measure is in
mm or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.14. MinLeftMar ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> MinLeftMar - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
MinBottomMar
MinRightMar
MinTopMar
ΓòÉΓòÉΓòÉ <hidden> MinLeftMar - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_MINLEFTMAR);
The minimum left margin allowed for the selected printer. The measure is in mm
or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.15. MinRightMar ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> MinRightMar - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
MinBottomMar
MinLeftMar
MinTopMar
ΓòÉΓòÉΓòÉ <hidden> MinRightMar - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_MINRIGHTMAR);
The minimum right margin allowed for the selected printer. The measure is in mm
or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.16. MinTopMar ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> MinTopMar - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
MinBottomMar
MinLeftMar
MinRightMar
ΓòÉΓòÉΓòÉ <hidden> MinTopMar - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_MINTOPMAR);
The minimum top margin allowed for the selected printer. The measure is in mm
or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.17. PageHeight ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PageHeight - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
BottomMargin
LeftMargin
RightMargin
TopMargin
PageWidth
ΓòÉΓòÉΓòÉ <hidden> PageHeight - Decsription ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_PAGEHEIGHT);
The height of the printing area of the page (bottom to top margin) in mm or
1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.18. PageNum ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PageNum - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
JobName
ΓòÉΓòÉΓòÉ <hidden> PageNum - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_PAGENUM);
This property contains the number of the page that is currently being printed.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.19. PageWidth ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PageWidth - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
BottomMargin
LeftMargin
RightMargin
TopMargin
PageHeight
ΓòÉΓòÉΓòÉ <hidden> PageWidth - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_PAGEWIDTH);
The width of the printing area of the page (left to right margin) in mm or 1/10
inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.20. Printing ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Printing - List ΓòÉΓòÉΓòÉ
Data Type
BOOL
Possible Values
1 (TRUE)
0 (FALSE)
See Also
PrtGClosePrintJob
PrtGOpenPrintJob
ΓòÉΓòÉΓòÉ <hidden> Printing - Description ΓòÉΓòÉΓòÉ
bool = PrtGGet( printer, PRT_PRINTING);
This property is set to 1 when a print job is open on the printer object.
Otherwise this property is set to 0.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.21. PrintColor ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrintColor - List ΓòÉΓòÉΓòÉ
Data Type
LONG
Possible Values
See Description
See Also
ColorEnabled
ΓòÉΓòÉΓòÉ <hidden> PrintColor - Description ΓòÉΓòÉΓòÉ
long = PrtGGet( printer, PRT_PRINTCOLOR);
This property is only relevant for colour printers. It contains the current
colour being used for printing. This color can be any of the standard GPI color
constants:
CLR_WHITE CLR_BLACK CLR_BLUE
CLR_RED CLR_PINK CLR_GREEN
CLR_CYAN CLR_YELLOW CLR_DARKGRAY
CLR_DARKBLUE CLR_DARKRED CLR_DARKPINK
CLR_DARKGREEN CLR_DARKCYAN CLR_BROWN
CLR_PALEGREY CLR_DEFAULT
ΓòÉΓòÉΓòÉ 9.22. RightMargin ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> RightMargin - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
BottomMargin
LeftMargin
TopMargin
PageHeight
PageWidth
ΓòÉΓòÉΓòÉ <hidden> RightMargin - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_RIGHTMARGIN);
The distance of the right margin from the right edge of the page. The measure
is in mm or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.23. ShowProgress ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> ShowProgress - List ΓòÉΓòÉΓòÉ
Data Type
BOOL
Possible Values
1 (TRUE)
0 (FALSE)
See Also
ΓòÉΓòÉΓòÉ <hidden> ShowProgress - Description ΓòÉΓòÉΓòÉ
bool = PrtGGet( printer, PRT_SHOWPROGRESS);
This is boolean property that when set enables the progress dialog to pop up
when a job is printing.
Figure: Default Progress Dialog.
ΓòÉΓòÉΓòÉ 9.24. TopMargin ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> TopMargin - List ΓòÉΓòÉΓòÉ
Data Type
ULONG
See Also
BottomMargin
LeftMargin
RightMargin
PageHeight
PageWidth
ΓòÉΓòÉΓòÉ <hidden> TopMargin - Description ΓòÉΓòÉΓòÉ
ulong = PrtGGet( printer, PRT_TOPMARGIN);
The distance of the top margin from the upper edge of the page. The measure is
in mm or 1/10 inch depending on the Measures property.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.25. Version ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Version - List ΓòÉΓòÉΓòÉ
Data Type
PSZ
Data Type
Numeric
ΓòÉΓòÉΓòÉ <hidden> Version - Description ΓòÉΓòÉΓòÉ
psz = PrtGGet( printer, PRT_VERSION);
Version number of the object.
Warning: This property is read only and cannot be set with a call to PrtGSet.
ΓòÉΓòÉΓòÉ 9.26. WordBreak ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> WordBreak - List ΓòÉΓòÉΓòÉ
Data Type
BOOL
Possible Values
1 (TRUE)
0 (FALSE)
ΓòÉΓòÉΓòÉ <hidden> WordBreak - Description ΓòÉΓòÉΓòÉ
bool = PrtGGet( printer, PRT_WORDBREAK);
The WordBreak property allows you to control the way the Printer Object
performs word wrapping on a block of text. By default this property is set to 1
(TRUE) so that the breaks occur between words. By setting this property off
(0), line wrapping will occur with breaks between characters.
ΓòÉΓòÉΓòÉ 10. Functions ΓòÉΓòÉΓòÉ
The following sections describe the functions exported by PrtGraph C Library.
In the following list, the names of the old functions are given where
applicacable. These old function names are maintained for backward
compatibility.
PrtGAbortPrintJob
PrtGAddColumn
PrtGAddHeaderLine
PrtGClosePrintJob
PrtGDefineFooter
PrtGDefineHeader
PrtGDefineTable
PrtGDefineFtrColors
PrtGDefineHdrColors
PrtGDefineTableColors
PrtGDestroyFtrDef
PrtGDestroyHdrDef
PrtGDestroyTblDef
PrtGEndRow
PrtGEndTable
PrtGFontDialog PrtGFontDlg
PrtGGet
PrtGGoto
PrtGInit
PrtGJobProperties PrtGJobProps
PrtGNewPage
PrtGOpenPrintJob
PrtGPrintBitmap PrtGBitMap and PrtGBitMapColor
PrtGPrintBox PrtGBox and PrtGBoxColor
PrtGPrinterDialog PrtGPrinterDlg
PrtGPrinterList
PrtGPrintCentered PrtGCentre
PrtGPrintFile
PrtGPrintJustified PrtGJustified
PrtGPrintLeft PrtGWrite
PrtGPrintLine PrtGWriteln
PrtGPrintRight PrtGJustRight
PrtGSet
PrtGSetDlgButtonTexts
PrtGSetFooter
PrtGSetHeader
PrtGSetHdrLineFont
PrtGSetMargins
PrtGSetPrintColors
PrtGSetPrinter
PrtGStartCol
PrtGStartRow
PrtGStartTable
PrtGTab
PrtGTerm
ΓòÉΓòÉΓòÉ 10.1. PrtGAbortPrintJob ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGAbortPrintJob - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGClosePrintJob
PrtGOpenPrintJob
ΓòÉΓòÉΓòÉ <hidden> PrtGAbortPrintJob - Parameters ΓòÉΓòÉΓòÉ
htbl Handle to the table definition created with
PrtGDefineTable
ΓòÉΓòÉΓòÉ <hidden> PrtGAbortPrintJob - Description ΓòÉΓòÉΓòÉ
USHORT PrtGAbortPrintJob( HTABLE htbl);
Aborts the print job and deletes the document from the print queue.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid job handle was passed
PRTGR_ERR_NO_JOB There is no job running to abort
ΓòÉΓòÉΓòÉ 10.2. PrtGAddColumn ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGAddColumn - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineTable
PrtGResetColHeader
PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGAddColumn - Description ΓòÉΓòÉΓòÉ
USHORT PrtGAddColumn( HTABLE htbl,
USHORT usCol,
ULONG ulLeft,
ULONG ulWide,
PSZ pszTtile);
Adds a column definition to a table definition.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid table handle was passed
ΓòÉΓòÉΓòÉ <hidden> PrtGAddColumn - Parameters ΓòÉΓòÉΓòÉ
htbl Handle to the table definition created with
PrtGDefineTable
usCol Number of the column. The Column numbering is in real
world numbers i.e. starting at 1
ulLeft The distance of the left edge of the column from the left
margin in mm
ulWide The width of the cells in the column in mm
pszTitle A pointer to a NULL terminated string containing the
column header text
ΓòÉΓòÉΓòÉ 10.3. PrtGAddHeaderLine ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGAddHeaderLine - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineHeader
PrtGSetHeader
PrtGOpenPrintJob
ΓòÉΓòÉΓòÉ <hidden> PrtGAddHeaderLine - Description ΓòÉΓòÉΓòÉ
USHORT PrtGAddHeaderLine( HHEADER hhdr,
USHORT usLine,
PSZ pszString);
Defines a text line in the page header.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid header handle is passed
PRTGR_ERR_PARAMETER usLine is out of range i.e. greater than 5 or
less than 1
ΓòÉΓòÉΓòÉ <hidden> PrtGAddHeaderLine - Parameters ΓòÉΓòÉΓòÉ
hhdr Handle to a header definition returned by PrtGDefineHeader
usLine The number of the line in the header. Line numbers are in
real world numbers i.e. 1 to 5
pszString Pointer to a NULL terminated string with the text to
appear on the line. This text can contain Formatting
Characters
ΓòÉΓòÉΓòÉ 10.4. PrtGClosePrintJob ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGClosePrintJob - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGOpenPrintJob
PrtGInit
PrtGTerm
ΓòÉΓòÉΓòÉ <hidden> PrtGClosePrintJob - Description ΓòÉΓòÉΓòÉ
USHORT PrtGClosePrintJob( HGRPRT hp);
Closes the current job and resets all the internal variables associated with
the presentation space.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGClosePrintJob - Parameters ΓòÉΓòÉΓòÉ
hp handle to the printing environment returned by PrtGInit
ΓòÉΓòÉΓòÉ 10.5. PrtGDefineFooter ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineFooter - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineHeader
PrtGSetFooter
PrtGDestroyFtrDef
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineFooter - Description ΓòÉΓòÉΓòÉ
HFOOTER PrtGDefineFooter( BOOL bPrint,
PSZ pszFont,
ULONG ulPts,
ULONG ulFill,
ULONG ulLine,
PSZ pszString);
Builds an internal structure used to define the footer for the pages in a print
job. This structure is available for re-use untill it is explicitly destroyed
with PrtGDestroyFtrDef
Return
Handle to a footer description that can then be passed to PrtGSetFooter
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineFooter - Parameters ΓòÉΓòÉΓòÉ
bPrint Boolean flag (TRUE = Print footers, FALSE = do not print
footers)
pszFont Font name to print the footer
ulPts Point size for the footer font
ulFill The fill style for the box containing the footer
ulLine The thickness (in TWIPS) of the line around the box
containing the footer.
pszString Text to print in the footer. This text can contain
Formatting Characters
ΓòÉΓòÉΓòÉ 10.6. PrtGDefineHeader ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineHeader - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGAddHeaderLine
PrtGDefineFooter
PrtGSetHeader
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineHeader - Description ΓòÉΓòÉΓòÉ
HHEADER PrtGDefineHeader( BOOL bPrint,
BOOL bAllPages,
PSZ pszFont,
ULONG ulPts,
ULONG ulFill,
ULONG ulLine,
USHORT usLines);
Builds an internal structure used to define the header for the pages in a print
job. This structure is available for re-use until it is explicitly destroyed
with PrtGDestroyHdrDef. Before calling PrtGSetHeader you must set the header
texts using calls to PrtGAddHeaderLine.
Return
Handle to a header definition which can be passed to PrtGSetHeader
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineHeader - Parameters ΓòÉΓòÉΓòÉ
bPrint Flag indicating if page headers should be printed.
bAllPages If TRUE the headers are repeated an all the pages,
otherwise a header is only printed on the first page.
pszFont Font name to print the header
ulPts Point size for the header font
ulFill The fill style for the box containing the headerer
ulLine The thickness (in TWIPS) of the line around the box
containing the header.
usLines The number of lines printed in the header (1 to 5)
ΓòÉΓòÉΓòÉ 10.7. PrtGDefineTable ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineTable - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGAddColumn
PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineTable - Description ΓòÉΓòÉΓòÉ
HTABLE PrtGDefineTable( BOOL boxed,
BOOL bHeader,
BOOL bAllPages,
ULONG ulLine,
ULONG ulFill,
ULONG ulHline,
ULONG ulHfill,
PSZ pszFont,
ULONG ulPts,
USHORT usCols);
Builds an internal table definition which is available for re-use until
explicitly destroyed using PrtGDestroyTblDef.
Return
A handle to a table definition structure wich can then be used to define the
columns with PrtGAddColumn and start printing a table with PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineTable - Parameters ΓòÉΓòÉΓòÉ
boxed If TRUE the cells will have a box around them
bHeader If TRUE headers are defined for each column
bAllPages If TRUE use running headers i.e. the table header will be
printed on each page
ulLine The line thickness around the cells in the table
ulFill The fill style for the cells in the table
ulHline The line thickness around the header cells
ulHfill The fill style for the header cells
pszFont The font used to print the header texts
ulPts The point size for printing the header texts
usCols The number of columns in the table
ΓòÉΓòÉΓòÉ 10.8. PrtGDefineFtrColors ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineFtrColors - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineFooter
PrtGSetFooter
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineFtrColors - Description ΓòÉΓòÉΓòÉ
USHORT PrtGDefineFtrColors( HFOOTER hftr,
LONG lt_color,
LONG lb_color,
LONG lf_color);
Define the colors used for printing the page footers.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid handle was passed
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineFtrColors - Parameters ΓòÉΓòÉΓòÉ
hftr Handle to a footer definition created with
PrtGDefineFooter
lt_color Color for printing the text in the footer
lb_color Color for printing the border around the footer
lf_color Color for printing the fill pattern in the footer
ΓòÉΓòÉΓòÉ 10.9. PrtGDefineHdrColors ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineHdrColors - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineHeader
PrtGAddHeaderLine
PrtGSetHeader
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineHdrColors - Description ΓòÉΓòÉΓòÉ
USHORT PrtGDefineHdrColors( HHEADER hhdr,
LONG lt_color,
LONG lb_color,
LONG lf_color);
Define the colors used for printing the page headers.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid handle was passed
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineHdrColors - Parameters ΓòÉΓòÉΓòÉ
hhdr Handle to a header defintion created with PrtGDefineHeader
lt_color Color for printing the text in the header
lb_color Color for printing the border around the header
lf_color Color for printing the fill pattern in the header
ΓòÉΓòÉΓòÉ 10.10. PrtGDefineTableColors ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineTableColors - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineTable
PrtGAddColumn
PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineTableColors - Description ΓòÉΓòÉΓòÉ
USHORT PrtGDefineTableColors( HTABLE htbl,
LONG lct_color,
LONG lcb_color,
LONG lcf_color,
LONG lht_color,
LONG lhb_color,
LONG lhf_color);
Defines the colors for printing a table defined with .
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid handle was passed
ΓòÉΓòÉΓòÉ <hidden> PrtGDefineTableColors - Parameters ΓòÉΓòÉΓòÉ
htbl Handle to a table definition created with PrtGDefineTable
lct_color Color for printing the text in the table cells
lcb_color Color for printing the borders around the table cells
lcf_color Color for printing the fill pattern in the table cells
lht_color Color for printing the text in the table headers
lhb_color Color for printing the borders around the table headers
lhf_color Color for printing the fill pattern in the table headers
ΓòÉΓòÉΓòÉ 10.11. PrtGDestroyFtrDef ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyFtrDef - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineFooter
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyFtrDef - Description ΓòÉΓòÉΓòÉ
HFOOTER PrtGDestroyFtrDef( HFOOTER hftr);
Destroys the internal structure defining the page footers for a job.
Return
NULLHANDLE
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyFtrDef - Parameters ΓòÉΓòÉΓòÉ
hftr Handle to a footer definition created with
PrtGDefineFooter
ΓòÉΓòÉΓòÉ 10.12. PrtGDestroyHdrDef ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyHdrDef - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineHeader
PrtGAddHeaderLine
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyHdrDef - Description ΓòÉΓòÉΓòÉ
HHEADER PrtGDestroyHdrDef( HHEADER hhdr);
Destroys the internal structure defining the page headers for a job.
Return
NULLHANDLE
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyHdrDef - Parameters ΓòÉΓòÉΓòÉ
hhdr Handle to a header defintion created with PrtGDefineHeader
ΓòÉΓòÉΓòÉ 10.13. PrtGDestroyTblDef ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyTblDef - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineTable
PrtGAddColumn
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyTblDef - Description ΓòÉΓòÉΓòÉ
HTABLE PrtGDestroyTblDef( HTABLE htbl);
Destroys the internal structure defining a table with its columns.
Return
NULLHANDLE
ΓòÉΓòÉΓòÉ <hidden> PrtGDestroyTblDef - Parameters ΓòÉΓòÉΓòÉ
htbl Handle to a table definition created with PrtGDefineTable
ΓòÉΓòÉΓòÉ 10.14. PrtGEndRow ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGEndRow - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGStartRow
PrtGStartCol
PrtGEndTable
ΓòÉΓòÉΓòÉ <hidden> PrtGEndRow - Description ΓòÉΓòÉΓòÉ
USHORT PrtGEndRow( HGRPRT hp);
Draws all the cells from the current row and prints all the texts that have
been written to the columns since the previous call to PrtGStartRow. if any of
the cells is longer than the available space on the page, it will be wrapped
over to the next page and if running table headers are defined they will be
printed.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_NOT_TABLE No table has been started
ΓòÉΓòÉΓòÉ <hidden> PrtGEndRow - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ΓòÉΓòÉΓòÉ 10.15. PrtGEndTable ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGEndTable - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGEndRow
PrtGDefineTable
PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGEndTable - Description ΓòÉΓòÉΓòÉ
USHORT PrtGEndTable( HGRPRT hp);
Ends printing to a table. Before calling this function, ensure that you have
printed the last row with a call to PrtGEndRow
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_NOT_TABLE No table has been started
ΓòÉΓòÉΓòÉ <hidden> PrtGEndTable - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ΓòÉΓòÉΓòÉ 10.16. PrtGFontDialog ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGFontDialog - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintCentered
PrtGPrintJustified
PrtGPrintRight
PrtGPrinterDialog
PrtGPrintLeft
PrtGPrintLine
ΓòÉΓòÉΓòÉ <hidden> PrtGFontDialog - Description ΓòÉΓòÉΓòÉ
PSZ PrtGFontDlg( HGRPRT hp,
PSZ pszTitle,
PSZ pszOldFace);
Calls the system font dialog with the fonts for the selected printer. If no
printer has been explicitly defined, the default system printer will be used.
Return
The name of the chosen font or a NULL string if the Cancel button was pressed.
Note: It is the responsibility of the calling process to check the validity of
the returned pointer and to free it when no longer needed.
Figure: Font Dialog.
ΓòÉΓòÉΓòÉ <hidden> PrtGFontDialog - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
pszTitle The title to appear in the dialog.
pszOldFace The default font family name.
ΓòÉΓòÉΓòÉ 10.17. PrtGGet ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGGet - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
ΓòÉΓòÉΓòÉ <hidden> PrtGGet - Description ΓòÉΓòÉΓòÉ
PROP_TYPE PrtGGet( HGRPRT hp,
USHORT prop,
PUSHORT perror);
Retrieves the value of the given Property.
Return
A string pointer, an unsigned long or a boolean depending on the property.
It also returns an error code in the variable pointed to by perror:
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_READONLY The property is a read onlz property
PRTGR_ERR_INV_PROP The prop parameter is out of range
PRTGR_ERR_INV_VALUE The value parameter is invalid
ΓòÉΓòÉΓòÉ <hidden> PrtGGet - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
prop One of the Printer Properties constants
perror Variable that will contain any error code when the
function returns
ΓòÉΓòÉΓòÉ 10.18. PrtGGoto ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGGoto - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
None
ΓòÉΓòÉΓòÉ <hidden> PrtGGoto - Description ΓòÉΓòÉΓòÉ
USHORT PrtGGoto( HGRPRT hp,
ULONG ulx,
ULONG uly,
BOOL points);
Moves the Gpi cursor to the given position.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGGoto - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ulx x coordinate in mm from left margin
uly y coordinate from the bottom margin
points If TRUE the measures are points otherwise they are mm or
1/10 inch
ΓòÉΓòÉΓòÉ 10.19. PrtGInit ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGInit - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGTerm
ΓòÉΓòÉΓòÉ <hidden> PrtGInit - Description ΓòÉΓòÉΓòÉ
HGRPRT PrtGInit( HWND hwndParent,
PFNNP pnp_func);
Initialises the internal structures needed to handle print jobs and returns a
handle which is required by all other printing functions.
Return
Handle to the printing environment.
ΓòÉΓòÉΓòÉ <hidden> PrtGInit - Parameters ΓòÉΓòÉΓòÉ
hwndParent Handle of the parent window for dialog functions
pnp_func Pointer to the new page hook function
ΓòÉΓòÉΓòÉ 10.20. PrtGJobProperties ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGJobProperties - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrinterDialog
PrtGPrinterList
PrtGSetPrinter
ΓòÉΓòÉΓòÉ <hidden> PrtGJobProperties - Description ΓòÉΓòÉΓòÉ
USHORT PrtGJobProps( HGRPRT hp,
HWND hwndParent);
Shows the job properties dialog for the current printer.
Warning: This functions requires the presence of a PM Queue.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
Figure: Printer Job Properties Dialog for a Laserjet IIIP.
ΓòÉΓòÉΓòÉ <hidden> PrtGJobProperties - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
hwndParent Handle to the parent window (calling window)
ΓòÉΓòÉΓòÉ 10.21. PrtGMoveX ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGMoveX - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGGoto
PrtGMoveY
ΓòÉΓòÉΓòÉ <hidden> PrtGMoveX - Description ΓòÉΓòÉΓòÉ
USHORT PrtGMoveX( HGRPRT hp,
ULONG relX,
BOOL points);
Moves the graphics printing cursor horizontally relative to the current
position.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGMoveX - Parameters ΓòÉΓòÉΓòÉ
Parameters
hp Handle to the printing environment returned from PrtGInit
relX number of points or units to move. If the number is
negative, the cursor is moved to the left.
points flag indicating whether to use the default Measures. or
points.
FALSE = Use default measure
TRUE = use Points
ΓòÉΓòÉΓòÉ 10.22. PrtGMoveY ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGMoveY - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGGoto
PrtGMoveX
ΓòÉΓòÉΓòÉ <hidden> PrtGMoveY - Description ΓòÉΓòÉΓòÉ
USHORT PrtGMoveY( HGRPRT hp,
ULONG relY,
BOOL points);
Moves the graphics printing cursor horizontally relative to the current
position.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGMoveY - Parameters ΓòÉΓòÉΓòÉ
Parameters
hp Handle to the printing environment returned from PrtGInit
relY number of points or units to move. If the number is
negative, the cursor is moved to the left.
points flag indicating whether to use the default Measures. or
points.
FALSE = Use default measure
TRUE = use Points
ΓòÉΓòÉΓòÉ 10.23. PrtGNewPage ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGNewPage - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
None
ΓòÉΓòÉΓòÉ <hidden> PrtGNewPage - Description ΓòÉΓòÉΓòÉ
USHORT PrtGNewPage( HGRPRT hp);
Forces a new page to be started. If a header or footer is defined, these will
be printed to the new page.
If a table is being printed and the table has running headers defined, the
column headers will be printed. The new page will only be started when you make
the next PrtGEndRow call.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGNewPage - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ΓòÉΓòÉΓòÉ 10.24. PrtGOpenPrintJob ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGOpenPrintJob - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGSetFooter
PrtGSetHeader
PrtGSetMargins
PrtGPrinterDialog
PrtGSetLineSpace
ΓòÉΓòÉΓòÉ <hidden> PrtGOpenPrintJob - Description ΓòÉΓòÉΓòÉ
USHORT PrtGOpenPrintJob( HGRPRT hp,
PSZ pszTitle,
USHORT usPages);
Opens a new print job with the defined header, footer and printer.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_NO_PRINTER There are no printers available to the
work-station.
PRTGR_ERR_JOB_OPEN failed to greate the print job (Error in Gpi or
Dev call)
ΓòÉΓòÉΓòÉ <hidden> PrtGOpenPrintJob - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
pszTitle The Document name which will appear in the spooler
usPages The total number of pages to print.
ΓòÉΓòÉΓòÉ 10.25. PrtGPrintBitmap ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintBitmap - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintBox
PrtGPrintWinImage
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintBitmap - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintBitmap( HGRPRT hp,
PSZ pszFName,
ULONG ulLeft,
ULONG ulBottom,
ULONG ulRight,
ULONG ulTop,
ULONG ulLine,
LONG lcborder);
Opens a bitmap file (Win or OS/2) and prints it in the defined box with a frame
ulLine TWIPS thick.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_INV_BITMAP The file contained an invalid bitmap
PRTGR_ERR_INV_FILENAME There was an I/O error opening the bitmap file
or the file does not exist.
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintBitmap - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit
pszFName Name of the file to print.
ulLeft Left edge of the box to contain the bitmap in mm from the
left margin
ulBottom Bottom edge of the box to contain the bitmap in mm from
the bottom margin
ulRight Right edge of the box to contain the bitmap in mm from the
left margin
ulTop Top edge of the box to contain the bitmap in mm from the
bottom margin
ulLine Thickness of a frame to draw around the bitmap (TWIPS)
lcborder Color for the border drawn around the bitmap
ΓòÉΓòÉΓòÉ 10.26. PrtGPrintBox ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintBox - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintBitmap
PrtGPrintWinImage
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintBox - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintBox( HGRPRT hp,
ULONG ulLeft,
ULONG ulBottom,
ULONG ulRight,
ULONG ulTop,
ULONG ulLine,
ULONG ulFill,
LONG lcborder,
LONG lcfill);
Draws a box with the defined line thickness and fill style at the given
coordinates.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintBox - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit
pszFName Name of the file to print.
ulLeft Left edge of the box in mm from the left margin
ulBottom Bottom edge of the box in mm from the bottom margin
ulRight Right edge of the box in mm from the left margin
ulTop Top edge of the box in mm from the bottom margin
ulLine Thickness of a frame to draw around the box (TWIPS)
ulFill Fill style of the box
lcborder Colour for the line around the box
lcfill Colour for the fill pattern of the box
ΓòÉΓòÉΓòÉ 10.27. PrtGPrinterDialog ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrinterDialog - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGSetPrinter
PrtGPrinterList
PrtGJobProperties
ΓòÉΓòÉΓòÉ <hidden> PrtGPrinterDialog - Description ΓòÉΓòÉΓòÉ
PSZ PrtGPrinterDlg( HGRPRT hp,
HWND hwndParent,
PSZ pszTitle);
Shows a dialog with a list of the available printers for the work-station. The
default printer will be highlighted. You can set the job properties for any of
the printers in the list.
Return
Name of the printer chosen or an empty string if the cancel button is pressed.
Warning: Do not free this pointer as it points to a field in an internal
structure.
Figure: Printer Dialog.
ΓòÉΓòÉΓòÉ <hidden> PrtGPrinterDialog - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
hwndParent Handle to the parent window (calling window)
pszTitle The title for the dialog. If this is a NULL pointer then
"Choose Printer" will be displayed in the title bar.
ΓòÉΓòÉΓòÉ 10.28. PrtGPrinterList ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrinterList - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrinterDialog
PrtGSetPrinter
ΓòÉΓòÉΓòÉ <hidden> PrtGPrinterList - Description ΓòÉΓòÉΓòÉ
PSZ *PrtGPrinterList( HGRPRT hp,
BOOL bRefresh,
PUSHORT pusCount);
Returns a list of the available printers. No printer is selected by this
function: if you want to use a printer other than the default, you must use
PrtGSetPrinter.
Return
Pointer to an array *pusCount long of strings.
Warning: It is the responsibility of the calling program to free this array.
ΓòÉΓòÉΓòÉ <hidden> PrtGPrinterList - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
bRefresh If this is set to TRUE the internal list of printers will
be refreshed, otherwise the list shown will the one read
with PrtGInit or the last call to the function
pusCount Pointer to a USHORT that will hold the number of printers
found.
ΓòÉΓòÉΓòÉ 10.29. PrtGPrintCentered ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintCentered - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintJustified
PrtGPrintRight
PrtGPrintLeft
PrtGPrintLine
PrtGFontDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintCentered - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintCentered( HGRPRT hp,
PSZ pszFont,
ULONG ulPts,
PSZ pszString);
Prints the text centered between the margins. If the text is too long to fit on
one line, it will be wrapped over several lines. If you are within a table, the
text will be written to the current column defined by PrtGStartCol.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_PARAMETER pstString is a NULL pointer
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintCentered - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
pszFont Name of the font to use for printing the text. if this is
an empty ("") string or a NULL Pointer, the current font
is used.
ulPts The point size of the font to use. If this value is 0, the
current point size is is used.
pszString The string to print.
ΓòÉΓòÉΓòÉ 10.30. PrtGPrintFile ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintFile - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintJustified
PrtGPrintRight
PrtGPrintLeft
PrtGPrintLine
PrtGFontDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintFile - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintFile( HGRPRT hp,
PSZ pszFont,
ULONG ulPts,
USHORT usStyle
PSZ pszFile);
Prints the text contained in the file in the specified style. If the text is
too long to fit on one line, it will be wrapped over several lines.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_PARAMETER pszFile is a NULL pointer
PRTGR_ERR_INV_FILENAME pszFile does not exist
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintFile - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
pszFont Name of the font to use for printing the text. if this is
an empty ("") string or a NULL Pointer, the current font
is used.
ulPts The point size of the font to use. If this value is 0, the
current point size is is used.
usStyle One of the Print Styles for Files constants
pszFile Name of the file to print.
ΓòÉΓòÉΓòÉ 10.31. PrtGPrintJustified ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintJustified - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintCentered
PrtGPrintRight
PrtGPrintLeft
PrtGPrintLine
PrtGFontDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintJustified - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintJustified( HGRPRT hp,
PSZ pszFont,
ULONG ulPts,
PSZ pszString);
Prints the text in the requested font and point size justified between the left
and right margins. If the text is too long to fit on one line, it will be
wrapped over several lines. If you are within a table, the text will be written
to the current column defined by PrtGStartCol.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_PARAMETER pstString is a NULL pointer
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintJustified - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
pszFont Name of the font to use for printing the text. if this is
an empty ("") string or a NULL Pointer, the current font
is used.
ulPts The point size of the font to use. If this value is 0, the
current point size is is used.
pszString The string to print.
ΓòÉΓòÉΓòÉ 10.32. PrtGPrintLeft ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintLeft - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintCentered
PrtGPrintJustified
PrtGPrintRight
PrtGPrintLine
PrtGFontDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintLeft - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintLeft( HGRPRT hp,
PSZ pszFont,
ULONG ulPts,
PSZ pszString);
Write the text in the specified font and point size justified left. If the text
is too long to fit on one line, it will be wrapped over several lines. If you
are within a table, the text will be written to the current column defined by
PrtGStartCol.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_PARAMETER pstString is a NULL pointer
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintLeft - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
pszFont Name of the font to use for printing the text. if this is
an empty ("") string or a NULL Pointer, the current font
is used.
ulPts The point size of the font to use. If this value is 0, the
current point size is is used.
pszString The string to print.
ΓòÉΓòÉΓòÉ 10.33. PrtGPrintLine ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintLine - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintCentered
PrtGPrintJustified
PrtGPrintRight
PrtGPrintLeft
PrtGFontDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintLine - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintLine( HGRPRT hp,
PSZ pszFont,
ULONG ulPts,
PSZ pszString);
Write the text in the specified font and point size justified left followed by
linefeed and carriage return. If the text is too long to fit on one line, it
will be wrapped over several lines. If you are within a table, the text will be
written to the current column defined by PrtGStartCol.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_PARAMETER pstString is a NULL pointer
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintLine - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
pszFont Name of the font to use for printing the text. if this is
an empty ("") string or a NULL Pointer, the current font
is used.
ulPts The point size of the font to use. If this value is 0, the
current point size is is used.
pszString The string to print.
ΓòÉΓòÉΓòÉ 10.34. PrtGPrintRight ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintRight - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintCentered
PrtGPrintJustified
PrtGPrintLeft
PrtGPrintLine
PrtGFontDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintRight - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintRight( HGRPRT hp,
PSZ pszFont,
ULONG ulPts,
PSZ pszString);
Prints the text right justified to the right margin in the specified font and
font size. If the text is too long to fit on one line, it will be wrapped over
several lines. If you are within a table, the text will be written to the
current column defined by PrtGStartCol.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_PARAMETER pstString is a NULL pointer
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintRight - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
pszFont Name of the font to use for printing the text. if this is
an empty ("") string or a NULL Pointer, the current font
is used.
ulPts The point size of the font to use. If this value is 0, the
current point size is is used.
pszString The string to print.
ΓòÉΓòÉΓòÉ 10.35. PrtGPrintWinImage ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintWinImage - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrintBitmap
PrtGPrintBox.
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintWinImage - Description ΓòÉΓòÉΓòÉ
USHORT PrtGPrintWinImage( HGRPRT hp,
HWND hwnd,
ULONG ulLeft,
ULONG ulBottom,
ULONG ulRight,
ULONG ulTop,
ULONG ulLine,
LONG lcborder);
Prints an image of the contents of a window.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGPrintWinImage - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned by PrtGInit.
hwnd Handle of the window whose contents you want to print
ulLeft Lower left X coordinate taken from the left margin in
millimetres or 1/10 inch depending on the Measures
property
ulBottom Lower left Y coordinate taken from the bottom margin in
millimetres or 1/10 inch depending on the Measures
property
ulRight Upper right X coordinate taken from the left margin in
millimetres or 1/10 inch depending on the Measures
property. if this parameter is 0 the image will be printed
with the same width as the object on the screen.
ulTop Upper right Y coordinate taken from the bottom margin in
millimetres or 1/10 inch depending on the Measures
property. if this parameter is 0 the image will be printed
with the same height as the object on the screen.
ulLine Thickness of the box line in TWIPS ( 56.7 TWIPS = 1mm)
lcborder The colour of the line around the image.
ΓòÉΓòÉΓòÉ 10.36. PrtGResetColHeader ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGResetColHeader - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineTable
PrtGAddColumn
PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGResetColHeader - Description ΓòÉΓòÉΓòÉ
USHORT PrtGResetColHeader( HGRPRT hp,
USHORT usCol,
PSZ pszText)
Changes the header text for a column in a table that is printing. This function
can be used to modify the the running header text for a table while it is
printing.
Note: the original text declared with PrtGDefineTable and PrtGAddColumn will
always be printed when PrtGStartTable is called.
Warning:
This function will return an error if called before PrtGStartTable
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_NOT_TABLE No table has been started with PrtGStartTable
PRTGR_ERR_PARAMETER usCol is out of range i.e. greater than the
number of declared columns or less than 1
ΓòÉΓòÉΓòÉ <hidden> PrtGResetColHeader - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
usCol Column number whose header text is to be changed (1..n)
pszText New column header text
ΓòÉΓòÉΓòÉ 10.37. PrtGSet ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSet - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
ΓòÉΓòÉΓòÉ <hidden> PrtGSet - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSet( HGRPRT hp,
USHORT prop,
PROP_TYPE value);
Retrieves the value of the given Property.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_READONLY The property is a read onlz property
PRTGR_ERR_INV_PROP The prop parameter is out of range
PRTGR_ERR_INV_VALUE The value parameter is invalid
ΓòÉΓòÉΓòÉ <hidden> PrtGSet - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
prop One of the Printer Properties constants
value The new value to set
ΓòÉΓòÉΓòÉ 10.38. PrtGSetDlgButtonTexts ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetDlgButtonTexts - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrinterDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGSetDlgButtonTexts - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetDlgButtonTexts( HGRPRT hp,
PSZ pszBut1,
PSZ pszBut2,
PSZ pszBut3);
Change the texts for the buttons on the printer dialog. If any of the
parameters is NULL, the button remains unchanged. Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGSetDlgButtonTexts - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
pszBut1 New text for the OK button
pszBut2 New text for the Job properties... button
pszBut3 New text for the Cancel button
ΓòÉΓòÉΓòÉ 10.39. PrtGSetFooter ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetFooter - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineFooter
PrtGDestroyFtrDef
ΓòÉΓòÉΓòÉ <hidden> PrtGSetFooter - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetFooter( HGRPRT hp,
HFOOTER hftr);
Sets the footer for the current job from the definition in hftr. After this
call, you can destroy the footer definition with PrtGDestroyFtrDef
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGSetFooter - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
hftr Handle to a footer definition created with
PrtGDefineFooter
ΓòÉΓòÉΓòÉ 10.40. PrtGSetHeader ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetHeader - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineHeader
PrtGAddHeaderLine
PrtGDestroyHdrDef
ΓòÉΓòÉΓòÉ <hidden> PrtGSetHeader - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetHeader( HGRPRT hp,
HHEADER hhdr);
Sets the page headers for the current job using the definition hhdr. After this
call you can destroy the header defintion with PrtGDestroyHdrDef
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGSetHeader - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
hhdr Handle to a header definition created with
PrtGDefineHeader and PrtGAddHeaderLine
ΓòÉΓòÉΓòÉ 10.41. PrtGSetHdrLineFont ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetHdrLineFont - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineHeader
PrtGAddHeaderLine
PrtGDestroyHdrDef
ΓòÉΓòÉΓòÉ <hidden> PrtGSetHdrLineFont - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetHdrLineFont( HHEADER hhdr,
USHORT usLine,
PSZ pszFont,
ULONG ulPoints);
Changes the font and/or point size for one line in the header.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid handle was passed.
ΓòÉΓòÉΓòÉ <hidden> PrtGSetHdrLineFont - Parameters ΓòÉΓòÉΓòÉ
hhdr Handle to a header definition created with
PrtGDefineHeader and PrtGAddHeaderLine
usLine The line number (1..5)
pszFont The new font name, if NULL the original font is used
ulPoints The new point size to use. If 0 then the original
pointsize is used
ΓòÉΓòÉΓòÉ 10.42. PrtGSetMargins ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetMargins - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGSetPrintColors
PrtGSetFooter
PrtGSetHeader
PrtGOpenPrintJob
ΓòÉΓòÉΓòÉ <hidden> PrtGSetMargins - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetMargins( HGRPRT hp,
ULONG ulLeft,
ULONG ulRight,
ULONG ulTop,
ULONG ulBottom,
ULONG ulBorder,
ULONG ulFill);
Defines the printing margins for the job, whether there is a border and how
thick and whether the page has a background fill.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGSetMargins - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ulLeft Distance of left margin from the left edge of the page in
mm
ulRight Distance of right margin from the right edge of the page
in mm
ulTop Distance of top margin from the top edge of the page in mm
ulBottom Distance of bottom margin from the bottom edge of the page
in mm
ulBorder Thickness (in TWIPS) of a border drawn just outside the
margins
ulFill Fill style for the page.
ΓòÉΓòÉΓòÉ 10.43. PrtGSetPrintColors ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetPrintColors - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineFtrColors
PrtGDefineHdrColors
PrtGSetMargins
ΓòÉΓòÉΓòÉ <hidden> PrtGSetPrintColors - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetPrintColors( HGRPRT hp,
LONG lt_color,
LONG lb_color,
LONG lf_color);
Define the colors used for printing. Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE An invalid handle was passed
ΓòÉΓòÉΓòÉ <hidden> PrtGSetPrintColors - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
lt_color Default color for printing
lb_color Color for printing the border around pages
lf_color Color for printing the fill pattern in pages
ΓòÉΓòÉΓòÉ 10.44. PrtGSetPrinter ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGSetPrinter - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGPrinterList
PrtGPrinterDialog
ΓòÉΓòÉΓòÉ <hidden> PrtGSetPrinter - Description ΓòÉΓòÉΓòÉ
USHORT PrtGSetPrinter( HGRPRT hp,
USHORT usIdx);
Allows you to select a printer without calling PrtGPrinterDlg. Along with
PrtGPrinterList, this function can be used to create yur own printer selection
dialog.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGSetPrinter - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
usIdx Real world index (1 to n) to the array of printers
returned by PrtGPrinterList. An index of 0 will select the
default system printer.
ΓòÉΓòÉΓòÉ 10.45. PrtGStartCol ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGStartCol - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGStartRow
PrtGStartTable
PrtGEndRow
ΓòÉΓòÉΓòÉ <hidden> PrtGStartCol - Description ΓòÉΓòÉΓòÉ
USHORT PrtGStartCol( HGRPRT hp,
USHORT usCol);
Start sending all following print commands to the specified column in the
current table.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
PRTGR_ERR_NOT_TABLE No table has been started with PrtGStartTable
PRTGR_ERR_PARAMETER Column number is either 0 or greater than the
number of columns declared for the table
ΓòÉΓòÉΓòÉ <hidden> PrtGStartCol - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
usCol Column number to start (1 based)
ΓòÉΓòÉΓòÉ 10.46. PrtGStartRow ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGStartRow - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGEndRow
PrtGStartCol
PrtGStartTable
ΓòÉΓòÉΓòÉ <hidden> PrtGStartRow - Description ΓòÉΓòÉΓòÉ
USHORT PrtGStartRow( HGRPRT hp);
Start printing a new row in the table. This function clears internal flags on
the columns. Failure to call this function can cause unexpected results.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGStartRow - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ΓòÉΓòÉΓòÉ 10.47. PrtGStartTable ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGStartTable - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGDefineTable
PrtGAddColumn
PrtGStartRow
PrtGStartCol
PrtGEndRow
PrtGEndTable
PrtGResetColHeader
ΓòÉΓòÉΓòÉ <hidden> PrtGStartTable - Description ΓòÉΓòÉΓòÉ
USHORT PrtGStartTable( HGRPRT hp,
HTABLE htbl);
Start printing the table defined by htbl.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised or the table handle is invalid
PRTGR_ERR_PARAMETER The number of columns defines to the table
definition in PrtGDefineTable is out of range
ΓòÉΓòÉΓòÉ <hidden> PrtGStartTable - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
htbl Handle to a table definition made with PrtGDefineTable
ΓòÉΓòÉΓòÉ 10.48. PrtGTab ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGTab - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
None
ΓòÉΓòÉΓòÉ <hidden> PrtGTab - Description ΓòÉΓòÉΓòÉ
USHORT PrtGTab( HGRPRT hp);
Move the Gpi cursor to the next tab stop.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
ΓòÉΓòÉΓòÉ <hidden> PrtGTab - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ΓòÉΓòÉΓòÉ 10.49. PrtGTerm ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PrtGTerm - List ΓòÉΓòÉΓòÉ
Topics
Description
Parameters
See Also
PrtGInit
ΓòÉΓòÉΓòÉ <hidden> PrtGTerm - Description ΓòÉΓòÉΓòÉ
VOID PrtGTerm( HGRPRT hp);
Terminate the printing environment. Thsi deallocates all memory and invalidates
the handle.
Warning: Any calls to PRTGRAFC functions using hp made after this call will
generate access violations unless hp is set to NULLHANDLE.
Return
None
ΓòÉΓòÉΓòÉ <hidden> PrtGTerm - Parameters ΓòÉΓòÉΓòÉ
hp Handle to the printing environment returned from PrtGInit
ΓòÉΓòÉΓòÉ 11. Old Functions Still Maintained ΓòÉΓòÉΓòÉ
The following section describes some of the functions from version 1.x that
have been replaced by PrtGGet and PrtGSet.
For backward compatibility these functions sre maintained as are the old named
of printing functions.
PrtGCurrentPrinter
PrtGGetPageSize
PrtGSetLineSpace
PrtGVersion
ΓòÉΓòÉΓòÉ 11.1. PrtGCurrentPrinter ΓòÉΓòÉΓòÉ
PSZ PrtGCurrentPrinter( HGRPRT hp);
Parameters
hp handle to the printing environment returned by PrtGInit
Description
Get the name of the current selected printer.
Warning: The returned string pointer must not be freed by calling application.
Return
Returns the name of the current printer or a NULL pointer if there is an
error.
ΓòÉΓòÉΓòÉ 11.2. PrtGGetPageSize ΓòÉΓòÉΓòÉ
USHORT PrtGGetPageSize( HGRPRT hp,
PULONG pulWide,
PULONG pulHigh);
Parameters
hp Handle to the printing environment returned from PrtGInit
pulWide Pointer to a ULONG that will contain the width of the page
in mm
pulHigh Pointer to a ULONG that will contain the height of the
page in mm
Description
Returns the width of the page from left to right margin and the height of the
page from bottom to top margin in mm. Use this function to help calculate
positions for printing.
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
Related functions
PrtGGoto
ΓòÉΓòÉΓòÉ 11.3. PrtGSetLineSpace ΓòÉΓòÉΓòÉ
USHORT PrtGSetLineSpace( HGRPRT hp,
USHORT usPercent);
Parameters
hp Handle to the printing environment returned from PrtGInit
usPercent The percentage of the font hight to use for the interline
space. The default is 120 = single space
Description
Sets the inter line spacing for the following writes as a proportion of the
font point size..
Return
PRTGR_OK The operation was successful
PRTGR_ERR_INV_HANDLE The printing environment has not been
initialised
Related functions
PrtGCentre
PrtGJustified
PrtGWrite
PrtGWriteln
ΓòÉΓòÉΓòÉ 11.4. PrtGVersion ΓòÉΓòÉΓòÉ
PSZ PrtGVersion( VOID);
Parameters
None
Description
Get the version number of the PRTGRAFC DLL.
Return
String representation of the DLL version number.
Note: It is the responsibility of the calling process to free the string when
it is no longer needed.
Related functions
None