You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
560 lines
13 KiB
560 lines
13 KiB
/* |
|
File: PMApplication.h |
|
|
|
Contains: Carbon Printing Manager Interfaces. |
|
|
|
Version: QuickTime 7.3 |
|
|
|
Copyright: (c) 2007 (c) 1998-2001 by Apple Computer, Inc., all rights reserved |
|
|
|
Bugs?: For bug reports, consult the following page on |
|
the World Wide Web: |
|
|
|
http://developer.apple.com/bugreporter/ |
|
|
|
*/ |
|
#ifndef __PMAPPLICATION__ |
|
#define __PMAPPLICATION__ |
|
|
|
#ifndef __PMCORE__ |
|
#include <PMCore.h> |
|
#endif |
|
|
|
#ifndef __DIALOGS__ |
|
#include <Dialogs.h> |
|
#endif |
|
|
|
|
|
|
|
|
|
#if PRAGMA_ONCE |
|
#pragma once |
|
#endif |
|
|
|
#ifdef __cplusplus |
|
extern "C" { |
|
#endif |
|
|
|
#if PRAGMA_IMPORT |
|
#pragma import on |
|
#endif |
|
|
|
/* Callbacks */ |
|
typedef CALLBACK_API( void , PMItemProcPtr )(DialogRef theDialog, short item); |
|
typedef CALLBACK_API( void , PMPrintDialogInitProcPtr )(PMPrintSettings printSettings, PMDialog *theDialog); |
|
typedef CALLBACK_API( void , PMPageSetupDialogInitProcPtr )(PMPageFormat pageFormat, PMDialog *theDialog); |
|
typedef CALLBACK_API( void , PMSheetDoneProcPtr )(PMPrintSession printSession, WindowRef documentWindow, Boolean accepted); |
|
typedef STACK_UPP_TYPE(PMItemProcPtr) PMItemUPP; |
|
typedef STACK_UPP_TYPE(PMPrintDialogInitProcPtr) PMPrintDialogInitUPP; |
|
typedef STACK_UPP_TYPE(PMPageSetupDialogInitProcPtr) PMPageSetupDialogInitUPP; |
|
typedef STACK_UPP_TYPE(PMSheetDoneProcPtr) PMSheetDoneUPP; |
|
/* |
|
* NewPMItemUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( PMItemUPP ) |
|
NewPMItemUPP(PMItemProcPtr userRoutine); |
|
|
|
/* |
|
* NewPMPrintDialogInitUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( PMPrintDialogInitUPP ) |
|
NewPMPrintDialogInitUPP(PMPrintDialogInitProcPtr userRoutine); |
|
|
|
/* |
|
* NewPMPageSetupDialogInitUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( PMPageSetupDialogInitUPP ) |
|
NewPMPageSetupDialogInitUPP(PMPageSetupDialogInitProcPtr userRoutine); |
|
|
|
/* |
|
* NewPMSheetDoneUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.1 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( PMSheetDoneUPP ) |
|
NewPMSheetDoneUPP(PMSheetDoneProcPtr userRoutine); |
|
|
|
/* |
|
* DisposePMItemUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
DisposePMItemUPP(PMItemUPP userUPP); |
|
|
|
/* |
|
* DisposePMPrintDialogInitUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
DisposePMPrintDialogInitUPP(PMPrintDialogInitUPP userUPP); |
|
|
|
/* |
|
* DisposePMPageSetupDialogInitUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
DisposePMPageSetupDialogInitUPP(PMPageSetupDialogInitUPP userUPP); |
|
|
|
/* |
|
* DisposePMSheetDoneUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.1 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
DisposePMSheetDoneUPP(PMSheetDoneUPP userUPP); |
|
|
|
/* |
|
* InvokePMItemUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
InvokePMItemUPP( |
|
DialogRef theDialog, |
|
short item, |
|
PMItemUPP userUPP); |
|
|
|
/* |
|
* InvokePMPrintDialogInitUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
InvokePMPrintDialogInitUPP( |
|
PMPrintSettings printSettings, |
|
PMDialog * theDialog, |
|
PMPrintDialogInitUPP userUPP); |
|
|
|
/* |
|
* InvokePMPageSetupDialogInitUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
InvokePMPageSetupDialogInitUPP( |
|
PMPageFormat pageFormat, |
|
PMDialog * theDialog, |
|
PMPageSetupDialogInitUPP userUPP); |
|
|
|
/* |
|
* InvokePMSheetDoneUPP() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.1 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API_C( void ) |
|
InvokePMSheetDoneUPP( |
|
PMPrintSession printSession, |
|
WindowRef documentWindow, |
|
Boolean accepted, |
|
PMSheetDoneUPP userUPP); |
|
|
|
#if PM_USE_SESSION_APIS |
|
#else |
|
/* Print loop */ |
|
/* |
|
* PMBeginDocument() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMBeginDocument( |
|
PMPrintSettings printSettings, |
|
PMPageFormat pageFormat, |
|
PMPrintContext * printContext); |
|
|
|
|
|
/* |
|
* PMEndDocument() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMEndDocument(PMPrintContext printContext); |
|
|
|
|
|
/* |
|
* PMBeginPage() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMBeginPage( |
|
PMPrintContext printContext, |
|
const PMRect * pageFrame); |
|
|
|
|
|
/* |
|
* PMEndPage() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMEndPage(PMPrintContext printContext); |
|
|
|
|
|
/* Printing Dialogs */ |
|
/* |
|
* PMPageSetupDialog() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPageSetupDialog( |
|
PMPageFormat pageFormat, |
|
Boolean * accepted); |
|
|
|
|
|
/* |
|
* PMPrintDialog() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPrintDialog( |
|
PMPrintSettings printSettings, |
|
PMPageFormat constPageFormat, |
|
Boolean * accepted); |
|
|
|
|
|
/* |
|
* PMPageSetupDialogInit() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPageSetupDialogInit( |
|
PMPageFormat pageFormat, |
|
PMDialog * newDialog); |
|
|
|
|
|
/************************/ |
|
/* PMPrintDialogInit is not recommended. You should instead use */ |
|
/* PMPrintDialogInitWithPageFormat or PMSessionPrintDialogInit */ |
|
/************************/ |
|
/* |
|
* PMPrintDialogInit() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPrintDialogInit( |
|
PMPrintSettings printSettings, |
|
PMDialog * newDialog); |
|
|
|
|
|
/* |
|
* PMPrintDialogInitWithPageFormat() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.1 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPrintDialogInitWithPageFormat( |
|
PMPrintSettings printSettings, |
|
PMPageFormat constPageFormat, |
|
PMDialog * newDialog); |
|
|
|
|
|
/* |
|
* PMPrintDialogMain() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPrintDialogMain( |
|
PMPrintSettings printSettings, |
|
PMPageFormat constPageFormat, |
|
Boolean * accepted, |
|
PMPrintDialogInitUPP myInitProc); |
|
|
|
|
|
/* |
|
* PMPageSetupDialogMain() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMPageSetupDialogMain( |
|
PMPageFormat pageFormat, |
|
Boolean * accepted, |
|
PMPageSetupDialogInitUPP myInitProc); |
|
|
|
|
|
#endif /* PM_USE_SESSION_APIS */ |
|
|
|
/* Printing Dialog accessors */ |
|
/* |
|
* PMGetDialogPtr() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMGetDialogPtr( |
|
PMDialog pmDialog, |
|
DialogRef * theDialog); |
|
|
|
|
|
#define PMGetDialogRef PMGetDialogPtr |
|
/* |
|
* PMGetModalFilterProc() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMGetModalFilterProc( |
|
PMDialog pmDialog, |
|
ModalFilterUPP * filterProc); |
|
|
|
|
|
/* |
|
* PMSetModalFilterProc() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMSetModalFilterProc( |
|
PMDialog pmDialog, |
|
ModalFilterUPP filterProc); |
|
|
|
|
|
/* |
|
* PMGetItemProc() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMGetItemProc( |
|
PMDialog pmDialog, |
|
PMItemUPP * itemProc); |
|
|
|
|
|
/* |
|
* PMSetItemProc() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMSetItemProc( |
|
PMDialog pmDialog, |
|
PMItemUPP itemProc); |
|
|
|
|
|
/* |
|
* PMGetDialogAccepted() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMGetDialogAccepted( |
|
PMDialog pmDialog, |
|
Boolean * process); |
|
|
|
|
|
/* |
|
* PMSetDialogAccepted() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMSetDialogAccepted( |
|
PMDialog pmDialog, |
|
Boolean process); |
|
|
|
|
|
/* |
|
* PMGetDialogDone() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMGetDialogDone( |
|
PMDialog pmDialog, |
|
Boolean * done); |
|
|
|
|
|
/* |
|
* PMSetDialogDone() |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: in CarbonLib 1.0 and later |
|
* Mac OS X: in version 10.0 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMSetDialogDone( |
|
PMDialog pmDialog, |
|
Boolean done); |
|
|
|
|
|
/* Presets */ |
|
/* |
|
* PMSessionEnablePrinterPresets() |
|
* |
|
* Summary: |
|
* Enable the use of printer presets in the print dialog. |
|
* |
|
* Discussion: |
|
* Displaying the print dialog on a session after making this call |
|
* will show the presets available for the specified graphis type. |
|
* In addition this call will enable the use of the simplified print |
|
* dialog. On OS 9 this function returns kPMNotImplemented. |
|
* |
|
* Parameters: |
|
* |
|
* session: |
|
* The session that will be used to present the print dialog. |
|
* |
|
* graphicsType: |
|
* The printer presets in the dialog should be suitable for |
|
* rendering this type of graphic. Currently defined graphics |
|
* types are: "Photo" |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later |
|
* Mac OS X: in version 10.2 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMSessionEnablePrinterPresets( |
|
PMPrintSession session, |
|
CFStringRef graphicsType); |
|
|
|
|
|
/* |
|
* PMSessionDisablePrinterPresets() |
|
* |
|
* Summary: |
|
* Disable the use of printer presets in the print dialog. |
|
* |
|
* Discussion: |
|
* On OS 9 this function returns noErr since presets are never used |
|
* in that OS. |
|
* |
|
* Parameters: |
|
* |
|
* session: |
|
* The session that will be used to present the print dialog. |
|
* |
|
* Availability: |
|
* Non-Carbon CFM: not available |
|
* CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later |
|
* Mac OS X: in version 10.2 and later |
|
*/ |
|
EXTERN_API( OSStatus ) |
|
PMSessionDisablePrinterPresets(PMPrintSession session); |
|
|
|
|
|
|
|
#ifdef PRAGMA_IMPORT_OFF |
|
#pragma import off |
|
#elif PRAGMA_IMPORT |
|
#pragma import reset |
|
#endif |
|
|
|
#ifdef __cplusplus |
|
} |
|
#endif |
|
|
|
#endif /* __PMAPPLICATION__ */ |
|
|
|
|