Print Manager Interfaces. More...

#include <MacErrors.h>
#include <Quickdraw.h>
#include <Dialogs.h>

Data Structures
struct	TPrPort

struct	TPrInfo

struct	TPrStl

struct	TPrXInfo

struct	TPrJob

struct	TPrint

struct	TPrStatus

struct	TPfPgDir

struct	TPrDlg

struct	TGnlData

struct	TRslRg

struct	TRslRec

struct	TGetRslBlk

struct	TSetRslBlk

struct	TDftBitsBlk

struct	TGetRotnBlk

Macros
#define	sPrDrvr ".Print"

#define	NewPrIdleUPP(userRoutine)

#define	NewPItemUPP(userRoutine)

#define	DisposePrIdleUPP(userUPP) DisposeRoutineDescriptor(userUPP)

#define	DisposePItemUPP(userUPP) DisposeRoutineDescriptor(userUPP)

#define	InvokePrIdleUPP(userUPP) CALL_ZERO_PARAMETER_UPP((userUPP), uppPrIdleProcInfo)

#define	InvokePItemUPP(theDialog, item, userUPP) CALL_TWO_PARAMETER_UPP((userUPP), uppPItemProcInfo, (theDialog), (item))

#define	NewPrIdleProc(userRoutine) NewPrIdleUPP(userRoutine)

#define	NewPItemProc(userRoutine) NewPItemUPP(userRoutine)

#define	CallPrIdleProc(userRoutine) InvokePrIdleUPP(userRoutine)

#define	CallPItemProc(userRoutine, theDialog, item) InvokePItemUPP(theDialog, item, userRoutine)

#define	NewPDlgInitUPP(userRoutine)

#define	DisposePDlgInitUPP(userUPP) DisposeRoutineDescriptor(userUPP)

#define	InvokePDlgInitUPP(hPrint, userUPP) (TPPrDlgRef) CALL_ONE_PARAMETER_UPP((userUPP), uppPDlgInitProcInfo, (hPrint))

#define	NewPDlgInitProc(userRoutine) NewPDlgInitUPP(userRoutine)

#define	CallPDlgInitProc(userRoutine, hPrint) InvokePDlgInitUPP(hPrint, userRoutine)

Typedefs
typedef SInt8	TFeed

typedef SInt8	TScan

typedef Rect *	TPRect

typedef short	item

typedef struct TPrPort	TPrPort

typedef TPrPort *	TPPrPort

typedef TPPrPort	TPPrPortRef

typedef struct TPrInfo	TPrInfo

typedef TPrInfo *	TPPrInfo

typedef struct TPrStl	TPrStl

typedef TPrStl *	TPPrStl

typedef struct TPrXInfo	TPrXInfo

typedef TPrXInfo *	TPPrXInfo

typedef struct TPrJob	TPrJob

typedef TPrJob *	TPPrJob

typedef struct TPrint	TPrint

typedef TPrint *	TPPrint

typedef TPPrint *	THPrint

typedef struct TPrStatus	TPrStatus

typedef TPrStatus *	TPPrStatus

typedef TPPrStatus	TPPrStatusRef

typedef struct TPfPgDir	TPfPgDir

typedef TPfPgDir *	TPPfPgDir

typedef TPPfPgDir *	THPfPgDir

typedef struct TPrDlg	TPrDlg

typedef TPrDlg *	TPPrDlg

typedef TPPrDlg	TPPrDlgRef

typedef struct TGnlData	TGnlData

typedef struct TRslRg	TRslRg

typedef struct TRslRec	TRslRec

typedef struct TGetRslBlk	TGetRslBlk

typedef struct TSetRslBlk	TSetRslBlk

typedef struct TDftBitsBlk	TDftBitsBlk

typedef struct TGetRotnBlk	TGetRotnBlk

Enumerations
enum	{ kFirstPageMin = 1 , kLastPageMax = 32767 }

enum	{ iPFMaxPgs = 128 , iPrPgFract , iPrPgFst = 1 , iPrPgMax = 9999 , iPrRelease = 3 , iPrSavPFil = -1 , iPrAbort = 0x0080 , iPrDevCtl = 7 , lPrReset = 0x00010000 , lPrLineFeed = 0x00030000 , lPrLFStd = 0x0003FFFF , lPrLFSixth = 0x0003FFFF , lPrPageEnd = 0x00020000 , lPrDocOpen = 0x00010000 , lPrPageOpen = 0x00040000 , lPrPageClose = 0x00020000 , lPrDocClose = 0x00050000 , iFMgrCtl = 8 , iMscCtl = 9 , iPvtCtl = 10 }

