xref: /AOO41X/main/sfx2/source/doc/printhelper.cxx (revision cdf0e10c4e3984b49a9502b011690b615761d4a3)

/*************************************************************************
 *
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * Copyright 2000, 2010 Oracle and/or its affiliates.
 *
 * OpenOffice.org - a multi-platform office productivity suite
 *
 * This file is part of OpenOffice.org.
 *
 * OpenOffice.org is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License version 3
 * only, as published by the Free Software Foundation.
 *
 * OpenOffice.org is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License version 3 for more details
 * (a copy is included in the LICENSE file that accompanied this code).
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 3 along with OpenOffice.org.  If not, see
 * <http://www.openoffice.org/license.html>
 * for a copy of the LGPLv3 License.
 *
 ************************************************************************/

// MARKER(update_precomp.py): autogen include statement, do not remove
#include "precompiled_sfx2.hxx"

#include "printhelper.hxx"

#include <com/sun/star/view/XPrintJob.hpp>
#include <com/sun/star/awt/Size.hpp>
#include <com/sun/star/lang/IllegalArgumentException.hpp>
#include <com/sun/star/view/PaperFormat.hpp>
#include <com/sun/star/view/PaperOrientation.hpp>
#include <com/sun/star/ucb/NameClash.hpp>
#include <com/sun/star/lang/XUnoTunnel.hpp>
#include <com/sun/star/frame/XModel.hpp>
#include <com/sun/star/lang/EventObject.hpp>
#include <com/sun/star/view/DuplexMode.hpp>

#include <svl/lstner.hxx>
#include <svl/stritem.hxx>
#include <svl/intitem.hxx>
#include <svl/eitem.hxx>
#include <unotools/tempfile.hxx>
#include <unotools/localfilehelper.hxx>
#include <osl/file.hxx>
#include <osl/thread.hxx>
#include <tools/urlobj.hxx>
#include <ucbhelper/content.hxx>
#include <cppuhelper/interfacecontainer.hxx>
#include <vos/mutex.hxx>
#include <cppuhelper/implbase1.hxx>

#include <sfx2/viewfrm.hxx>
#include <sfx2/viewsh.hxx>
#include <sfx2/dispatch.hxx>
#include <sfx2/request.hxx>
#include <sfx2/printer.hxx>
#include <sfx2/app.hxx>
#include <sfx2/objsh.hxx>
#include <sfx2/event.hxx>

using namespace ::com::sun::star;
using namespace ::com::sun::star::uno;

struct IMPL_PrintListener_DataContainer : public SfxListener
{
    SfxObjectShellRef                               m_pObjectShell;
    ::cppu::OMultiTypeInterfaceContainerHelper      m_aInterfaceContainer;
    uno::Reference< com::sun::star::view::XPrintJob>     m_xPrintJob;
	::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > m_aPrintOptions;

    IMPL_PrintListener_DataContainer( ::osl::Mutex& aMutex)
            :   m_pObjectShell          ( 0 )
            ,   m_aInterfaceContainer   ( aMutex )
	{
	}


	void Notify(			SfxBroadcaster&	aBC		,
					const	SfxHint&		aHint	) ;
};

awt::Size impl_Size_Object2Struct( const Size& aSize )
{
    awt::Size aReturnValue;
	aReturnValue.Width  = aSize.Width()  ;
	aReturnValue.Height = aSize.Height() ;
	return aReturnValue ;
}

Size impl_Size_Struct2Object( const awt::Size& aSize )
{
	Size aReturnValue;
	aReturnValue.Width()  = aSize.Width  ;
	aReturnValue.Height() = aSize.Height ;
	return aReturnValue ;
}

class SfxPrintJob_Impl : public cppu::WeakImplHelper1
<
	com::sun::star::view::XPrintJob
>
{
        IMPL_PrintListener_DataContainer* m_pData;

public:
        SfxPrintJob_Impl( IMPL_PrintListener_DataContainer* pData );
    	virtual Sequence< ::com::sun::star::beans::PropertyValue > SAL_CALL getPrintOptions(  ) throw (RuntimeException);
    	virtual Sequence< ::com::sun::star::beans::PropertyValue > SAL_CALL getPrinter(  ) throw (RuntimeException);
    	virtual Reference< ::com::sun::star::view::XPrintable > SAL_CALL getPrintable(  ) throw (RuntimeException);
		virtual void SAL_CALL cancelJob() throw (RuntimeException);
};

