CCamDoc Class Reference

This is the wxWidgets class for a document type object in the OIL (it was originally part of wxWidgets example app. docvwmdi). It is very simple - its main use is getting hold of the relevant Document object from the kernel layer. wxWidgets calls various member functions when processing commands from the File menu. This class calls down into the kernel to do the actual work. More...

#include <camdoc.h>

List of all members.

Public Member Functions
	CCamDoc (Document *pKernelDoc=NULL)
	Creates a CCamDoc, optionally attached to a given pKernelDoc or if pKernelDoc is null, a new Document. Notes: m_pFor Scope: protected.
	~CCamDoc ()
	Destructor - destroys the Document associated with this OIL document.
Document *	GetKernelDoc () const
	Find the Kernel document associated with this Oil document.
virtual bool	OnNewDocument ()
	Called by MFC during the processing of a File/New command. Before this is called MFC/kernel have already contructed new instances of the CCamDoc / Document classes. Calls the kernel's Document and CCamDoc's base class to do the actual work.
virtual bool	OnSaveDocument (const wxString &filename)
	Saves the document to the specified path. Calls the kernel to do the actual work.
virtual bool	OnOpenDocument (const wxString &filename)
virtual bool	SaveAs ()
void	SetModifiedFlag (BOOL fMod=TRUE)
virtual void	SetTitle (LPCTSTR lpszTitle)
	To set a new title for the document. Overide the parent class versions so we can do things like send a message to inform people that things have changed.
virtual void	SetPathName (LPCTSTR lpszPathName, BOOL bAddToMRU=TRUE)
	To set a new pathname for the document. Overide the parent class versions so we can do things like send a message to inform people that things have changed.
void	SetPathNameEmpty ()
	To set a new pathname for the document. Overide the parent class versions so we can do things like send a message to inform people that things have changed.
void	SetDocName (LPCTSTR lpszTitle)
String_256	GetKernelTitle ()
	Good for finding out the title of the document. If the document has been saved as 'Blobby.art' then the title returned will be of the form 'Blobby.art (Modified)' etc. ie What you would see in the title of a non maximised document window.
String_256	GetKernelPathName (UINT32 MaxSize=0)
	Good for finding out the pathname of the document.
String_256	GetKernelDocName (BOOL IncludeFileType=TRUE)
	Good for finding out the name of the document. If the document has been saved as 'Blobby.art' then the title returned will be of the form 'Blobby.art etc. otherwise will be of the form Untitled#1. Similar to what the functions GetTitle() and GetKernelTitle() return but is just the document name with none of the modified etc.
String_256	GetKernelLocation (UINT32 MaxSize=0)
	Good for finding out the location of the document. This is the pathname minus the filename.
String_256	GetOriginalPath () const
void	SetOriginalPath (const String_256 &strPath)
	Sets the path to the non-native document that this Camelot doc is based on. This path should be set to empty if the Camelot doc is no longer equivalent to the original non-native file, eg. if the Camelot doc becomes modified, or was loaded from a .ART native file, or is new (untitled).
void	SetModified (bool fState)
	To tell the document that it has been modified. While MFC provides an implementation of this, it doesn't update the document's title, so call this function instead.
void	SetReadOnly (bool fState)
	To tell the document whether it can be modified or not.
void	SetCopy (bool fState)
	To tell the document whether it is a copy of an ineditable document.
bool	IsReadOnly () const
	Provides a safe way to test the document's flags.
bool	IsACopy () const
	Provides a safe way to test the document's flags.
bool	IsUntouched () const
	Provides a safe way to test the document's flags. Note there's no equivalent Set function for this flag because only this class should ever set its state.
bool	IsModifiable () const
	Because of a bodge in Operation::EndOp(), SetModified() is called needlessly. So we know whether to pay any attention to IsModified() we can use this.
void	SetSaveFlags (BOOL fSameAsLoad, BOOL fRememberName)
PathName	GetTemplate () const
	As above.
void	SetTemplate (const PathName &pathToSet=PathName())
	As above.
virtual wxCommandProcessor *	OnCreateCommandProcessor ()
bool	IsVisible () const
Static Public Member Functions
static PathName	GetNextTemplateToUse ()
	To find the path of the next template to use.
static void	SetNextTemplateToUse (const PathName &pathToSet=PathName())
	To set the path of the next template to use.
static BOOL	EnableRemoveUntouchedDocs ()
	Enable to idle-time removal of untouched documents. Called when the user creates new documents or opens existing documents from the highest possible level: menucmds.cpp.
Static Public Attributes
static BOOL	s_RemoveExistingOnNewDoc = FALSE
Protected Member Functions
virtual CCLexFile *	CreateCCFile (LPCTSTR lpcszPath, INT32 nOpenMode)
	CCamDoc::OnOpenDocument and CCamDoc::OnSaveDocument call this to allocate a CCLexFile object to load ans save from/to.