enum	{ pPrGlobals = 0x00000944 , bDraftLoop = 0 , bSpoolLoop = 1 , bUser1Loop = 2 , bUser2Loop = 3 , fNewRunBit = 2 , fHiResOK = 3 , fWeOpenedRF = 4 , iPrBitsCtl = 4 , lScreenBits = 0 , lPaintBits = 1 , lHiScreenBits = 0x00000002 , lHiPaintBits = 0x00000003 , iPrIOCtl = 5 , iPrEvtCtl = 6 , lPrEvtAll = 0x0002FFFD , lPrEvtTop = 0x0001FFFD , iPrDrvrRef = -3 }

enum	{ getRslDataOp = 4 , setRslOp = 5 , draftBitsOp = 6 , noDraftBitsOp = 7 , getRotnOp = 8 , NoSuchRsl = 1 , OpNotImpl = 2 , RgType1 = 1 }

enum	{ feedCut = 0 , feedFanfold = 1 , feedMechCut = 2 , feedOther = 3 }

enum	{ scanTB = 0 , scanBT = 1 , scanLR = 2 , scanRL = 3 }

enum	{ uppPrIdleProcInfo = 0x00000000 }

enum	{ uppPItemProcInfo = 0x000002C0 }

enum	{ uppPDlgInitProcInfo = 0x000000F0 }

Functions
typedef	CALLBACK_API (void, PrIdleProcPtr)(void)

typedef	CALLBACK_API (void, PItemProcPtr)(DialogRef theDialog

typedef	STACK_UPP_TYPE (PrIdleProcPtr) PrIdleUPP

typedef	STACK_UPP_TYPE (PItemProcPtr) PItemUPP

PrIdleUPP	NewPrIdleUPP (PrIdleProcPtr userRoutine)

PItemUPP	NewPItemUPP (PItemProcPtr userRoutine)

void	DisposePrIdleUPP (PrIdleUPP userUPP)

void	DisposePItemUPP (PItemUPP userUPP)

void	InvokePrIdleUPP (PrIdleUPP userUPP)

void	InvokePItemUPP (DialogRef theDialog, short item, PItemUPP userUPP)

typedef	CALLBACK_API (TPPrDlgRef, PDlgInitProcPtr)(THPrint hPrint)

typedef	STACK_UPP_TYPE (PDlgInitProcPtr) PDlgInitUPP

PDlgInitUPP	NewPDlgInitUPP (PDlgInitProcPtr userRoutine)

void	DisposePDlgInitUPP (PDlgInitUPP userUPP)

TPPrDlgRef	InvokePDlgInitUPP (THPrint hPrint, PDlgInitUPP userUPP)

void	PrPurge (void)

void	PrNoPurge (void)

void	PrOpen (void)

void	PrClose (void)

void	PrintDefault (THPrint hPrint)

Boolean	PrValidate (THPrint hPrint)

Boolean	PrStlDialog (THPrint hPrint)

Boolean	PrJobDialog (THPrint hPrint)

TPPrDlgRef	PrStlInit (THPrint hPrint)

TPPrDlgRef	PrJobInit (THPrint hPrint)

void	PrJobMerge (THPrint hPrintSrc, THPrint hPrintDst)

Boolean	PrDlgMain (THPrint hPrint, PDlgInitUPP pDlgInit)
	Initialize for and execute a print dialog. More...

TPPrPort	PrOpenDoc (THPrint hPrint, TPPrPort pPrPort, Ptr pIOBuf)

void	PrCloseDoc (TPPrPort pPrPort)

void	PrOpenPage (TPPrPort pPrPort, TPRect pPageFrame)

void	PrClosePage (TPPrPort pPrPort)

void	PrPicFile (THPrint hPrint, TPPrPort pPrPort, Ptr pIOBuf, Ptr pDevBuf, TPPrStatus prStatus)

short	PrError (void)

void	PrSetError (short iErr)

void	PrGeneral (Ptr pData)

void	PrDrvrOpen (void)

void	PrDrvrClose (void)

void	PrCtlCall (short iWhichCtl, long lParam1, long lParam2, long lParam3)

Handle	PrDrvrDCE (void)

short	PrDrvrVers (void)

short	PrLoadDriver (void)

Detailed Description

Print Manager Interfaces.

Introduced In: System 7.5

Avaliable From: Universal Interfaces 3.4.1

Copyright: © 1985-2001 by Apple Computer, Inc., all rights reserved

For bug reports, consult the following page on the World Wide Web:

http://developer.apple.com/bugreporter/

Macro Definition Documentation

◆ NewPDlgInitProc

#define NewPDlgInitProc ( userRoutine ) NewPDlgInitUPP(userRoutine)

CALL_NOT_IN_CARBON support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewPDlgInitUPP

#define NewPDlgInitUPP ( userRoutine )

Value:

(PDlgInitUPP) NewRoutineDescriptor( \

(ProcPtr)(userRoutine), uppPDlgInitProcInfo, GetCurrentArchitecture())

NewRoutineDescriptor

UniversalProcPtr NewRoutineDescriptor(ProcPtr theProc, ProcInfoType theProcInfo, ISAType theISA)

pascal 4_bytes Func(4_bytes)

◆ NewPItemUPP

#define NewPItemUPP ( userRoutine )

Value:

(PItemUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), uppPItemProcInfo, \

GetCurrentArchitecture())