SfxPrintJob_Impl::SfxPrintJob_Impl( IMPL_PrintListener_DataContainer* pData )
	: m_pData( pData )
{
}

Sequence< ::com::sun::star::beans::PropertyValue > SAL_CALL SfxPrintJob_Impl::getPrintOptions() throw (RuntimeException)
{
	return m_pData->m_aPrintOptions;
}

Sequence< ::com::sun::star::beans::PropertyValue > SAL_CALL SfxPrintJob_Impl::getPrinter() throw (RuntimeException)
{
	if( m_pData->m_pObjectShell.Is() )
	{
		Reference < view::XPrintable > xPrintable( m_pData->m_pObjectShell->GetModel(), UNO_QUERY );
		if ( xPrintable.is() )
			return xPrintable->getPrinter();
	}
	return Sequence< ::com::sun::star::beans::PropertyValue >();
}

Reference< ::com::sun::star::view::XPrintable > SAL_CALL SfxPrintJob_Impl::getPrintable() throw (RuntimeException)
{
	Reference < view::XPrintable > xPrintable( m_pData->m_pObjectShell.Is() ? m_pData->m_pObjectShell->GetModel() : NULL, UNO_QUERY );
	return xPrintable;
}

void SAL_CALL SfxPrintJob_Impl::cancelJob() throw (RuntimeException)
{
	// FIXME: how to cancel PrintJob via API?!
	if( m_pData->m_pObjectShell.Is() )
		m_pData->m_pObjectShell->Broadcast( SfxPrintingHint( -2 ) );
}

SfxPrintHelper::SfxPrintHelper()
{
    m_pData = new IMPL_PrintListener_DataContainer(m_aMutex);
}

void SAL_CALL SfxPrintHelper::initialize( const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Any >& aArguments ) throw (::com::sun::star::uno::Exception, ::com::sun::star::uno::RuntimeException)
{
	if ( aArguments.getLength() )
	{
        com::sun::star::uno::Reference < com::sun::star::frame::XModel > xModel;
        aArguments[0] >>= xModel;
        uno::Reference < lang::XUnoTunnel > xObj( xModel, uno::UNO_QUERY );
        uno::Sequence < sal_Int8 > aSeq( SvGlobalName( SFX_GLOBAL_CLASSID ).GetByteSequence() );
        sal_Int64 nHandle = xObj->getSomething( aSeq );
        if ( nHandle )
        {
            m_pData->m_pObjectShell = reinterpret_cast< SfxObjectShell* >( sal::static_int_cast< sal_IntPtr >( nHandle ));
            m_pData->StartListening(*m_pData->m_pObjectShell);
        }
	}
}

SfxPrintHelper::~SfxPrintHelper()
{
    delete m_pData;
}

namespace
{
    view::PaperFormat convertToPaperFormat(Paper eFormat)
    {
        view::PaperFormat eRet;
        switch (eFormat)
        {
            case PAPER_A3:
                eRet = view::PaperFormat_A3;
                break;
            case PAPER_A4:
                eRet = view::PaperFormat_A4;
                break;
            case PAPER_A5:
                eRet = view::PaperFormat_A5;
                break;
            case PAPER_B4_ISO:
                eRet = view::PaperFormat_B4;
                break;
            case PAPER_B5_ISO:
                eRet = view::PaperFormat_B5;
                break;
            case PAPER_LETTER:
                eRet = view::PaperFormat_LETTER;
                break;
            case PAPER_LEGAL:
                eRet = view::PaperFormat_LEGAL;
                break;
            case PAPER_TABLOID:
                eRet = view::PaperFormat_TABLOID;
                break;
            case PAPER_USER:
            default:
                eRet = view::PaperFormat_USER;
                break;
        }
        return eRet;
    }

