ProjectManager::ProjectChooser Class Reference

Callable object that supplies the chooser argument of ProjectFileManager::OpenFile. More...

#include <ProjectManager.h>

Collaboration diagram for ProjectManager::ProjectChooser:

Public Member Functions
	ProjectChooser (AudacityProject *pProject, bool reuseNonemptyProject)
	ProjectChooser (const ProjectChooser &)=delete
	Don't copy. Use std::ref to pass it to ProjectFileManager. More...
	~ProjectChooser ()
	Destroy any fresh project, or rollback the existing project, unless committed. More...
AudacityProject &	operator() (bool openingProjectFile)
	May create a fresh project. More...
void	Commit ()
	Commit the creation of any fresh project or changes to the existing project. More...

Private Attributes
AudacityProject *	mpGivenProject
AudacityProject *	mpUsedProject = nullptr
bool	mReuseNonemptyProject

Detailed Description

Callable object that supplies the chooser argument of ProjectFileManager::OpenFile.

Its operator(), called lower down in ProjectFileManager, decides which project to put new file data into, using file type information deduced there. It may have the side effect of creating a project.

At the higher level where it is constructed, it provides conditional RAII. One indicates there that the file opening succeeded by calling Commit(). But if that is never called, creation of projects, or changes to a preexisting project, are undone.

Definition at line 65 of file ProjectManager.h.

Constructor & Destructor Documentation

ProjectChooser() [1/2]

ProjectManager::ProjectChooser::ProjectChooser ( AudacityProject *  pProject, bool  reuseNonemptyProject  )

inline

Parameters

pProject	if not null, an existing project to reuse if possible
reuseNonemptyProject	if true, may reuse the given project when nonempty, but only if importing (not for a project file)

Definition at line 72 of file ProjectManager.h.

         : mpGivenProject{ pProject }
         , mReuseNonemptyProject{ reuseNonemptyProject }
      {}

ProjectChooser() [2/2]

ProjectManager::ProjectChooser::ProjectChooser ( const ProjectChooser &  )

delete

Don't copy. Use std::ref to pass it to ProjectFileManager.

~ProjectChooser()

ProjectManager::ProjectChooser::~ProjectChooser

(

)

Destroy any fresh project, or rollback the existing project, unless committed.

Definition at line 674 of file ProjectManager.cpp.

{
   if (mpUsedProject) {
      if (mpUsedProject == mpGivenProject) {
         // Ensure that it happens here: don't wait for the application level
         // exception handler, because the exception may be intercepted
         ProjectHistory::Get(*mpGivenProject).RollbackState();
         // Any exception now continues propagating
      }
      else
         GetProjectFrame( *mpUsedProject ).Close(true);
   }
}

References ProjectHistory::Get(), GetProjectFrame(), mpGivenProject, mpUsedProject, and ProjectHistory::RollbackState().

Here is the call graph for this function:

Member Function Documentation

Commit()

void ProjectManager::ProjectChooser::Commit

(

)

Commit the creation of any fresh project or changes to the existing project.

Definition at line 703 of file ProjectManager.cpp.

{
   mpUsedProject = nullptr;
}

operator()()

AudacityProject & ProjectManager::ProjectChooser::operator()

(

bool

openingProjectFile

)

May create a fresh project.

Definition at line 689 of file ProjectManager.cpp.

{
   if (mpGivenProject) {
      // Always check before opening a project file (for safety);
      // May check even when opening other files
      // (to preserve old behavior; as with the File > Open command specifying
      // multiple files of whatever types, so that each gets its own window)
      bool checkReuse = (openingProjectFile || !mReuseNonemptyProject);
      if (!checkReuse || SafeToOpenProjectInto(*mpGivenProject))
         return *(mpUsedProject = mpGivenProject);
   }
   return *(mpUsedProject = New());
}

References ProjectManager::New(), and ProjectManager::SafeToOpenProjectInto().

Here is the call graph for this function:

Member Data Documentation

mpGivenProject

AudacityProject* ProjectManager::ProjectChooser::mpGivenProject

private

Definition at line 86 of file ProjectManager.h.

Referenced by ~ProjectChooser().

mpUsedProject

AudacityProject* ProjectManager::ProjectChooser::mpUsedProject = nullptr

private

Definition at line 87 of file ProjectManager.h.

Referenced by ~ProjectChooser().

mReuseNonemptyProject

bool ProjectManager::ProjectChooser::mReuseNonemptyProject

private

Definition at line 88 of file ProjectManager.h.

---

The documentation for this class was generated from the following files:

• ProjectManager.h
• ProjectManager.cpp