pascal no_return_value Func(4_bytes, 2_bytes)

◆ NewPrIdleProc

#define NewPrIdleProc ( userRoutine ) NewPrIdleUPP(userRoutine)

CALL_NOT_IN_CARBON support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewPrIdleUPP

#define NewPrIdleUPP ( userRoutine )

Value:

(PrIdleUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), uppPrIdleProcInfo, \

GetCurrentArchitecture())

pascal no_return_value Func()

Typedef Documentation

◆ TPPrDlgRef

typedef TPPrDlg TPPrDlgRef

!OPAQUE_TOOLBOX_STRUCTS

◆ TPPrPortRef

typedef TPPrPort TPPrPortRef

!OPAQUE_TOOLBOX_STRUCTS

◆ TPRect

typedef Rect* TPRect

A Rect Ptr

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
kLastPageMax	min value for first page

◆ anonymous enum

anonymous enum

Enumerator
iPrPgFst	Page scale factor. ptPgSize (below) is in units of 1/iPrPgFract
iPrPgMax	Page range constants
iPrSavPFil	Current version number of the code.
lPrReset	The PrDevCtl Proc's ctl number
lPrLineFeed	The PrDevCtl Proc's CParam for reset
lPrLFSixth	The PrDevCtl Proc's CParam for std paper advance
lPrDocOpen	The PrDevCtl Proc's CParam for end page
iMscCtl	The FMgr's Tail-hook Proc's ctl number
iPvtCtl	The FMgr's Tail-hook Proc's ctl number

◆ anonymous enum

anonymous enum

Error Codes moved to Errors.(hap)

Enumerator
bDraftLoop	The PrVars lo mem area:
iPrBitsCtl	Driver constants
lHiPaintBits	The Bitmap Print Proc's Screen Bitmap param
iPrIOCtl	The Bitmap Print Proc's Paint [sq pix] param
lPrEvtAll	The PrEvent Proc's ctl number
lPrEvtTop	The PrEvent Proc's CParam for the entire screen
iPrDrvrRef	The PrEvent Proc's CParam for the top folder

◆ anonymous enum

anonymous enum

Enumerator
RgType1	the driver doesn't support this opcode

Function Documentation

◆ DisposePDlgInitUPP()

void DisposePDlgInitUPP ( PDlgInitUPP userUPP )

DisposePDlgInitUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ DisposePItemUPP()

void DisposePItemUPP ( PItemUPP userUPP )

DisposePItemUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ DisposePrIdleUPP()

void DisposePrIdleUPP ( PrIdleUPP userUPP )

DisposePrIdleUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ InvokePDlgInitUPP()

TPPrDlgRef InvokePDlgInitUPP	(	THPrint	hPrint,
		PDlgInitUPP	userUPP
	)

InvokePDlgInitUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ InvokePItemUPP()

void InvokePItemUPP	(	DialogRef	theDialog,
		short	item,
		PItemUPP	userUPP
	)

InvokePItemUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ InvokePrIdleUPP()

void InvokePrIdleUPP ( PrIdleUPP userUPP )

InvokePrIdleUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ NewPDlgInitUPP()

PDlgInitUPP NewPDlgInitUPP ( PDlgInitProcPtr userRoutine )

NewPDlgInitUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ NewPItemUPP()

PItemUPP NewPItemUPP ( PItemProcPtr userRoutine )

NewPItemUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ NewPrIdleUPP()

PrIdleUPP NewPrIdleUPP ( PrIdleProcPtr userRoutine )

NewPrIdleUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: not available

Mac OS X: not available

◆ PrClose()

void PrClose ( void )

PrClose()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrCloseDoc()

void PrCloseDoc ( TPPrPort pPrPort )

PrCloseDoc()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrClosePage()

void PrClosePage ( TPPrPort pPrPort )

PrClosePage()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrCtlCall()

void PrCtlCall	(	short	iWhichCtl,
		long	lParam1,
		long	lParam2,
		long	lParam3
	)

PrCtlCall()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrDlgMain()

Boolean PrDlgMain	(	THPrint	hPrint,
		PDlgInitUPP	pDlgInit
	)

Initialize for and execute a print dialog.