    Paper convertToPaper(view::PaperFormat eFormat)
    {
        Paper eRet(PAPER_USER);
        switch (eFormat)
        {
            case view::PaperFormat_A3:
                eRet = PAPER_A3;
                break;
            case view::PaperFormat_A4:
                eRet = PAPER_A4;
                break;
            case view::PaperFormat_A5:
                eRet = PAPER_A5;
                break;
            case view::PaperFormat_B4:
                eRet = PAPER_B4_ISO;
                break;
            case view::PaperFormat_B5:
                eRet = PAPER_B5_ISO;
                break;
            case view::PaperFormat_LETTER:
                eRet = PAPER_LETTER;
                break;
            case view::PaperFormat_LEGAL:
                eRet = PAPER_LEGAL;
                break;
            case view::PaperFormat_TABLOID:
                eRet = PAPER_TABLOID;
                break;
            case view::PaperFormat_USER:
                eRet = PAPER_USER;
                break;
            case view::PaperFormat_MAKE_FIXED_SIZE:
                break;
            //deliberate no default to force warn on a new papersize
        }
        return eRet;
    }
}

//________________________________________________________________________________________________________
//	XPrintable
//________________________________________________________________________________________________________

uno::Sequence< beans::PropertyValue > SAL_CALL SfxPrintHelper::getPrinter() throw(::com::sun::star::uno::RuntimeException)
{
    // object already disposed?
    ::vos::OGuard aGuard( Application::GetSolarMutex() );

    // search for any view of this document that is currently printing
    const Printer *pPrinter = NULL;
    SfxViewFrame *pViewFrm = m_pData->m_pObjectShell.Is() ? SfxViewFrame::GetFirst( m_pData->m_pObjectShell, sal_False ) : 0;
    SfxViewFrame* pFirst = pViewFrm;
    while ( pViewFrm && !pPrinter )
    {
    	pPrinter = pViewFrm->GetViewShell()->GetActivePrinter();
        pViewFrm = SfxViewFrame::GetNext( *pViewFrm, m_pData->m_pObjectShell, sal_False );
    }

    // if no view is printing currently, use the permanent SfxPrinter instance
    if ( !pPrinter && pFirst )
    	pPrinter = pFirst->GetViewShell()->GetPrinter(sal_True);

    if ( !pPrinter )
        return uno::Sequence< beans::PropertyValue >();

    uno::Sequence< beans::PropertyValue > aPrinter(8);

	aPrinter.getArray()[7].Name = DEFINE_CONST_UNICODE( "CanSetPaperSize" );
	aPrinter.getArray()[7].Value <<= ( pPrinter->HasSupport( SUPPORT_SET_PAPERSIZE ) );

	aPrinter.getArray()[6].Name = DEFINE_CONST_UNICODE( "CanSetPaperFormat" );
	aPrinter.getArray()[6].Value <<= ( pPrinter->HasSupport( SUPPORT_SET_PAPER ) );

	aPrinter.getArray()[5].Name = DEFINE_CONST_UNICODE( "CanSetPaperOrientation" );
	aPrinter.getArray()[5].Value <<= ( pPrinter->HasSupport( SUPPORT_SET_ORIENTATION ) );

	aPrinter.getArray()[4].Name = DEFINE_CONST_UNICODE( "IsBusy" );
	aPrinter.getArray()[4].Value <<= ( pPrinter->IsPrinting() );

	aPrinter.getArray()[3].Name = DEFINE_CONST_UNICODE( "PaperSize" );
    awt::Size aSize = impl_Size_Object2Struct(pPrinter->GetPaperSize() );
	aPrinter.getArray()[3].Value <<= aSize;

	aPrinter.getArray()[2].Name = DEFINE_CONST_UNICODE( "PaperFormat" );
    view::PaperFormat eFormat = convertToPaperFormat(pPrinter->GetPaper());
	aPrinter.getArray()[2].Value <<= eFormat;

	aPrinter.getArray()[1].Name = DEFINE_CONST_UNICODE( "PaperOrientation" );
    view::PaperOrientation eOrient = (view::PaperOrientation)pPrinter->GetOrientation();
	aPrinter.getArray()[1].Value <<= eOrient;

	aPrinter.getArray()[0].Name = DEFINE_CONST_UNICODE( "Name" );
	String sStringTemp = pPrinter->GetName() ;
	aPrinter.getArray()[0].Value <<= ::rtl::OUString( sStringTemp );

	return aPrinter;
}

//________________________________________________________________________________________________________
//	XPrintable
//________________________________________________________________________________________________________

void SfxPrintHelper::impl_setPrinter(const uno::Sequence< beans::PropertyValue >& rPrinter,SfxPrinter*& pPrinter,sal_uInt16& nChangeFlags,SfxViewShell*& pViewSh)