virtual bool	DefaultDocumentRequired (CCLexFile *pFile, UINT32 nPrefFilter)
	Given the pathname that we have been asked to open and before we actually go and open the file, we must ask the filter system to work out what filter is required to load the file, ask that filter if it requires a default document or not and if it says yes then load the default document in. This is required because if a file such as a bitmap is loaded the user would expect to see this loaded into the default document, as this file format defines no document structure, otherwise the default constructed document would be used and this is one that is never seen elsewhere by the user. Other file types apart form bitmaps might require the same treatment, examples at present are Corel palette files and Windows metafiles. Formats which define document structures, such as our native format and the EPS formats will be changing the default constructed document given information in the format and so there is no point in loading the default document. Would cause problems anyway as things like colours would need clearing out etc. Needs to be done here as otherwise we would be right in the middle of the loading process before we decide what filter is required and hence would be calling effectively the same code re-enterantly! Only returns False if a problem happened in the testing and loading process.
virtual bool	LoadDefaultDocument ()
	Loads the default document. Called by CCamDoc::OnNewDocument etc.
virtual bool	GeneralOpenDocument (CCLexFile *pFile, UINT32 nPrefFilter)
	This function will load a document with the name provided to help out the OnNewDocument and the OpOpenDocument, since they do mostly the same thing.
virtual bool	OnSaveModified ()
	Prompts user to save document if required. MFCCOPY. Normal MFC uses non- UI compliant Yes/No box.
virtual bool	DoSave (LPCTSTR lpszPathName, BOOL bReplace=TRUE)
	This is an exact copy of the CDocument version of this function. I had to copy it out as I need to change the bit that displays the SaveAs dialog so that I could set it to the correct directory and generally change it about to meet our requirements. This function ends up calling OnSaveDocument above to do the actual saving.
virtual bool	DeleteContents ()
	Deletes this document's data. Called by MFC in various situations.
BOOL	RemoveExistingDocs ()
	Removed existing documents, when a new document is created.
virtual bool	DoNewDocument ()
	Called to load the default document etc by CCamDoc::OnNewDocument. Does the actual load of the document data, without changin any flags etc.
virtual bool	DoOpenDocument (const wxString &strFilename)
	Helper function to CCamDoc::OnOpenDocument. Does the actual load of the data, without disturbing any flags etc.
virtual bool	DoSaveDocument (const wxString &strFilename)
	Helper function for CCamDoc::OnSaveDocument. Does the actual saving of the data, without disturbing aby flags etc.
Protected Attributes
PathName	m_pathTemplate
Static Protected Attributes
static PathName	ms_pathNextTemplateToUse
Private Member Functions
void	UpdateTitle ()
	Sets the (window) titles of all views onto this document to the contained title of the document, plus a suffix if the document has been modified (cf. Visual C++ & Word), is read-only, or a copy.
Private Attributes
Document *	m_pKernelDoc
bool	m_fIsReadOnly
bool	m_fIsACopy
bool	m_fIsUntouched
String_256	m_TitlePrefix
String_256	m_strOriginalPath
bool	m_bIsModifiable
LPTSTR	m_lpszInitialZoomOp
bool	m_fDoneNewDoc
Static Private Attributes
static Document *	s_pForceDocument = NULL

---

Detailed Description

This is the wxWidgets class for a document type object in the OIL (it was originally part of wxWidgets example app. docvwmdi). It is very simple - its main use is getting hold of the relevant Document object from the kernel layer. wxWidgets calls various member functions when processing commands from the File menu. This class calls down into the kernel to do the actual work.

Author:

Luke_Hart (Xara Group Ltd) <camelotdev@xara.com> (originally from samples) with mods.

Date:

01/07/05

See also:

Document

Definition at line 129 of file camdoc.h.

---

Constructor & Destructor Documentation

CCamDoc::CCamDoc (  Document *  pKernelDoc = NULL  )

Creates a CCamDoc, optionally attached to a given pKernelDoc or if pKernelDoc is null, a new Document. Notes: m_pFor Scope: protected. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: pKernelDoc  --- the kernel Document to attach to this [INPUTS] CCamDoc, or m_pForceDoc, a global override of all default creations. Returns: Errors: May throw an MFC memory exception! Definition at line 141 of file camdoc.cpp. : m_pKernelDoc( NULL ), m_fIsReadOnly( false ), m_fIsACopy( false ), m_fIsUntouched( false ), m_bIsModifiable( false ), #if (_OLE_VER >= 0x200) m_fExportPreview( true ), m_fIsVisible( false ), m_fDoneInitialShow( false ), #endif m_lpszInitialZoomOp( NULL ), m_fDoneNewDoc( false ) { #if (_OLE_VER >= 0x200) // For most apps enable compound documents. EnableCompoundFile(); EnableAutomation(); #endif // Graham 22/10/97: Set the template path name as empty SetTemplate(); // If the default was passed then use the 'forced' one (which may also // be null, meaning 'create a Document'. if( NULL == pKernelDoc ) pKernelDoc = s_pForceDocument; // Connect with a ready-made kernel Document type? if( pKernelDoc ) { // Attach this CCamDoc to the Document type. ERROR3IF(pKernelDoc->GetOilDoc(), "Document already attached in CCamDoc::CCamDoc"); m_pKernelDoc = pKernelDoc; } else { // Default - connect to a newly-created standard kernel Document. m_pKernelDoc = new Document; if( !m_pKernelDoc ) throw CMemoryException(); } // Try to initialise the kernel Document type and attach it to this CCamDoc. if( !m_pKernelDoc->Init( this ) ) { // Didn't work - delete the Document object and throw an exception delete m_pKernelDoc; throw CMemoryException(); } // Initialise the document flags. SetModifiedFlag(FALSE); #if (_OLE_VER >= 0x200) // All done - now claim the OLE 2.0 libraries. AfxOleLockApp(); #endif }