PrDlgMain is called automatically by PrJobDialog and PrStlDialog .
Applications may call it to modify the standard print dialogs.
hPrtRec is a handle leading to a 120-byte TPrint structure, as previously
prepared by a call to PrintDefault or PrValidate .
pDlgInit is the address of a special dialog initialization routine. When called
by the Print Manager (i.e., in the normal course of events), this
value is the address of the code handling PrJobInit or PrStlInit .

Returns

a Boolean; it indicates whether the user has approved the contents of
hPrtRec as reflected in the dialog. It is one of:
FALSEThe user selected Cancel; no fields were changed.
TRUEThe user selected OK and the print record is valid.

Note

PrDlgMain is documented in Technical Note #95, which describes a
technique with which you can add items to the standard "Print..." and "Page
Setup..." dialogs. See Adding Items to the Print Dialogs for more information.
PrDlgMain calls pDlgInit to setup a TPrDlg structure, then displays the
dialog obtained thereby and calls ModalDialog .
See PrJobInit , PrStlInit , and TPrDlg for related information

Copyright: THINK Reference © 1991-1992 Symantec Corporation

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrDrvrClose()

void PrDrvrClose ( void )

PrDrvrClose()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrDrvrDCE()

Handle PrDrvrDCE ( void )

PrDrvrDCE()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrDrvrOpen()

void PrDrvrOpen ( void )

CALL_NOT_IN_CARBON PrDrvrOpen()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrDrvrVers()

short PrDrvrVers ( void )

PrDrvrVers()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrError()

short PrError ( void )

PrError()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrGeneral()

void PrGeneral ( Ptr pData )

CALL_NOT_IN_CARBON PrGeneral()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrintDefault()

void PrintDefault ( THPrint hPrint )

PrintDefault()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrJobDialog()

Boolean PrJobDialog ( THPrint hPrint )

PrJobDialog()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrJobInit()

TPPrDlgRef PrJobInit ( THPrint hPrint )

PrJobInit()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrJobMerge()

void PrJobMerge	(	THPrint	hPrintSrc,
		THPrint	hPrintDst
	)

PrJobMerge()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrLoadDriver()

short PrLoadDriver ( void )

PrLoadDriver()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrNoPurge()

void PrNoPurge ( void )

PrNoPurge()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrOpen()

void PrOpen ( void )

PrOpen()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrOpenDoc()

TPPrPort PrOpenDoc	(	THPrint	hPrint,
		TPPrPort	pPrPort,
		Ptr	pIOBuf
	)

PrOpenDoc()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

Parameters

pIOBuf can be NULL

◆ PrOpenPage()

void PrOpenPage	(	TPPrPort	pPrPort,
		TPRect	pPageFrame
	)

PrOpenPage()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrPicFile()

void PrPicFile	(	THPrint	hPrint,
		TPPrPort	pPrPort,
		Ptr	pIOBuf,
		Ptr	pDevBuf,
		TPPrStatus	prStatus
	)

PrPicFile()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrPurge()

void PrPurge ( void )

PrPurge()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrSetError()

void PrSetError ( short iErr )

PrSetError()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrStlDialog()

Boolean PrStlDialog ( THPrint hPrint )

PrStlDialog()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrStlInit()

TPPrDlgRef PrStlInit ( THPrint hPrint )

PrStlInit()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

◆ PrValidate()

Boolean PrValidate ( THPrint hPrint )

PrValidate()

Non-Carbon CFM: in InterfaceLib 7.1 and later

Carbon Lib: not available

Mac OS X: not available

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ NewPDlgInitProc

◆ NewPDlgInitUPP

◆ NewPItemUPP

◆ NewPrIdleProc

◆ NewPrIdleUPP

Typedef Documentation

◆ TPPrDlgRef

◆ TPPrPortRef

◆ TPRect

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

Function Documentation

◆ DisposePDlgInitUPP()

◆ DisposePItemUPP()

◆ DisposePrIdleUPP()

◆ InvokePDlgInitUPP()

◆ InvokePItemUPP()

◆ InvokePrIdleUPP()

◆ NewPDlgInitUPP()

◆ NewPItemUPP()

◆ NewPrIdleUPP()

◆ PrClose()

◆ PrCloseDoc()

◆ PrClosePage()

◆ PrCtlCall()

◆ PrDlgMain()

◆ PrDrvrClose()

◆ PrDrvrDCE()

◆ PrDrvrOpen()

◆ PrDrvrVers()

◆ PrError()

◆ PrGeneral()

◆ PrintDefault()

◆ PrJobDialog()

◆ PrJobInit()

◆ PrJobMerge()

◆ PrLoadDriver()

◆ PrNoPurge()

◆ PrOpen()

◆ PrOpenDoc()

◆ PrOpenPage()

◆ PrPicFile()

◆ PrPurge()

◆ PrSetError()

◆ PrStlDialog()

◆ PrStlInit()

◆ PrValidate()