{
	// alten Printer beschaffen
	SfxViewFrame *pViewFrm = m_pData->m_pObjectShell.Is() ?
								SfxViewFrame::GetFirst( m_pData->m_pObjectShell, sal_False ) : 0;
	if ( !pViewFrm )
		return;

	pViewSh = pViewFrm->GetViewShell();
	pPrinter = pViewSh->GetPrinter(sal_True);
	if ( !pPrinter )
		return;

	// new Printer-Name available?
	nChangeFlags = 0;
    sal_Int32 lDummy = 0;
	for ( int n = 0; n < rPrinter.getLength(); ++n )
	{
		// get Property-Value from printer description
        const beans::PropertyValue &rProp = rPrinter.getConstArray()[n];

		// Name-Property?
		if ( rProp.Name.compareToAscii( "Name" ) == 0 )
		{
			::rtl::OUString sTemp;
            if ( ( rProp.Value >>= sTemp ) == sal_False )
                throw ::com::sun::star::lang::IllegalArgumentException();

			String aPrinterName( sTemp ) ;
            if ( aPrinterName != pPrinter->GetName() )
            {
                pPrinter = new SfxPrinter( pPrinter->GetOptions().Clone(), aPrinterName );
                nChangeFlags = SFX_PRINTER_PRINTER;
            }
			break;
		}
	}

	Size aSetPaperSize( 0, 0);
    view::PaperFormat nPaperFormat = view::PaperFormat_USER;

    // other properties
	for ( int i = 0; i < rPrinter.getLength(); ++i )
	{
		// get Property-Value from printer description
        const beans::PropertyValue &rProp = rPrinter.getConstArray()[i];

		// PaperOrientation-Property?
		if ( rProp.Name.compareToAscii( "PaperOrientation" ) == 0 )
		{
            view::PaperOrientation eOrient;
            if ( ( rProp.Value >>= eOrient ) == sal_False )
            {
                if ( ( rProp.Value >>= lDummy ) == sal_False )
                    throw ::com::sun::star::lang::IllegalArgumentException();
                eOrient = ( view::PaperOrientation) lDummy;
            }

            if ( (Orientation) eOrient != pPrinter->GetOrientation() )
            {
                pPrinter->SetOrientation( (Orientation) eOrient );
                nChangeFlags |= SFX_PRINTER_CHG_ORIENTATION;
            }
		}

		// PaperFormat-Property?
		else if ( rProp.Name.compareToAscii( "PaperFormat" ) == 0 )
		{
			if ( ( rProp.Value >>= nPaperFormat ) == sal_False )
            {
                if ( ( rProp.Value >>= lDummy ) == sal_False )
                    throw ::com::sun::star::lang::IllegalArgumentException();
                nPaperFormat = ( view::PaperFormat ) lDummy;
            }

            if ( convertToPaper(nPaperFormat) != pPrinter->GetPaper() )
            {
                pPrinter->SetPaper( convertToPaper(nPaperFormat) );
                nChangeFlags |= SFX_PRINTER_CHG_SIZE;
            }
		}

		// PaperSize-Property?
		else if ( rProp.Name.compareToAscii( "PaperSize" ) == 0 )
		{
            awt::Size aTempSize ;
			if ( ( rProp.Value >>= aTempSize ) == sal_False )
			{
                throw ::com::sun::star::lang::IllegalArgumentException();
			}
			else
			{
				aSetPaperSize = impl_Size_Struct2Object(aTempSize);
			}
		}

		// PrinterTray-Property
		else if ( rProp.Name.compareToAscii( "PrinterPaperTray" ) == 0 )
		{
			rtl::OUString aTmp;
			if ( ( rProp.Value >>= aTmp ) == sal_False )
                throw ::com::sun::star::lang::IllegalArgumentException();
			sal_uInt16 nCount = pPrinter->GetPaperBinCount();
            for (sal_uInt16 nBin=0; nBin<nCount; nBin++)
			{
                ::rtl::OUString aName( pPrinter->GetPaperBinName(nBin) );
				if ( aName == aTmp )
				{
                    pPrinter->SetPaperBin(nBin);
					break;
				}
			}
		}
	}

	//os 12.11.98: die PaperSize darf nur gesetzt werden, wenn tatsaechlich
	//PAPER_USER gilt, sonst koennte vom Treiber ein falsches Format gewaehlt werden
    if(nPaperFormat == view::PaperFormat_USER && aSetPaperSize.Width())
	{
		//JP 23.09.98 - Bug 56929 - MapMode von 100mm in die am
		//			Device gesetzten umrechnen. Zusaetzlich nur dann
		//			setzen, wenn sie wirklich veraendert wurden.
		aSetPaperSize = pPrinter->LogicToPixel( aSetPaperSize, MAP_100TH_MM );
		if( aSetPaperSize != pPrinter->GetPaperSizePixel() )
		{
			pPrinter->SetPaperSizeUser( pPrinter->PixelToLogic( aSetPaperSize ) );
			nChangeFlags |= SFX_PRINTER_CHG_SIZE;
		}
	}

    // #96772#: wait until printing is done
    SfxPrinter* pDocPrinter = pViewSh->GetPrinter();
    while ( pDocPrinter->IsPrinting() )
        Application::Yield();
}