CCamDoc::~CCamDoc (   )

Destructor - destroys the Document associated with this OIL document. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 19/5/93 Definition at line 210 of file camdoc.cpp. { // Get rid of the Document associated with this CCamDoc. // wxDocument::SetNoCurrent(); m_pKernelDoc->SetCurrent(); delete m_pKernelDoc; m_pKernelDoc = NULL; // Under OLE 2.0 we must release our claim on the OLE libraries. #if (_OLE_VER >= 0x200) AfxOleUnlockApp(); #endif }

---

Member Function Documentation

CCLexFile * CCamDoc::CreateCCFile (  LPCTSTR  lpcszPath, INT32  nOpenMode )  [protected, virtual]

CCamDoc::OnOpenDocument and CCamDoc::OnSaveDocument call this to allocate a CCLexFile object to load ans save from/to. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 19/8/96 Parameters: lpcszPath  - path to the disk file to open, or if NULL then open the [INPUTS] "CONTENTS" stream of the CCamDoc's root-storage member. nOpenMode - opening mode, eg. ios::in. ios::binary is assumed. Returns: A pointer to a CCLexFile derivative on the heap that represents the given file object, either on disk or in structured storage. The caller should deallocate this file when finished with it. Returns NULL if there was an error (eg. file not found) - if so then the error has already been reported. See also: CCamDoc::OnOpenDocument; CCamDoc::OnSaveDocument Definition at line 2528 of file camdoc.cpp. { // Fix-up the flags. nOpenMode |= ios::binary; if (nOpenMode & ios::out) nOpenMode |= ios::trunc; // Allocate the appropriate kind of file. CCLexFile* pFile = 0; if (lpcszPath) { // A path was passed, so open a disk-file on it. pFile = new CCDiskFile(PathName(lpcszPath), nOpenMode); // TRACEUSER( "JustinF", _T("\t- a new CCDiskFile at 0x%p, no sweat\n"), (LPVOID) pFile); } #if (_OLE_VER >= 0x200) else { // No path was passed, so open the 'native XaraDrawing' stream of CCamDoc's // m_lpRootStg storage, inherited from CCamDocBase (COleServerDoc). ERROR2IF(!m_lpRootStg, 0, "No IStorage interface in CCamDoc::CreateCCFile"); // We have to create or open the stream, depending on whether we are opening for read, // write, or read/write. // // JCF: version 2.0 change - embedded native XaraDrawings no longer have // version numbers as the native filter handles all versioning itself. // So we will try to transparently rename on opening any old style streams // we come across. LPCWSTR pszStreamName = L"Xara Drawing (native)"; LPSTREAM pIStream; HRESULT hr; if (nOpenMode & ios::in) { // Loading, so open an existing stream. ERROR2IF(nOpenMode & ios::out, FALSE, "CCamDoc::CreateCCFile: OLE read AND write not implemented"); hr = m_lpRootStg->OpenStream(pszStreamName, 0, STGM_READ | STGM_SHARE_EXCLUSIVE, 0, &pIStream); // Try the old native format if opening the new stream didn't work. if (hr == STG_E_FILENOTFOUND) { LPCWSTR pszOldStreamName = L"XaraDrawing 1.5 (Native)"; hr = m_lpRootStg->OpenStream(pszOldStreamName, 0, STGM_READ | STGM_SHARE_EXCLUSIVE, 0, &pIStream); if (SUCCEEDED(hr)) { // Try to modernise the old stream's name. HRESULT hr2 = m_lpRootStg->RenameElement(pszOldStreamName, pszStreamName); TRACEUSER( "JustinF", _T("\t- tried to rename v1.5 stream (HRESULT 0x%lX)\n"), (UINT32) hr2); // Pass any error along if there's not a good reason for it. if (FAILED(hr2) && hr2 != STG_E_DISKISWRITEPROTECTED && hr2 != STG_E_ACCESSDENIED) hr = hr2; } } } else { // If there's a Camelot class factory around then associate this storage with it. if (m_pFactory) WriteClassStg(m_lpRootStg, m_pFactory->GetClassID()); // Saving, so create a new stream / truncate an existing stream. ERROR3IF(!(nOpenMode & ios::out), "No I/O mode in CCamDoc::CreateCCFile"); hr = m_lpRootStg->CreateStream(pszStreamName, STGM_WRITE | STGM_CREATE | STGM_SHARE_EXCLUSIVE, 0, 0, &pIStream); } // Do we have a valid IStream? if (FAILED(hr)) { // No, so report the error and fail. TRACE( _T("Couldn't open IStream in CCamDoc::CreateCCFile (HRESULT 0x%lX)\n"), (UINT32) hr); InformError(_R(IDE_OPEN_ERROR)); return 0; } #ifdef WEBSTER // WEBSTER-Martin-29/12/96 // no accusoft stuff so wrap a boring old CCOleStream around it pFile = new CCOleStream(pIStream, nOpenMode, filebuf::sh_none); #else // Yes, so wrap a CCAccusoftOleStream around it. pFile = new CCOleAccusoftStream(pIStream, nOpenMode, filebuf::sh_none); #endif /* TRACEUSER( "JustinF", _T("\t- a new CCAccusoftOleStream at 0x%p, take cover!\n"), (LPVOID) pFile); */ } #endif // Check if we managed to allocate the file. if (!pFile) { // No, so report the error and fail. InformError( _R(IDE_NOMORE_MEMORY) ); return 0; } // Was the file opened sucessfully? if (!pFile->isOpen()) { // Couldn't open the file, so deallocate it. Any error will have already been // reported. delete pFile; pFile = 0; } // Return the file (or null). return pFile; }

bool CCamDoc::DefaultDocumentRequired (  CCLexFile *  pFile, UINT32  nPrefFilter )  [protected, virtual]

Given the pathname that we have been asked to open and before we actually go and open the file, we must ask the filter system to work out what filter is required to load the file, ask that filter if it requires a default document or not and if it says yes then load the default document in. This is required because if a file such as a bitmap is loaded the user would expect to see this loaded into the default document, as this file format defines no document structure, otherwise the default constructed document would be used and this is one that is never seen elsewhere by the user. Other file types apart form bitmaps might require the same treatment, examples at present are Corel palette files and Windows metafiles. Formats which define document structures, such as our native format and the EPS formats will be changing the default constructed document given information in the format and so there is no point in loading the default document. Would cause problems anyway as things like colours would need clearing out etc. Needs to be done here as otherwise we would be right in the middle of the loading process before we decide what filter is required and hence would be calling effectively the same code re-enterantly! Only returns False if a problem happened in the testing and loading process. Author: Neville_Humphrys (Xara Group Ltd) <camelotdev@xara.com> Date: 12/10/95 Parameters: pFile  - file to check [INPUTS] Returns: TRUE if the process went ok, FALSE if there was a problem Errors: - See also: CCamDoc::GeneralOpenDocument; CCamDoc::OnOpenDocument; Filter::IsDefaultDocRequired; Definition at line 1062 of file camdoc.cpp. { #if defined(EXCLUDE_FROM_RALPH) return true; #else // NULL pathname implies that we can't do any checking so return immediately // Shouldn't happen, maybe we should error? // TRACEUSER( "JustinF", _T("In CCamDoc::DefaultDocumentRequired(%p)\n"), (LPVOID) pFile); PathName pth = pFile->GetPathName(); if (!pth.IsValid()) { // TRACEUSER( "JustinF", _T("\t- file has no valid path, assuming it's OK\n")); return TRUE; } // Find out the position of the filter selected by the user in the open dialog INT32 SelectedPos = BaseFileDialog::SelectedFilter; // Do we know which filter was used (we know nothing about things in the recent file list) Filter* pFilter = Filter::GetFirst(); if (nPrefFilter != FILTERID_USERCHOICE || SelectedPos == 0) { // We know nothing. We will have to go and have a look at all the possibles // We will find the Filter Family and ask it to try and load the file // Find the filter that the user chose. UINT32 nID = (nPrefFilter != FILTERID_USERCHOICE) ? nPrefFilter : FILTERID_GENERIC; while (pFilter != NULL && pFilter->FilterID != nID) { // Try the next filter pFilter = Filter::GetNext(pFilter); } } else { // We know which type of filter the user had selected in the file dialog // Find the filter that the user chose while (pFilter != NULL) { // This is the filter? if (pFilter->GetFlags().CanImport && pFilter->pOILFilter->Position == SelectedPos) break; // Try the next filter pFilter = Filter::GetNext(pFilter); } } // Check that the Filter existed if (pFilter == NULL) { // It did not... TRACE( _T("Can't find filter #%u in CCamDoc::DefaultDocumentRequired\n"), (UINT32) nPrefFilter); InformError(_R(IDT_CANT_FIND_FILTER)); return FALSE; } // Ask the filter or filter family about whether a default document is required. // If it is a filter family then we will have to work out what filter is actually // required and hence ask that filter the qeustion. if (!pFilter->IsDefaultDocRequired(pth.GetPath())) return TRUE; //Graham 22/10/97: First set the template that this document is based on SetTemplate(GetNextTemplateToUse()); SetNextTemplateToUse(); // Try to load the default document. return LoadDefaultDocument(); #endif }

bool CCamDoc::DeleteContents (   )  [protected, virtual]

Deletes this document's data. Called by MFC in various situations. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 25/3/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: Document::DeleteContents Definition at line 2289 of file camdoc.cpp. { m_pKernelDoc->SetCurrent(); m_pKernelDoc->DeleteContents(); return true; }

bool CCamDoc::DoNewDocument (   )  [protected, virtual]

Called to load the default document etc by CCamDoc::OnNewDocument. Does the actual load of the document data, without changin any flags etc. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 3/10/96 Returns: TRUE if successful. See also: CCamDoc::OnNewDocument Definition at line 676 of file camdoc.cpp. { // Set up the kernel. m_pKernelDoc->SetCurrent(); // If we've already 'new-ed' this document then bail out now. if (m_fDoneNewDoc) return TRUE; // Try to load the default document. if (!LoadDefaultDocument()) return FALSE; m_fDoneNewDoc = TRUE; #if (_OLE_VER >= 0x200) // Embedded docs (OLE or hidden) don't export preview bitmaps. if (IsEmbedded()) SetExportPreview(FALSE); #endif // Success. return TRUE; }

bool CCamDoc::DoOpenDocument (  const wxString &  strFilename  )  [protected, virtual]

Helper function to CCamDoc::OnOpenDocument. Does the actual load of the data, without disturbing any flags etc. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 3/10/96 Parameters: pcszPathName  --- path to file to open (NULL means an embeddeding). [INPUTS] Returns: TRUE if successful. See also: CCamDoc::OnOpenDocument; CCamDoc::LoadFromStorage Definition at line 975 of file camdoc.cpp. { // Create and open the appropriate kind of file. CCLexFile *pFile = CreateCCFile( strFilename.c_str(), ios::in ); if (!pFile) return FALSE; // Set up the kernel. m_pKernelDoc->SetCurrent(); // Try to load the document and it's item, if it's embedded. bool fOK = false; try { #ifndef STANDALONE // Before we open the file we must ask the filter system to work out what filter is // required to load the file, ask that filter if it requires a default document or not // and if it says yes then load the default document in. Required because if a file such // as a bitmap is loaded the user would expect to see this loaded into the default // document, as this file format defines no document structure, otherwise the default // constructed document would be used. // Only returns False if a problem happened in the testing and loading process. // -- Standalone // Don't do it on a standalone version otherwise the items get loaded on top of the // document with all the info on rather than a blank page. // Note the selected document before we start anything // DocView* pOldSelView = DocView::GetSelected(); if (!DefaultDocumentRequired(pFile, FILTERID_USERCHOICE)) { TRACE( wxT("DefaultDocumentRequired failed in CCamDoc::OnOpenDocument - doh?\n") ); delete pFile; return FALSE; } #endif // Try to load the file. m_pKernelDoc->SetTemplateLoading(FALSE); // Note that it is not a template being loaded fOK = GeneralOpenDocument(pFile, FILTERID_USERCHOICE); #if (_OLE_VER >= 0x200) // Embedded docs (OLE or hidden) don't export preview bitmaps. if (IsEmbedded()) SetExportPreview(FALSE); #endif } catch( ... ) { // Tidy up. delete pFile; return FALSE; } // Did this work? delete pFile; return fOK; }

bool CCamDoc::DoSave (  LPCTSTR  lpszPathName, BOOL  bReplace = TRUE )  [protected, virtual]

This is an exact copy of the CDocument version of this function. I had to copy it out as I need to change the bit that displays the SaveAs dialog so that I could set it to the correct directory and generally change it about to meet our requirements. This function ends up calling OnSaveDocument above to do the actual saving. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 27/1/95 Parameters: lpszPathName  - path name where to save document file [INPUTS] if 'bReplace' is TRUE will change file name if successful (SaveAs) if 'bReplace' is FALSE will not change path name (SaveCopyAs) or clear the "dirty" flag. Returns: TRUE if it worked, FALSE if not Definition at line 1844 of file camdoc.cpp. { #ifdef STANDALONE // Do nothing on a standalone version return true; #else // Get the name to save it as and see if it is empty bool SaveAsNewName = false; wxString newName = lpszPathName; // See if we have loaded this document as an old EPS native format // If so, then give the user the oppertunity to rename the file so that we don't // overwrite the original old format document. // Don't though, if the document is unnamed, so we are going to do a 'save as ...' // operation anyway. if( m_pKernelDoc && m_pKernelDoc->IsLoadedAsVersion1File() && !newName.IsEmpty() ) { #ifndef _DEBUG // Old EPS format document so ask the user which format to save in ErrorInfo Info; Info.ErrorMsg = _R(IDS_OVERWRITEOLDFILE); Info.Button[0] = _R(IDS_OVERWRITE); Info.Button[1] = _R(IDB_SAVEAS); Info.Button[2] = _R(IDS_CANCEL); UINT32 Answer = AskQuestion(&Info); #else UINT32 Answer; if (!OpConvertFileFormats::IsActive ()) { // Old EPS format document so ask the user which format to save in ErrorInfo Info; Info.ErrorMsg = _R(IDS_OVERWRITEOLDFILE); Info.Button[0] = _R(IDS_OVERWRITE); Info.Button[1] = _R(IDB_SAVEAS); Info.Button[2] = _R(IDS_CANCEL); Answer = AskQuestion(&Info); } else { Answer = SaveAsNewName; } #endif if (Answer==_R(IDS_OVERWRITE)) // Rename the new file to make sure we don't overwrite old SaveAsNewName = FALSE; else if (Answer== _R(IDB_SAVEAS)) // Rename the new file to make sure we don't overwrite old SaveAsNewName = TRUE; else if (Answer==_R(IDS_CANCEL)) // User has chosen to abort the operation return FALSE; else ERROR3("Unknown Answer from AskQuestion"); // Once we have asked the question ensure that the user is not asked again // We need to set the loaded flag as FALSE to effectively say that the document // is now considered version 2. // In a save as operation, the document will switch to the new name. // Now Disabled, as cannot set it until actually saved the document as the user may choose // something like save as and then cancel the file dialog box //KernelDoc->SetLoadedAsVersion1File(FALSE); } // If the name is empty, i.e. wasn't loaded as a .xar (e.g. open a tiff file) or newly created // then ask the user for a name i.e. do a 'save as....' operation. // Also, if we loaded an old format eps xar file and the user has chosen to not overwrite the // file then we must give them a 'save as....' option. if (newName.IsEmpty() || SaveAsNewName) { // Its empty, so create a default name CDocTemplate* pTemplate = GetDocTemplate(); ASSERT(pTemplate != NULL); newName = m_strPathName; if (bReplace && newName.IsEmpty()) { // No path means untitled, so use the made-up name instead. // This is our stored form of the title before having any items such as ' * ' // or '(Copy)' appended. It is used by the close unsaved document, so warn user code // so should be reasonably safe. newName = (const TCHAR*) TitlePrefix; } // we will do it like this instead... // Set up the dialog String_256 FilterString(_R(IDS_SAVEFILTERS)); // Get the filename. String_256 Str((const char*)newName); // If the string is still empty, get a default out if (Str.IsEmpty()) Str.Load(_R(IDS_DEFAULTFILENAME)); // Build a pathname out of it PathName Path(Str); // Get some details, ready for the dialog String_256 LowxString = Path.GetLocation(FALSE); String_256 NameString = Path.GetFileName(); // create a dialog and use the path and name of the file if available, or // use the default path if not. String_256 DocName = GetKernelDocName(); // Sorry about the long names, but we are into OS Specific scary stuff here // Under Windows 95 the OnFileNameOK() function of CFileDialog does not work // As a Result we have to do the tests ourselves afterwards under win95 // by default we do not need to put the dialog up BOOL WeNeedToPutSaveAsDialogUpAgain = FALSE; // try the dialog do { // Default to only putting the dialog up the once. WeNeedToPutSaveAsDialogUpAgain = FALSE; // Create and display prepare the dialog SaveFileDialog SaveDialog(FilterString, LowxString, NameString, DocName); SaveDialog.PrepareDialog(); // Display the dialog TRACE( _T("Display the dialog\n")); BOOL Result = SaveDialog.OpenAndGetFileName(); // If they did not click on OK then stop right now if (!Result) return FALSE; // Make sure that the file name is OK // we only need to do this under windows 95, as other OS's will have already done it // Disable for VC4.0/MFC 4.0 as they have fixed it. #if _MFC_VER < 0x400 if (IsWin32c()) { TRACE( _T("Windows 95, testing for same file name after the event\n")); if (!SaveDialog.IsValidFilename()) WeNeedToPutSaveAsDialogUpAgain = TRUE; } #endif // Get the filename. wxString TempName(SaveDialog.m_ofn.lpstrFile); SaveDialog.AppendExtension(&TempName); Str = String_256(TempName); Path = PathName(Str); // Extract directory name (minus terminating backslash) and remember for next time. SaveDialog.SetDefaultPath(Path.GetLocation(FALSE)); } while(WeNeedToPutSaveAsDialogUpAgain); // Put the file name into the var set aside for it newName = (const char*) Str; } // Check that the document isn't already open. NOTE: this is only relevant // to OLE documents, as attempting to save a document with the same name as // an existing, open doc will stuff up the OLE registration code in the // CCamDoc::OnSaveDocument function, after overwriting the file itself... BOOL isDocumentOpen = FALSE; PORTNOTETRACE("other","CCamDoc::DoSave - remove OLE usage"); #ifndef EXCLUDE_FROM_XARALX #if (_OLE_VER >= 0x200) POSITION pos = AfxGetApp()->GetFirstDocTemplatePosition(); CDocTemplate::Confidence match = CDocTemplate::noAttempt; CDocTemplate* pTemplate = NULL; CDocument* pOpenDocument = NULL; // cycle through the document types until we've done them all, or we find that // the document is already open. while ((pos != NULL) && (match != CDocTemplate::yesAlreadyOpen)) { pTemplate = AfxGetApp()->GetNextDocTemplate(pos); ASSERT (pTemplate->IsKindOf(RUNTIME_CLASS(CDocTemplate))); ASSERT (pOpenDocument == NULL); match = pTemplate->MatchDocType(newName, pOpenDocument); // NOTE: make sure that the match isn't the document that we're editing, // otherwise we wouldn't be able to save documents at all... if (this == pOpenDocument) { match = CDocTemplate::noAttempt; pOpenDocument = NULL; } } // Determine whether document is already open or not if (match == CDocTemplate::yesAlreadyOpen) isDocumentOpen = TRUE; else isDocumentOpen = FALSE; #endif // (OLE_VER >= 0x200) #endif // End 'Already Open' check. if (isDocumentOpen == FALSE) { // Make a .bak version of the file here in case the save screws up // This will be removed after the save, unless they have the keep bak files option in // Rename the current version of the file to the same with a .bak extension // get the old filename String_256 BakFileName(newName); String_256 OldFileName = BakFileName; // Change the extension on NewFileName... PathName NewPathName = BakFileName; // and change its extension String_256 Extension(_R(IDS_BAKEXTENSION)); NewPathName.SetType(Extension); // Go find out where the temp directory is so that we can put the .bak file in there String_256 TempFileName; char* pTempName = _tgetenv("TEMP"); if (pTempName!=NULL) { TempFileName = String_256(pTempName); // See if we have a backslash String_8 LastChar; TempFileName.Right(&LastChar, 1); // if it isn't a \ then add one if (LastChar!=String_8("\\")) TempFileName += String_8("\\"); // Add the leaf name to it TempFileName += NewPathName.GetFileName(); TRACEUSER( "Neville", _T("TEMP file is %s\n"), (const char*)TempFileName); } // Copy the version with the new extension back over the original BakFileName = NewPathName.GetPath(); // Get these as strings we can use TCHAR* pBakName = NULL; TCHAR* pOldName = (TCHAR*) OldFileName; // If the user want .bak files then use a local name, // otherwise put the bak file in the temp directory if ((BaseFileDialog::MakeBakFiles) || (pTempName==NULL)) pBakName = (TCHAR*) BakFileName; else pBakName = (TCHAR*) TempFileName; // make sure they are not the same (ie, let them save files with a .bak extension) BOOL FileNamesSame = (BakFileName == OldFileName); if (!FileNamesSame) { // Make sure that the .bak version of the file does not exist // If these do not work (eg the .bak is read-only) then you // simply will not get your .bak file updated and run the risk // of loosing your current changes if the save fails. TRACEUSER( "Neville", _T("Check to see if %s exists\n"), pBakName); if (_taccess(pBakName, 0)==0) { TRACEUSER( "Neville", _T("deleteing %s\n"), pBakName); unlink(pBakName); } // Now rename the original file (but only if the old filename exists) TRACEUSER( "Neville", _T("Check to see if %s exists\n"), pOldName); if (_taccess(pOldName, 0)==0) { // Rename the original artwork to a .bak version of the file TRACEUSER( "Neville", _T("Renaming %s to %s\n"), pOldName, pBakName); INT32 RenameResult = _trename(pOldName, pBakName); // if we fail to rename the file, but the user wants renamed files, complain if ((RenameResult!=0) && (BaseFileDialog::MakeBakFiles)) { // There was a problem renaming the file, ask if we want to go on ErrorInfo Info; Info.ErrorMsg = _R(IDS_RENAMEFAILED); Info.Button[0] = _R(IDS_SAVEANYWAY); Info.Button[1] = _R(IDS_ABORTSAVE); // If not then stop right away. if (AskQuestion(&Info)==_R(IDS_ABORTSAVE)) return FALSE; } } } // This may take a while ... String_64 strProgress; strProgress.MakeMsg(_R(IDS_WAIT_UPDATING_DOC_PFX), (LPCTSTR) GetTitle()); BeginSlowJob( -1, FALSE, NULL ); #if (_OLE_VER >= 0x200) // If the document is embedded and this isn't SaveCopyAs then don't export a preview // bitmap. BOOL fOldPrev; if (IsEmbedded() && !bReplace) { TRACEUSER( "JustinF", _T("Exporting preview for embedded item in CCamDoc::DoSave\n")); fOldPrev = SetExportPreview(TRUE); } #endif // Do the actual saving BOOL fOK = OnSaveDocument(newName); #if (_OLE_VER >= 0x200) // Restore the original setting if we changed it. if (IsEmbedded() && !bReplace) SetExportPreview(fOldPrev); #endif // Was the save successful? if (!fOK) { // The save failed here, so tidy up // be sure to delete the corrupt file TRACEUSER( "Neville", _T("Save failed, removing %s\n"), newName); remove(newName); // Well, something went a bit wrong there, so copy the old version of the file // over the top of the rubbish one if we have the .bak version that is if (!FileNamesSame) { // If the bak file exists, rename it over the original TRACEUSER( "Neville", _T("Check to see if %s exists\n"), pBakName); if (_taccess(pBakName, 0) == 0) { TRACEUSER( "Neville", _T("renaming %s to %s\n"), pBakName, pOldName); _trename(pBakName, pOldName); } } // return that we failed EndSlowJob(); return FALSE; } // The save worked, so get rid of the bak file if they do not want it // if we do not want bak file around the place, then get rid of them if (!BaseFileDialog::MakeBakFiles) { TRACEUSER( "Neville", _T("bak files not wanted, getting rid of it\n")); // Make sure the .bak file was not the real file as well! if (!FileNamesSame) { // If the bak file exists, delete it TRACEUSER( "Neville", _T("Check to see if %s exists\n"), pBakName); if (_taccess(pBakName, 0)==0) { TRACEUSER( "Neville", _T("Deleting %s\n"), pBakName); unlink(pBakName); } } } // Once we have saved the document ok, then ensure that the user is not asked again if (KernelDoc) KernelDoc->SetLoadedAsVersion1File(FALSE); // reset the title and change the document name if (bReplace) { // If we have just changed the name of the document, then get rid of the copy flag SetCopy(FALSE); // We saved the file under a new name, as opposed to a copy of the file, so it is // no longer "dirty". SetModified(FALSE); // Set the name of the document SetPathName(newName); } EndSlowJob(); return TRUE; // success } // Document is already open and registered else { // MessageBox (NULL, _R(IDS_OVERWRITEOPENFILE), NULL, MB_ICONERROR); UINT32 Answer; ErrorInfo Info; Info.ErrorMsg = _R(IDS_OVERWRITEOPENFILE); Info.Button[0] = _R(IDS_CANCEL); Answer = AskQuestion(&Info); return FALSE; // could not open document } // End of isDocumentOpen (OLE registration check) #endif // Not standalone (see first few lines) }

bool CCamDoc::DoSaveDocument (  const wxString &  strPathName  )  [protected, virtual]

Helper function for CCamDoc::OnSaveDocument. Does the actual saving of the data, without disturbing aby flags etc. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 3/10/96 Parameters: pcszPathName  --- path to the file to load (NULL means an embedding) [INPUTS] Returns: TRUE if successful. See also: CCamDoc::OnSaveDocument; CCamDoc::SaveToStorage Definition at line 805 of file camdoc.cpp. { // Create and open the appropriate kind of file. CCLexFile* pFile = CreateCCFile( strPathName, ios::out | ios::trunc); if (!pFile) return FALSE; // Make sure the kernel is set up. m_pKernelDoc->SetCurrent(); // Try to save the document. // WEBSTER - markn 28/1/97 // Native file saving is to be .web, not .xar #ifndef WEBSTER bool fOK = FALSE != InvokeNativeFileOp( OPTOKEN_NATIVESAVE, pFile, FILTERID_NATIVE ); #else bool fOK = FALSE != InvokeNativeFileOp( OPTOKEN_NATIVESAVE, pFile, FILTERID_WEB ); #endif // WEBSTER // Did that work? delete pFile; return fOK; }

BOOL CCamDoc::EnableRemoveUntouchedDocs (   )  [static]

Enable to idle-time removal of untouched documents. Called when the user creates new documents or opens existing documents from the highest possible level: menucmds.cpp. Author: Phil_Martin (Xara Group Ltd) <camelotdev@xara.com> Date: 11/10/96 Returns: TRUE if successful, FALSE otherwise Definition at line 563 of file camdoc.cpp. { PORTNOTE("other", "Removed idle processing"); #ifndef EXCLUDE_FROM_XARALX s_fRunIdleProcessing = TRUE; #endif return TRUE; }

bool CCamDoc::GeneralOpenDocument (  CCLexFile *  pFile, UINT32  nPrefFilter )  [protected, virtual]

This function will load a document with the name provided to help out the OnNewDocument and the OpOpenDocument, since they do mostly the same thing. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 3/4/95 Parameters: pFile  - the file to load the document from. [INPUTS] nPrefFilter - the preferred filter to use, usually FILTERID_GENERIC. Pass -1 to use the last filter the user chose in a file dialog box. Returns: TRUE if the document was opened ok, FALSE if there was a problem See also: CCamDoc::OnOpenDocument; CCamDoc::OnNewDocument Definition at line 240 of file camdoc.cpp. { // We need to make sure that the Current DocView is the same as the Selected DocView here /* TRACEUSER( "JustinF", _T("In CCamDoc::GeneralOpenDocument(%p, %u)\n"), (LPVOID) pFile, nPrefFilter); */ DocView *pDocView = DocView::GetCurrent(); DocView *pOldSelView = DocView::GetSelected(); if (pDocView != NULL) { // There was a current DocView, see if its got anything to do with out new doc // it should do if (pDocView->GetDoc() == m_pKernelDoc) { // make it the selected view Document::SetSelectedViewAndSpread( m_pKernelDoc, pDocView, NULL ); }