[Previous]
[Up]
[Next]
NSPrintOperation
Authors
- Fred Kiefer
-
- Adam Fedor
-
Controls generation of EPS, PDF or PS print jobs.
Copyright: (C) 1996 Free Software Foundation, Inc.
NSPrintOperation controls printing of an
NSView. When invoked normally it will (optionally)
display a standard print panel (NSPrintPanel), and
based on the information entered by the user here as well
as information about page layout (see NSPageLayout) tells
the NSView to print it's contents. NSPrintOperation works
with the NSView to paginate the output into appropriately
sized and oriented pages and finally delivers the result
to the appropriate place, whether it be a printer, and
PostScript file, or another output.
Declared in: ../../Headers/gnustep/gui/NSPrintOperation.h
Inherits from: NSObject
Instance Variables
Methods
Class Methods
+ (NSPrintOperation*) EPSOperationWithView: (NSView*)aView insideRect: (NSRect)rect toData: (NSMutableData*)data;
+ (NSPrintOperation*) EPSOperationWithView: (NSView*)aView insideRect: (NSRect)rect toData: (NSMutableData*)data printInfo: (NSPrintInfo*)aPrintInfo;
+ (NSPrintOperation*) EPSOperationWithView: (NSView*)aView insideRect: (NSRect)rect toPath: (NSString*)path printInfo: (NSPrintInfo*)aPrintInfo;
+ (NSPrintOperation*) PDFOperationWithView: (NSView*)aView insideRect: (NSRect)rect toData: (NSMutableData*)data;
+ (NSPrintOperation*) PDFOperationWithView: (NSView*)aView insideRect: (NSRect)rect toData: (NSMutableData*)data printInfo: (NSPrintInfo*)aPrintInfo;
+ (NSPrintOperation*) PDFOperationWithView: (NSView*)aView insideRect: (NSRect)rect toPath: (NSString*)path printInfo: (NSPrintInfo*)aPrintInfo;
+ (NSPrintOperation*) currentOperation;
Returns the NSPrintOperation object that is
currently performing a print operation (if any).
+ (NSPrintOperation*) printOperationWithView: (NSView*)aView;
+ (NSPrintOperation*) printOperationWithView: (NSView*)aView printInfo: (NSPrintInfo*)aPrintInfo;
+ (void) setCurrentOperation: (NSPrintOperation*)operation;
Set the current NSPrintOperation to the supplied
operation object. As this is currently
implemented, if a NSPrintOperation is
currently running, that operation is
lost (along with any associated context), so be
careful to call this only when there is no current
operation.
Instances Methods
- (NSView*) accessoryView;
Returns the accessory view used by the NSPrintPanel
associated with the receiver.
- (void) cleanUpOperation;
Called by the print operation and it has finished
running a printing operation.
- (NSGraphicsContext*) context;
Returns the graphic contexts used by the print
operation.
- (NSGraphicsContext*) createContext;
This method is used by the print operation to create a
special graphics context for use while running the
print operation.
- (int) currentPage;
Returns the page currently being printing. Returns
0 if no page is currently being printed
- (BOOL) deliverResult;
Called by the print operation to deliver the results
of the printing operation. This might include sending
the output to a printer, a file or a previewing
program. Returns YES if the output
was delivered sucessfully.
- (void) destroyContext;
This method is used by the print operation to destroy
the special graphic context used while running the
print operation.
- (id) initEPSOperationWithView: (NSView*)aView insideRect: (NSRect)rect toData: (NSMutableData*)data printInfo: (NSPrintInfo*)aPrintInfo;
- (id) initWithView: (NSView*)aView printInfo: (NSPrintInfo*)aPrintInfo;
- (BOOL) isCopyingOperation;
- (BOOL) isEPSOperation;
Returns YES if the receiver is
performing an operation whose output is EPS
format.
- (NSPrintingPageOrder) pageOrder;
Returns the page order of printing.
- (NSPrintInfo*) printInfo;
Returns the NSPrintInfo object associated with the
receiver.
- (NSPrintPanel*) printPanel;
Returns the NSPrintPanel associated with the
receiver.
- (BOOL) runOperation;
Call this message to run the print operation on a
view. This includes (optionally) displaying a print
panel and working with the NSView to paginate and
draw the contents of the view.
- (void) runOperationModalForWindow: (NSWindow*)docWindow delegate: (id)delegate didRunSelector: (SEL)didRunSelector contextInfo: (void*)contextInfo;
Run a print operation modally with respect to a window.
- (void) setAccessoryView: (NSView*)aView;
Set the accessory view used by the NSPrintPanel
associated with the receiver.
- (void) setPageOrder: (NSPrintingPageOrder)order;
Set the page order used when printing.
- (void) setPrintInfo: (NSPrintInfo*)aPrintInfo;
Set the NSPrintInfo object associated with the
receiver.
- (void) setPrintPanel: (NSPrintPanel*)panel;
Sets the NSPrintPanel used by the receiver obtaining
and displaying printing information from/to the user.
- (void) setShowPanels: (BOOL)flag;
Use this to set whether a print panel is displayed
during a printing operation. If set to
NO, then the receiver uses information
that was previously set and does not display any
status information about the progress of the
printing operation.
- (BOOL) showPanels;
Returns YES if the reciever display an
NSPrintPanel and other information when
running a print operation.
- (NSView*) view;
Return the view that is the being printed.