void SAL_CALL SfxPrintHelper::setPrinter(const uno::Sequence< beans::PropertyValue >& rPrinter)
        throw (::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::uno::RuntimeException)
{
	// object already disposed?
    ::vos::OGuard aGuard( Application::GetSolarMutex() );

	SfxViewShell* pViewSh = NULL;
	SfxPrinter* pPrinter = NULL;
	sal_uInt16 nChangeFlags = 0;
	impl_setPrinter(rPrinter,pPrinter,nChangeFlags,pViewSh);
	// set new printer
	if ( pViewSh && pPrinter )
        pViewSh->SetPrinter( pPrinter, nChangeFlags, false );
}

//________________________________________________________________________________________________________
//  ImplPrintWatch thread for asynchronous printing with moving temp. file to ucb location
//________________________________________________________________________________________________________

/* This implements a thread which will be started to wait for asynchronous
   print jobs to temp. localy files. If they finish we move the temp. files
   to her right locations by using the ucb.
 */
class ImplUCBPrintWatcher : public ::osl::Thread
{
    private:
        /// of course we must know the printer which execute the job
        SfxPrinter* m_pPrinter;
        /// this describes the target location for the printed temp file
        String m_sTargetURL;
        /// it holds the temp file alive, till the print job will finish and remove it from disk automaticly if the object die
        ::utl::TempFile* m_pTempFile;

    public:
        /* initialize this watcher but don't start it */
        ImplUCBPrintWatcher( SfxPrinter* pPrinter, ::utl::TempFile* pTempFile, const String& sTargetURL )
                : m_pPrinter  ( pPrinter   )
                , m_sTargetURL( sTargetURL )
                , m_pTempFile ( pTempFile  )
        {}

        /* waits for finishing of the print job and moves the temp file afterwards
           Note: Starting of the job is done outside this thread!
           But we have to free some of the given ressources on heap!
         */
        void SAL_CALL run()
        {
            /* SAFE { */
            {
                ::vos::OGuard aGuard( Application::GetSolarMutex() );
                while( m_pPrinter->IsPrinting() )
                    Application::Yield();
                m_pPrinter = NULL; // don't delete it! It's borrowed only :-)
            }
            /* } SAFE */

            // lock for further using of our member isn't neccessary - because
            // we truns alone by defenition. Nobody join for us nor use us ...
            ImplUCBPrintWatcher::moveAndDeleteTemp(&m_pTempFile,m_sTargetURL);

            // finishing of this run() method will call onTerminate() automaticly
            // kill this thread there!
        }

        /* nobody wait for this thread. We must kill ourself ...
         */
        void SAL_CALL onTerminated()
        {
            delete this;
        }

