IImportExportFacade.h

//========================================================================================
// 
// $File$
// 
// Owner: Jonathan W. Brown
// 
// $Author$
// 
// $DateTime$
// 
// $Revision$
// 
// $Change$
// 
// Copyright 1997-2010 Adobe Systems Incorporated. All rights reserved.
// 
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance 
// with the terms of the Adobe license agreement accompanying it. If you have received
// this file from a source other than Adobe, then your use, modification, or 
// distribution of it requires the prior written permission of Adobe.
// 
// 
// Description:
// A high level API for dealing with import and export.
// 
//========================================================================================

#ifndef __IImportExportFacade__
#define __IImportExportFacade__

// ----- Includes -----
#include "IPMUnknown.h"

#include "IPlaceGun.h"
#include "OpenPlaceID.h"
#include "UIDList.h"
#include "URI.h"
#include "Utils.h"

class ICmdCollection ;
class IDataBase ;
class IImportResourceCmdData ;
class ISpread;

namespace Facade
{
 class IImportExportFacade : public IPMUnknown
 {
 public:
 enum { kDefaultIID = IID_IIMPORTEXPORTFACADE };


 enum PlaceGunContent {
 kFirstItem,
 kAllItems
 } ;

 virtual ErrorCode LoadPlaceGun( const UIDList& itemList, IPlaceGun::PlaceGunLocation location ) const = 0 ;

 virtual ErrorCode LoadPlaceGun( ICmdCollection* cmdCollection, IPlaceGun::PlaceGunLocation location ) const = 0 ;

 virtual ErrorCode ClearPlaceGun( IPlaceGun* placeGun, PlaceGunContent what ) const = 0 ;

 virtual ErrorCode AbortPlaceGun( IPlaceGun* placeGun, PlaceGunContent what ) const = 0 ;

 virtual ErrorCode ImportAndLoadPlaceGun( IDataBase* db, const URI& uri, UIFlags flags, 
 bool16 retainFormat, bool16 convertQuotes, bool16 applyCJKGrid, 
 UID uidPreview, IPlaceGun::PlaceGunLocation location ) const = 0 ;
 virtual ErrorCode ImportAndLoadPlaceGun( IImportResourceCmdData* cmdData, IPlaceGun::PlaceGunLocation location ) const = 0 ;
 virtual ErrorCode ImportAndLoadPlaceGun( IDataBase* db, const URI& uri, UIFlags flags, 
 bool16 retainFormat, bool16 convertQuotes, bool16 applyCJKGrid, 
 bool16& useClippingFrame, bool16& skipPlace ) const = 0 ;
 virtual ErrorCode ImportAndLoadPlaceGun( IDataBase* db, UID linkResourceUID, UIFlags flags, 
 bool16 retainFormat, bool16 convertQuotes, bool16 applyCJKGrid, 
 bool16& useClippingFrame, bool16& skipPlace ) const = 0 ;

 virtual ErrorCode RotatePlaceGun( IPlaceGun* placeGun, bool16 forward ) const = 0 ;

 virtual ErrorCode ReplacePageItem( IDataBase* db, UID oldPageItem, UID newPageItem, bool16 useClippingFrame, UIDList& replaceList ) const = 0 ;

 virtual ErrorCode PlaceExternalFile(ISpread* spread, const IDFile& filePath, const PBPMPoint& pbPoint) const = 0;

 virtual ErrorCode PlaceExternalFileWithUIFlags(ISpread* spread, const IDFile& filePath, const PBPMPoint& pbPoint, const UIFlags uiFlags ) const = 0;
 };
} // namespace Facade

#endif // __IImportExportFacade__