printingsupport/printinguisupport/inc/PRNSETUP.H
changeset 0 2e3d3ce01487
child 35 13fd6fd25fe7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/printingsupport/printinguisupport/inc/PRNSETUP.H	Tue Feb 02 10:12:00 2010 +0200
@@ -0,0 +1,171 @@
+// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __PRNSETUP_H__
+#define __PRNSETUP_H__
+
+#if !defined(__E32STD_H__)
+#include <e32std.h>
+#endif
+#if !defined(__E32BASE_H__)
+#include <e32base.h>
+#endif
+#if !defined(__FLDBLTIN_H__)
+#include <fldbltin.h>
+#endif
+#if !defined(__PRNINF_H__)
+#include <prninf.h>
+#endif
+
+#ifndef SYMBIAN_ENABLE_MIXED_HEADERS
+#include <printinguisupport/prnpath.h>
+#endif
+
+/** 
+@publishedAll 
+@released */
+const TInt KErrMorePages=4747; // Leave with this error code to print extra pages in PrintBandL
+
+// Classes defined //
+class CPrintSetup;
+//
+
+// Forward Reference
+class CPreviewProcess;
+class CPrintProcess;
+class CPdrModelList;
+class CPdrDevice;
+class CHeaderFooter;
+class TPageSpec;
+class RReadStream;
+class RWriteStream;
+class MPageRegionPrinter;
+class RFs;
+class CPrinterDriver;
+class CPrinterDriverUI;
+//
+
+class CPrintSetup : public CBase, private MFieldPageNumInfo
+/** Print setup information.
+
+This class stores the information needed to set up, start and stop a print 
+job. This includes the target printer device, the page margins and 
+the header and footer. The page specification, (page orientation and page 
+dimensions) can be set via the printer device.
+
+Print setup information is associated with a document and is stored as part 
+of the persistent form of the document. Print parameters on the other hand, 
+(class TPrintParameters) are associated with a particular print request, 
+not with the document itself, so are not part of the print setup information. 
+
+@publishedAll
+@released */
+	{
+public:
+	IMPORT_C static CPrintSetup* NewL();
+	IMPORT_C virtual ~CPrintSetup();
+	//
+	// printer model selection/control functions
+	IMPORT_C void AddPrinterDriverDirL(const TDesC& aDriverDir);
+	IMPORT_C CPrinterModelList* ModelNameListL(RFs& aFs);
+	IMPORT_C void FreeModelList();
+	IMPORT_C void CreatePrinterDeviceL(TInt aModelIndex); // requires ModelList to exist
+	IMPORT_C void CreatePrinterDeviceL(TUid aModelUid,RFs& aFs);
+	IMPORT_C CPrinterDevice* PrinterDevice()const;
+	IMPORT_C CPrinterDriverUI* CreatePrinterDriverUIL(); // ownership is transfered to the caller
+	//
+	// print functions
+	IMPORT_C void EndPrint();
+	IMPORT_C TInt StartPrintL(const TPrintParameters& aPrintParams,MPageRegionPrinter& aBodyPrinter,
+				CPrinterPort* aPort,MPrintProcessObserver* anObserver);
+	IMPORT_C TInt StartPreviewPrintL(const TPrintParameters& aPrintParams,MPageRegionPrinter& aBodyPrinter,
+				MPrintProcessObserver* anObserver,CGraphicsDevice& aPreviewDev,const TRect& aHeaderRectInPixels,
+				const TRect& aFooterRectInPixels,TInt aNumBands);
+	//
+	// accessors
+	inline CHeaderFooter* Header()const;
+	inline CHeaderFooter* Footer()const;
+	//
+	// persistence
+	IMPORT_C TStreamId StoreL(CStreamStore& aStore)const;
+	IMPORT_C void RestoreL(const CStreamStore& aStore,TStreamId aStreamId,const MFieldFileNameInfo* aFileNameInfo=NULL,const MFieldNumPagesInfo* aNumPagesInfo=NULL,MPictureFactory* aFactory=NULL);
+	IMPORT_C void StoreComponentsL(CStreamStore& aStore,CStoreMap& aMap)const;
+	IMPORT_C void RestoreComponentsL(const CStreamStore& aStore,const MFieldFileNameInfo* aFileNameInfo=NULL,const MFieldNumPagesInfo* aNumPagesInfo=NULL,MPictureFactory* aFactory=NULL);
+	IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
+	IMPORT_C void InternalizeL(RReadStream& aStream);
+	//
+private:
+	CPrintSetup();
+	void ConstructL();
+	void DoStartPrintL(const TPrintParameters& aPrintParams,MPageRegionPrinter& aBodyPrinter,MPrintProcessObserver* aObserver,CPrinterPort* aPort);
+	void InitializePrintingL(CGraphicsDevice* aPrinterDev,const TPrintParameters& aPrintParams,MPrintProcessObserver* aObserver);
+	void InitializePrintingL(const TPrintParameters& aPrintParams,MPrintProcessObserver* aObserver,
+									 const TRect& aHeaderRectInPixels,const TRect& aFooterRectInPixels);
+	// from MFieldPageNumInfo
+	TInt UpdateFieldPageNum()const;
+public:
+	// Info regarding print setup etc.
+	/** The header and footer offset and the width of the four margins. 
+	
+	All measurements are in twips.
+	
+	@see TPageMargins */
+	TPageMargins iPageMarginsInTwips;
+	/** The number of the first page in the document.
+	
+	This value is used for printing or displaying page numbering. Note that all 
+	other page numbering is zero indexed, to preserve independence from user-defined 
+	page numbering. */
+	TInt iNumOfFirstPage; // value to start page numbering at
+private:
+	enum {
+		ENumberFirstPage = 0x0001,
+		};
+private:
+	CHeaderFooter* iHeader;
+	CHeaderFooter* iFooter;
+	CPrinterDriver* iPrinterDriver; // the target printer driver
+	CPreviewProcess* iPrintProcess;
+	CPdrModelList* iModelList;
+	MPrintProcessObserver* iPrintObserver;
+	TPrintParameters iPrintParams; // not persisted
+	CArrayFixSeg<TFileName>* iDriverDirList;
+	};
+
+
+//
+// inlines
+//
+
+inline CHeaderFooter* CPrintSetup::Header()const
+/** Gets the header.
+
+The CPrintSetup object owns the header and footer. CPrintSetup implements 
+the MFieldPageNumInfo interface, which allows page numbering to be easily 
+added to fields.
+
+@return The header. */
+	{ return iHeader; }
+
+inline CHeaderFooter* CPrintSetup::Footer()const
+/** Gets the footer.
+
+@return The footer. */
+	{ return iFooter; }
+
+
+
+
+#endif