        /* static helper to move the temp. file to the target location by using the ucb
           It's static to be useable from outside too. So it's not realy neccessary to start
           the thread, if finishing of the job was detected outside this thread.
           But it must be called without using a corresponding thread for the given parameter!
         */
        static void moveAndDeleteTemp( ::utl::TempFile** ppTempFile, const String& sTargetURL )
        {
            // move the file
            try
            {
				INetURLObject aSplitter(sTargetURL);
				String		  sFileName = aSplitter.getName(
											INetURLObject::LAST_SEGMENT,
											true,
											INetURLObject::DECODE_WITH_CHARSET);
				if (aSplitter.removeSegment() && sFileName.Len()>0)
				{
					::ucbhelper::Content aSource(
							::rtl::OUString((*ppTempFile)->GetURL()),
							::com::sun::star::uno::Reference< ::com::sun::star::ucb::XCommandEnvironment >());

					::ucbhelper::Content aTarget(
							::rtl::OUString(aSplitter.GetMainURL(INetURLObject::NO_DECODE)),
							::com::sun::star::uno::Reference< ::com::sun::star::ucb::XCommandEnvironment >());

					aTarget.transferContent(
							aSource,
							::ucbhelper::InsertOperation_COPY,
							::rtl::OUString(sFileName),
							::com::sun::star::ucb::NameClash::OVERWRITE);
				}
            }
            catch( ::com::sun::star::ucb::ContentCreationException& ) { DBG_ERROR("content create exception"); }
            catch( ::com::sun::star::ucb::CommandAbortedException&  ) { DBG_ERROR("command abort exception"); }
            catch( ::com::sun::star::uno::RuntimeException&         ) { DBG_ERROR("runtime exception"); }
            catch( ::com::sun::star::uno::Exception&                ) { DBG_ERROR("unknown exception"); }

            // kill the temp file!
            delete *ppTempFile;
            *ppTempFile = NULL;
        }
};

//------------------------------------------------

