Base class for exceptions specially processed by the application. More...

#include <AudacityException.h>

Inheritance diagram for AudacityException:

Public Member Functions
	AudacityException ()

virtual	~AudacityException ()=0

virtual void	DelayedHandlerAction ()=0
	Action to do in the main thread at idle time of the event loop. More...

Static Public Member Functions
static void	EnqueueAction (std::exception_ptr pException, std::function< void(AudacityException *)> delayedHandler)

Protected Member Functions
	AudacityException (const AudacityException &)=default
	Make this protected to prevent slicing copies. More...

	AudacityException (AudacityException &&)=delete
	Don't allow moves of this class or subclasses. More...

AudacityException &	operator= (const AudacityException &)=delete
	Disallow assignment. More...

Detailed Description

Base class for exceptions specially processed by the application.

Objects of this type can be thrown and caught in any thread, stored, and then used by the main thread in later idle time to explain the error condition to the user.

Definition at line 32 of file AudacityException.h.

Constructor & Destructor Documentation

◆ AudacityException() [1/3]

AudacityException::AudacityException ( )

inline

Definition at line 35 of file AudacityException.h.

35{}

◆ ~AudacityException()

AudacityException::~AudacityException ( )

pure virtual

Definition at line 18 of file AudacityException.cpp.

19{

20}

◆ AudacityException() [2/3]

AudacityException::AudacityException ( const AudacityException & )

protecteddefault

Make this protected to prevent slicing copies.

◆ AudacityException() [3/3]

AudacityException::AudacityException ( AudacityException && )

protecteddelete

Don't allow moves of this class or subclasses.

Member Function Documentation

◆ DelayedHandlerAction()

virtual void AudacityException::DelayedHandlerAction ( )

pure virtual

Action to do in the main thread at idle time of the event loop.

Implemented in MessageBoxException, UserException, Journal::SyncException, and MessageBoxException.

Referenced by DefaultDelayedHandlerAction(), and AudacityApp::OnExceptionInMainLoop().

Here is the caller graph for this function:

◆ EnqueueAction()

void AudacityException::EnqueueAction	(	std::exception_ptr	pException,
		std::function< void(AudacityException *)>	delayedHandler
	)

static

Definition at line 22 of file AudacityException.cpp.

{
   BasicUI::CallAfter( [
      pException = std::move(pException), delayedHandler = std::move(delayedHandler)
   ] {
      try {
         std::rethrow_exception(pException);
      }
      catch( AudacityException &e )
         { delayedHandler( &e ); }
   } );
}

References BasicUI::CallAfter().

Here is the call graph for this function:

◆ operator=()

AudacityException & AudacityException::operator= ( const AudacityException & )

protecteddelete

Disallow assignment.

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

Public Member Functions

Static Public Member Functions

Protected Member Functions