ImagePrint/ImagePrintUI/imageprinteng/src/cimageprint.cpp
branchGCC_SURGE
changeset 25 59ea2209bb67
parent 23 08cc4cc059d4
parent 15 a92d00fca574
--- a/ImagePrint/ImagePrintUI/imageprinteng/src/cimageprint.cpp	Fri Jun 11 16:24:10 2010 +0100
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,324 +0,0 @@
-/*
-* Copyright (c) 2004-2007 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:  
-*
-*/
-
-
-#include "cimageprint.h"
-#include "cidleguard.h"
-#include "cdiscoveryguard.h"
-#include "cjobguard.h"
-#include "clog.h"
-
-const static TInt KImagePrintVersionMajor = 0;
-const static TInt KImagePrintVersionMinor = 0;
-const static TInt KImagePrintVersionBuild = 231;
-
-/**********************
-Public member functions
-**********************/
-
-CImagePrint::CImagePrint ()
-	{	
-	}
-
-/// Destructor.
-CImagePrint::~CImagePrint ()
-	{
-	LOG("CImagePrint::~CImagePrint BEGIN");
-	delete iDiscoveryGuard;				
-	delete iIdleGuard;
-	delete iJobGuard;
-	CCoeEnv::Static()->RemoveForegroundObserver( *this );	
-    iClient.Close();
-    LOG("CImagePrint::~CImagePrint END");
-	}
-
-/**
- * @brief Initialize the server.
- */
-void CImagePrint::ConnectL()
-	{	
-	if( iClient.Handle() == KNullHandle )
-		{
-		User::LeaveIfError( iClient.ConnectL() );
-		iIdleGuard = CIdleGuard::NewL( iClient );
-		iDiscoveryGuard  = CDiscoveryGuard::NewL( iClient );
-		iJobGuard = CJobGuard::NewL( iClient );
-		User::LeaveIfError( iClient.ReserveEngine() );
-		iClient.SetForeground( ETrue );	//For aiw cases
-		CCoeEnv::Static()->AddForegroundObserverL( *this );
-		}
-	}
-
-/**
- * @brief Shutdown the server.
- */
-void CImagePrint::Close()
-	{
-	iClient.ReleaseEngine();
-	}
-
-/**
- * @brief Returns the current version of the Image Print Server
- * @return The current version of the Image Print Server
- */
-TVersion CImagePrint::Version()
-	{
-	return TVersion(KImagePrintVersionMajor, KImagePrintVersionMinor, KImagePrintVersionBuild);  // Julian Day,  August 18.
-	}
-
-/**
- *	@brief Starts the discovery process.
- *
- *  Starts printer discovery on specified printer plug-ins. This is an asynchronous call that will use the 
- *  supplied MPrinterDiscoveryObserver to signal the client when Printers are found and upon error or successful completion.
- *
- *	@param aObserver The discovery observer.
- *	@param aProtocols Used to indicate what protocols to search for. 0 = all, 1 = BPP, 2 = BIP, 4 = OPP_Printer, 8 = DPOF, 16 = PB, 32 = OPP_PC
- *	@return Any standard Symbian error code. 
- *      @sa KImagePrint_PrinterProtocol_BPP @sa KImagePrint_PrinterProtocol_BIP @sa KImagePrint_PrinterProtocol_OPP_Printer 
- *      @sa KImagePrint_PrinterProtocol_DPOF @sa KImagePrint_PrinterProtocol_PictBridge @sa KImagePrint_PrinterProtocol_OPP_PC
- */
-TInt CImagePrint::StartDiscoveryL(MPrinterDiscoveryObserver& aObserver, TUint aProtocols)
-	{	
-	return iDiscoveryGuard->Guard( aObserver, aProtocols );	
-	}
-
-/** 
- * Cancels printer discovery on all printer plug-ins. This is an asynchronous call 
- *   that will use the MPrinterDiscoveryObserver previously supplied by 
- *   CImagePrint::StartDiscoveryL to signal the client upon error or successful completion.
- * @brief Cancels the discovery process.
- * @return \c KErrNone if cancel was successfully submitted, otherwise another of the system-wide error codes.
- */
-TInt CImagePrint::CancelDiscovery()
-	{
-	return iClient.CancelDiscovery();
-	}
-
-/**
- *	Creates a print job using the default settings and template. All job information beyond the images and Printer are set to the defaults of the printer. 
- *	If the Printer Discovery process is ongoing when \c CreatePrintJobL is received, Printer Discovery is terminated, without sending a notification event to the Client.
- *	@brief Creates a print job in the specified printer.
- *	@param[in] aPrinterID The exposed ID of the printer where the client wishes to create the print job.
- *	@param aImages Array containing the full names of the files to print.
- *	@param aObserver The print event observer.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- *  @note Only one print job can be active at a time.  The Print Job must be created before any 
- *      print job related functions are called.  These functions include changing settings, preview, job submission, canceling, or getting status.
- */
-TInt CImagePrint::CreatePrintJobL(TInt aPrinterID, RPointerArray<TDesC>& aImages, MPrintEventObserver& aObserver)
-	{	
-	return iJobGuard->Guard(aPrinterID, aImages, aObserver);
-	}
-
-/**
- *	@brief Submits a print job already created.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- *  @note The actual job execution is asynchronous so this function returns immediately. If successful, notification of job status and job completion is received by the client through the MPrintEventObserver.
- */
-TInt CImagePrint::SubmitPrintJobL()
-	{	
-	return iClient.SubmitPrintJob();	
-	}
-
-/**
- *	@brief Cancels the print job.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- *  @note This is an asynchronous command.  MPrintEventObserver::PrintJobProgressEvent will be called with the status of TPrintJobProgressEventStatus::EDone when the cancellation is completed.
- *  @note The notification can potentially be received by the client before this command returns to the client.
- */
-TInt CImagePrint::CancelPrintJob()
-	{
-	LOG("CImagePrint::CancelPrintJob");
-	return iClient.CancelPrintJob();
-	}
-
-/**
- *	@brief Continues printing and / or submitting a print job. Implementation may vary from protocol to protocol.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::ContinuePrintJobL()
-	{
-	return iClient.ContinuePrintJob();		
-	}
-
-/**
- *	@brief Gets the number of pages to be printed.
- *	@return Number of pages to print. 
- */
-TInt CImagePrint::GetNumPrintPages()
-	{
-	return iClient.GetNumPrintPages();
-	}
-
-/**
- *	@brief Gets the status of the printing job created.
- *	@return Printing job status.
- */
-TInt CImagePrint::GetJobStatus()
-	{
-	return iClient.GetJobStatus();
-	}
-
-/**
- *	@brief Gets the status of the printer.
- *	@param[in] aPrinterID The exposed ID of the printer the client wants to know about.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::GetPrinterStatus( TInt aPrinterID )
-	{
-	return iClient.GetPrinterStatus( aPrinterID );
-	}
-
-/**
- *	@brief Gets the IDs of the capabilities supported by the printer specified.
- *	@param[in] aPrinterID The exposed ID of the printer the client wants to know about.
- *	@param[out] aCapabilityIDs Array containing the ID's of the capabilities of the specified printer.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::GetPrinterCapabilityIDsL(TInt aPrinterID, RArray<TInt>& aCapabilityIDs)
-	{	
-	return iClient.GetPrinterCapabilityIDs(aPrinterID, aCapabilityIDs);
-	}
-
-/**
- *	@brief Gets the detail of a certain capability of a certain printer.
- *	@param[in] aPrinterID The exposed ID of the printer the client wants to know about.
- *	@param[in] aCapabilityID ID of the capability of interest.
- *	@param[out] aCapability Capability information.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::GetPrinterCapabilityL(TInt aPrinterID, TInt aCapabilityID, TPrintCapability& aCapability)
-	{
-	return iClient.GetPrinterCapability(aPrinterID, aCapabilityID, aCapability);
-	}
-
-/**
- *	@brief Gets a setting configured for the created print job.
- *	@param[in] aCapabilityID ID of the capability of interest.
- *	@param[out] aValue Capability value.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::GetJobSetting(TInt aCapabilityID, TInt& aValue)
-	{	
-	return iClient.GetJobSetting(aCapabilityID, aValue);
-	}
-
-/**
- *	@brief Sets a print job setting.
- *	@param[in] aCapabilityID ID of the capability of interest.
- *	@param[in] aValue New capability value.
- *	@param[out] aAffectedCapability ID of any affected capability.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::SetJobSettingL(TInt aCapabilityID, TInt aValue, TInt& aAffectedCapability)
-	{
-	return iClient.SetJobSetting(aCapabilityID, aValue, aAffectedCapability);
-	}
-
-/**
- *	@brief Gets the number of pages in the preview.
- *	@return Number of pages in the preview. 
- */
-TInt CImagePrint::GetNumPreviewPages()
-	{	
-	return iClient.GetNumPreviewPages();	
-	}
-
-/**
- *	@brief Gets the icon representing a given layout or template.
- *	@param[in] aTemplateID ID of the template / layout of interest.
- *	@param[out] aFbsBitmapHandle Handle to the appropriate bitmap.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::GetJobTemplateIconL(TInt /*aTemplateID*/, TInt& /*aFbsBitmapHandle*/)
-	{
-	return KErrNotSupported;	
-	}
-
-/**
- *	@brief Gets number of copies for each image.
- *	@param[out] aArray contains number of copies for each image.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::GetNumberOfCopies( RArray<TInt>& /*aArray*/ )
-    {
-    return KErrNotSupported;
-    }
-
-/**
- *	@brief Sets number of copies for each image.
- *	@param[in] aArray contains number of copies for each image.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::SetNumberOfCopies( const RArray<TInt>& aArray )
-    {
-    return iClient.SetNumberOfCopies( aArray );
-    }
-
-/**
- *	@brief Creates a preview image.
- *	@param[in] aPageNumber Page number to create preview image of.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.
- */
-TInt CImagePrint::CreatePreviewImage(TInt /*aPageNumber*/)
-	{
-	return KErrNotSupported;		
-	}
-
-/**
- *	@brief Removes a specified cached printer.
- *	@param[in] aPrinterID The exposed ID of the printer the client wants to remove.
- *	@return Any standard Symbian error code or KErrInvalidSequence / KErrInvalidData.k
- */
-TInt CImagePrint::RemoveCachedPrinterL(TInt aPrinterID)
-	{	
-	return iClient.RemoveCachedPrinter( aPrinterID );	
-	}
-
-/**
- *	@brief Returns the Protocols supported by the DLL. It can be any of the KImagePrint_PrinterProtocol* constants.
- *	@return An OR'ed value with the supported protocols information.
- *	@sa KImagePrint_PrinterProtocol_BPP @sa KImagePrint_PrinterProtocol_BIP @sa KImagePrint_PrinterProtocol_OPP 
- *	@sa KImagePrint_PrinterProtocol_DPOF @sa KImagePrint_PrinterProtocol_PictBridge
- */
-TUint CImagePrint::SupportedProtocols()
-	{
-	return iClient.SupportedProtocols();
-	}
-
-/**
- *  @brief Registers the IdleObserver to send idle event notifications
- *  @param A pointer to an object implementing MIdleObserver interface that will be notified of events
- *  @note In order to stop sending notifications, send NULL as the parameter.
- */
-void CImagePrint::RegisterIdleObserver(MIdleObserver *aObserver)
-	{
-	iIdleGuard->Guard( aObserver );
-	}
-
-void CImagePrint::HandleGainingForeground()
-	{
-	iClient.SetForeground( ETrue );
-	}
-	
-void CImagePrint::HandleLosingForeground()
-	{
-	iClient.SetForeground( EFalse );
-	}
-
-//  End of File