//________________________________________________________________________________________________________
//  XPrintable
//________________________________________________________________________________________________________
void SAL_CALL SfxPrintHelper::print(const uno::Sequence< beans::PropertyValue >& rOptions)
        throw (::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::uno::RuntimeException)
{
    if( Application::GetSettings().GetMiscSettings().GetDisablePrinting() )
        return;

	// object already disposed?
	// object already disposed?
    ::vos::OGuard aGuard( Application::GetSolarMutex() );

	// get view for sfx printing capabilities
	SfxViewFrame *pViewFrm = m_pData->m_pObjectShell.Is() ?
								SfxViewFrame::GetFirst( m_pData->m_pObjectShell, sal_False ) : 0;
	if ( !pViewFrm )
		return;
	SfxViewShell* pView = pViewFrm->GetViewShell();
	if ( !pView )
		return;

//	SfxAllItemSet aArgs( pView->GetPool() );
    sal_Bool bMonitor = sal_False;
    // We need this information at the end of this method, if we start the vcl printer
    // by executing the slot. Because if it is a ucb relevant URL we must wait for
    // finishing the print job and move the temporary local file by using the ucb
    // to the right location. But in case of no file name is given or it is already
    // a local one we can supress this special handling. Because then vcl makes all
    // right for us.
    String sUcbUrl;
    ::utl::TempFile* pUCBPrintTempFile = NULL;

	uno::Sequence < beans::PropertyValue > aCheckedArgs( rOptions.getLength() );
	sal_Int32 nProps = 0;
	sal_Bool  bWaitUntilEnd = sal_False;
    sal_Int16 nDuplexMode = ::com::sun::star::view::DuplexMode::UNKNOWN;
	for ( int n = 0; n < rOptions.getLength(); ++n )
	{
		// get Property-Value from options
        const beans::PropertyValue &rProp = rOptions.getConstArray()[n];

		// FileName-Property?
		if ( rProp.Name.compareToAscii( "FileName" ) == 0 )
		{
            // unpack th URL and check for a valid and well known protocol
            ::rtl::OUString sTemp;
            if (
                ( rProp.Value.getValueType()!=::getCppuType((const ::rtl::OUString*)0))  ||
                (!(rProp.Value>>=sTemp))
               )
            {
                throw ::com::sun::star::lang::IllegalArgumentException();
            }

            String        sPath        ;
            String        sURL  (sTemp);
            INetURLObject aCheck(sURL );
            if (aCheck.GetProtocol()==INET_PROT_NOT_VALID)
            {
                // OK - it's not a valid URL. But may it's a simple
                // system path directly. It will be supported for historical
                // reasons. Otherwhise we break to much external code ...
                // We try to convert it to a file URL. If its possible
                // we put the system path to the item set and let vcl work with it.
                // No ucb or thread will be neccessary then. In case it couldnt be
                // converted its not an URL nor a system path. Then we can't accept
                // this parameter and have to throw an exception.
                ::rtl::OUString sSystemPath(sTemp);
                ::rtl::OUString sFileURL;
                if (::osl::FileBase::getFileURLFromSystemPath(sSystemPath,sFileURL)!=::osl::FileBase::E_None)
                    throw ::com::sun::star::lang::IllegalArgumentException();
				aCheckedArgs[nProps].Name = rProp.Name;
				aCheckedArgs[nProps++].Value <<= sFileURL;
                // and append the local filename
                aCheckedArgs.realloc( aCheckedArgs.getLength()+1 );
				aCheckedArgs[nProps].Name = rtl::OUString::createFromAscii("LocalFileName");
				aCheckedArgs[nProps++].Value <<= ::rtl::OUString( sTemp );
            }
            else
            // It's a valid URL. but now we must know, if it is a local one or not.
            // It's a question of using ucb or not!
            if (::utl::LocalFileHelper::ConvertURLToSystemPath(sURL,sPath))
            {
                // it's a local file, we can use vcl without special handling
                // And we have to use the system notation of the incoming URL.
                // But it into the descriptor and let the slot be executed at
                // the end of this method.
				aCheckedArgs[nProps].Name = rProp.Name;
				aCheckedArgs[nProps++].Value <<= sTemp;
                // and append the local filename
                aCheckedArgs.realloc( aCheckedArgs.getLength()+1 );
				aCheckedArgs[nProps].Name = rtl::OUString::createFromAscii("LocalFileName");
				aCheckedArgs[nProps++].Value <<= ::rtl::OUString( sPath );
            }
            else
            {
                // it's an ucb target. So we must use a temp. file for vcl
                // and move it after printing by using the ucb.
                // Create a temp file on the heap (because it must delete the
                // real file on disk automaticly if it die - bt we have to share it with
                // some other sources ... e.g. the ImplUCBPrintWatcher).
                // And we put the name of this temp file to the descriptor instead
                // of the URL. The URL we save for later using seperatly.
                // Execution of the print job will be done later by executing
                // a slot ...
                pUCBPrintTempFile = new ::utl::TempFile();
                pUCBPrintTempFile->EnableKillingFile();

				//FIXME: does it work?
				aCheckedArgs[nProps].Name = rtl::OUString::createFromAscii("LocalFileName");
				aCheckedArgs[nProps++].Value <<= ::rtl::OUString( pUCBPrintTempFile->GetFileName() );
                sUcbUrl = sURL;
            }
		}

		// CopyCount-Property
		else if ( rProp.Name.compareToAscii( "CopyCount" ) == 0 )
		{
			sal_Int32 nCopies = 0;
			if ( ( rProp.Value >>= nCopies ) == sal_False )
                throw ::com::sun::star::lang::IllegalArgumentException();

			aCheckedArgs[nProps].Name = rProp.Name;
			aCheckedArgs[nProps++].Value <<= nCopies;
		}

		// Collate-Property
		// Sort-Property (deprecated)
		else if ( rProp.Name.compareToAscii( "Collate" ) == 0 ||
			    ( rProp.Name.compareToAscii( "Sort" ) == 0 ) )
		{
            sal_Bool bTemp = sal_Bool();
            if ( rProp.Value >>= bTemp )
			{
				aCheckedArgs[nProps].Name = rtl::OUString::createFromAscii("Collate");
				aCheckedArgs[nProps++].Value <<= bTemp;
			}
			else
                throw ::com::sun::star::lang::IllegalArgumentException();
		}

		// Pages-Property
		else if ( rProp.Name.compareToAscii( "Pages" ) == 0 )
		{
            ::rtl::OUString sTemp;
            if( rProp.Value >>= sTemp )
			{
				aCheckedArgs[nProps].Name = rProp.Name;
				aCheckedArgs[nProps++].Value <<= sTemp;
			}
			else
                throw ::com::sun::star::lang::IllegalArgumentException();
		}

		// MonitorVisible
		else if ( rProp.Name.compareToAscii( "MonitorVisible" ) == 0 )
		{
            if( !(rProp.Value >>= bMonitor) )
                throw ::com::sun::star::lang::IllegalArgumentException();
			aCheckedArgs[nProps].Name = rProp.Name;
			aCheckedArgs[nProps++].Value <<= bMonitor;
		}

		// Wait
		else if ( rProp.Name.compareToAscii( "Wait" ) == 0 )
		{
            if ( !(rProp.Value >>= bWaitUntilEnd) )
                throw ::com::sun::star::lang::IllegalArgumentException();
			aCheckedArgs[nProps].Name = rProp.Name;
			aCheckedArgs[nProps++].Value <<= bWaitUntilEnd;
		}

        else if ( rProp.Name.compareToAscii( "DuplexMode" ) == 0 )
        {
            if ( !(rProp.Value >>= nDuplexMode ) )
                throw ::com::sun::star::lang::IllegalArgumentException();
            aCheckedArgs[nProps].Name = rProp.Name;
            aCheckedArgs[nProps++].Value <<= nDuplexMode;
        }
	}

	if ( nProps != aCheckedArgs.getLength() )
		aCheckedArgs.realloc(nProps);

    // Execute the print request every time.
    // It doesn'tmatter if it is a real printer used or we print to a local file
    // nor if we print to a temp file and move it afterwards by using the ucb.
    // That will be handled later. see pUCBPrintFile below!
	pView->ExecPrint( aCheckedArgs, sal_True, sal_False );

    // Ok - may be execution before has finished (or started!) printing.
    // And may it was a printing to a file.
    // Now we have to check if we can move the file (if neccessary) via ucb to his right location.
    // Cases:
    //  a) printing finished                        => move the file directly and forget the watcher thread
    //  b) printing is asynchron and runs currently => start watcher thread and exit this method
    //                                                 This thread make all neccessary things by itself.
    if (pUCBPrintTempFile!=NULL)
    {
        // a)
        SfxPrinter* pPrinter = pView->GetPrinter();
        if ( ! pPrinter->IsPrinting() )
            ImplUCBPrintWatcher::moveAndDeleteTemp(&pUCBPrintTempFile,sUcbUrl);
        // b)
        else
        {
            // Note: we create(d) some ressource on the heap. (thread and tep file)
            // They will be delected by the thread automaticly if he finish his run() method.
            ImplUCBPrintWatcher* pWatcher = new ImplUCBPrintWatcher( pPrinter, pUCBPrintTempFile, sUcbUrl );
            pWatcher->create();
        }
    }
}

void IMPL_PrintListener_DataContainer::Notify( SfxBroadcaster& rBC, const SfxHint& rHint )
{
    if ( &rBC == m_pObjectShell )
	{
		SfxPrintingHint* pPrintHint = PTR_CAST( SfxPrintingHint, &rHint );
		if ( pPrintHint )
		{
			if ( pPrintHint->GetWhich() == com::sun::star::view::PrintableState_JOB_STARTED )
			{
                if ( !m_xPrintJob.is() )
                    m_xPrintJob = new SfxPrintJob_Impl( this );
				m_aPrintOptions = pPrintHint->GetOptions();
			}
            else if ( pPrintHint->GetWhich() != -2 )    // -2 : CancelPrintJob
			{
				view::PrintJobEvent aEvent;
                aEvent.Source = m_xPrintJob;
				aEvent.State = (com::sun::star::view::PrintableState) pPrintHint->GetWhich();
                ::cppu::OInterfaceContainerHelper* pContainer = m_aInterfaceContainer.getContainer( ::getCppuType( ( const uno::Reference< view::XPrintJobListener >*) NULL ) );
			    if ( pContainer!=NULL )
				{
			        ::cppu::OInterfaceIteratorHelper pIterator(*pContainer);
			        while (pIterator.hasMoreElements())
						((view::XPrintJobListener*)pIterator.next())->printJobEvent( aEvent );
				}
			}
		}
	}
}

void SAL_CALL SfxPrintHelper::addPrintJobListener( const ::com::sun::star::uno::Reference< ::com::sun::star::view::XPrintJobListener >& xListener ) throw (::com::sun::star::uno::RuntimeException)
{
    ::vos::OGuard aGuard( Application::GetSolarMutex() );
    m_pData->m_aInterfaceContainer.addInterface( ::getCppuType((const uno::Reference < view::XPrintJobListener>*)0), xListener );
}

void SAL_CALL SfxPrintHelper::removePrintJobListener( const ::com::sun::star::uno::Reference< ::com::sun::star::view::XPrintJobListener >& xListener ) throw (::com::sun::star::uno::RuntimeException)
{
    ::vos::OGuard aGuard( Application::GetSolarMutex() );
    m_pData->m_aInterfaceContainer.removeInterface( ::getCppuType((const uno::Reference < view::XPrintJobListener>*)0), xListener );
}