NCBI C++ ToolKit
|
Search Toolkit Book for CEditAppTask
CDataLoadingAppTask - a task that executes CDataLoadingAppJob. More...
#include <gui/packages/pkg_sequence_edit/edit_job.hpp>
Public Member Functions | |
CEditAppTask (CEditAppJob &job, const string &descr=kEmptyStr) | |
CEditAppTask. More... | |
IAppTask interface implementation | |
virtual ETaskState | Run () |
we override this function because our logic is a bit more complex than one implemented in CAppJobTask::Run() - under some circumstances we may need to show a dialog and then relaunch the job. More... | |
Public Member Functions inherited from CAppJobTask | |
CAppJobTask (bool visible, const string &descr=kEmptyStr, int prog_rep_period=5, const string &engine_name="ThreadPool", int display_delay=0) | |
CAppJobTask (IAppJob &job, bool visible, const string &descr=kEmptyStr, int prog_rep_period=5, const string &engine_name="ThreadPool", int display_delay=0) | |
virtual | ~CAppJobTask () |
void | SetReportErrors (bool report) |
enabled / disbale error reporting for failed Jobs More... | |
CIRef< IAppJob > | GetJob () |
void | OnAppJobNotification (CEvent *event) |
functions below handle notifications from the IAppJob More... | |
void | OnAppJobProgress (CEvent *event) |
void | OnAppJobDataReady (CEvent *event) |
virtual void | CancelBackgrounded () |
make a request to cancel backgrounded task (not called for foreground tasks) More... | |
virtual string | GetStatusText () const |
returns human-readable text describing the current task state More... | |
Public Member Functions inherited from CAppTask | |
CAppTask (const string &descr=kEmptyStr, bool visible=true, int display_delay=0) | |
CAppTask. More... | |
virtual ETaskState | GetState () |
returns the current task state More... | |
virtual void | OnCancel () |
this will be called on pending tasks that will be removed from the queue and won't get a chance to run the purpose is to implement any cleanup procedures for the canceled task More... | |
virtual bool | IsVisible () |
returns true if the task should be visible in UI visible task shall represent operations understood by users and usually correspond to menu commands. More... | |
int | GetStatusDisplayDelay () |
returns delay in seconds used for certain fast (and not very important tasks) to only show its status when it is running/pending for long enough More... | |
virtual string | GetDescr () const |
returns a human-readable description of the Task (optional) More... | |
virtual void | SetListener (CEventHandler *handler) |
set a Listener; this allows a taks running in background to notify the Listener (usually Task Manager) about changes in Status More... | |
virtual IEventLogAction * | CreateEventLogAction () |
returns an action for activating task results (optional, can return NULL) More... | |
Public Member Functions inherited from CObjectEx | |
CObjectEx (void) | |
virtual | ~CObjectEx (void) |
Public Member Functions inherited from CObject | |
CObject (void) | |
Constructor. More... | |
CObject (const CObject &src) | |
Copy constructor. More... | |
virtual | ~CObject (void) |
Destructor. More... | |
CObject & | operator= (const CObject &src) THROWS_NONE |
Assignment operator. More... | |
bool | CanBeDeleted (void) const THROWS_NONE |
Check if object can be deleted. More... | |
bool | IsAllocatedInPool (void) const THROWS_NONE |
Check if object is allocated in memory pool (not system heap) More... | |
bool | Referenced (void) const THROWS_NONE |
Check if object is referenced. More... | |
bool | ReferencedOnlyOnce (void) const THROWS_NONE |
Check if object is referenced only once. More... | |
void | AddReference (void) const |
Add reference to object. More... | |
void | RemoveReference (void) const |
Remove reference to object. More... | |
void | ReleaseReference (void) const |
Remove reference without deleting object. More... | |
virtual void | DoNotDeleteThisObject (void) |
Mark this object as not allocated in heap – do not delete this object. More... | |
virtual void | DoDeleteThisObject (void) |
Mark this object as allocated in heap – object can be deleted. More... | |
void * | operator new (size_t size) |
Define new operator for memory allocation. More... | |
void * | operator new[] (size_t size) |
Define new[] operator for 'array' memory allocation. More... | |
void | operator delete (void *ptr) |
Define delete operator for memory deallocation. More... | |
void | operator delete[] (void *ptr) |
Define delete[] operator for memory deallocation. More... | |
void * | operator new (size_t size, void *place) |
Define new operator. More... | |
void | operator delete (void *ptr, void *place) |
Define delete operator. More... | |
void * | operator new (size_t size, CObjectMemoryPool *place) |
Define new operator using memory pool. More... | |
void | operator delete (void *ptr, CObjectMemoryPool *place) |
Define delete operator. More... | |
virtual void | DebugDump (CDebugDumpContext ddc, unsigned int depth) const |
Define method for dumping debug information. More... | |
Public Member Functions inherited from CDebugDumpable | |
CDebugDumpable (void) | |
virtual | ~CDebugDumpable (void) |
void | DebugDumpText (ostream &out, const string &bundle, unsigned int depth) const |
void | DebugDumpFormat (CDebugDumpFormatter &ddf, const string &bundle, unsigned int depth) const |
void | DumpToConsole (void) const |
Public Member Functions inherited from CWeakObject | |
CWeakObject (void) | |
virtual | ~CWeakObject (void) |
CPtrToObjectProxy * | GetPtrProxy (void) const |
Get pointer to proxy object containing pointer to this object. More... | |
Public Member Functions inherited from IAppTask | |
virtual | ~IAppTask () |
Public Member Functions inherited from CEventHandler | |
CEventHandler () | |
CEventHandler. More... | |
virtual | ~CEventHandler () |
virtual void | AddListener (CEventHandler *listener, int pool_name=ePool_Default) |
Add a listener. More... | |
virtual void | RemoveListener (CEventHandler *listener) |
Remove a listener. More... | |
virtual void | RemoveAllListeners (void) |
virtual bool | HasListener (CEventHandler *listener, int pool_name=ePool_Default) const |
returns "true" if the given listener belongs to the specified pool More... | |
virtual const TListeners * | GetListeners (int pool_name=ePool_Default) const |
returns a set of listeners fro the specified pool More... | |
virtual bool | OnEvent (CEvent *evt) |
Processes en event. Returns "true" if event has been processed. More... | |
virtual bool | Dispatch (CEvent *evt, EDispatch disp_how=eDispatch_Default, int pool_name=ePool_Default) |
Dispatches an event to the listeners (but does not handle it). More... | |
virtual bool | Send (CEvent *evt, EDispatch disp_how=eDispatch_Default, int pool_name=ePool_Default) |
Sends an event synchronously. More... | |
virtual bool | Send (CEvent *evt, int pool_name) |
void | Post (CRef< CEvent > evt, EDispatch disp_how=eDispatch_Default, int pool_name=ePool_Default) |
Handles an event asynchronously (process and/or dispatch). More... | |
Additional Inherited Members | |
Public Types inherited from CObject | |
enum | EAllocFillMode { eAllocFillNone = 1 , eAllocFillZero , eAllocFillPattern } |
Control filling of newly allocated memory. More... | |
typedef CObjectCounterLocker | TLockerType |
Default locker type for CRef. More... | |
typedef atomic< Uint8 > | TCounter |
Counter type is CAtomiCounter. More... | |
typedef Uint8 | TCount |
Alias for value type of counter. More... | |
Public Types inherited from IAppTask | |
enum | ETaskState { eInvalid = -1 , eInitial , eRunning , eBackgrounded , eCompleted , eFailed , eCanceled , eLastState } |
List of task states defining the task management FSM. More... | |
Public Types inherited from CEventHandler | |
enum | EDispatch { eDispatch_SelfOnly , eDispatch_AllHandlers , eDispatch_FirstHandler , eDispatch_Default = eDispatch_AllHandlers } |
enum controlling dispatching strategies More... | |
enum | EPoolName { ePool_Default = 0 , ePool_Parent , ePool_Child , ePool_Sibling , ePool_NextAvailable } |
Identifiers for standard pools. More... | |
typedef vector< CEventHandler * > | TListeners |
typedef map< int, TListeners > | TPools |
typedef list< AutoPtr< SPostRequest > > | TPostRequests |
typedef std::map< CEventHandler *, int > | THandlerToCount |
typedef void(* | FOnPostCallback) () |
Static Public Member Functions inherited from CAppTask | |
static string | StateToString (ETaskState state) |
Static Public Member Functions inherited from CObject | |
static NCBI_XNCBI_EXPORT void | ThrowNullPointerException (void) |
Define method to throw null pointer exception. More... | |
static NCBI_XNCBI_EXPORT void | ThrowNullPointerException (const type_info &type) |
static EAllocFillMode | GetAllocFillMode (void) |
static void | SetAllocFillMode (EAllocFillMode mode) |
static void | SetAllocFillMode (const string &value) |
Set mode from configuration parameter value. More... | |
Static Public Member Functions inherited from CDebugDumpable | |
static void | EnableDebugDump (bool on) |
Static Public Member Functions inherited from CEventHandler | |
static bool | HandlePostRequest () |
static void | ClearPostQueue () |
erases all events from the queue More... | |
static void | DestroyPostQueue () |
Static Public Attributes inherited from CObject | |
static const TCount | eCounterBitsCanBeDeleted = 1 << 0 |
Define possible object states. More... | |
static const TCount | eCounterBitsInPlainHeap = 1 << 1 |
Heap signature was found. More... | |
static const TCount | eCounterBitsPlaceMask |
Mask for 'in heap' state flags. More... | |
static const int | eCounterStep = 1 << 2 |
Skip over the "in heap" bits. More... | |
static const TCount | eCounterValid = TCount(1) << (sizeof(TCount) * 8 - 2) |
Minimal value for valid objects (reference counter is zero) Must be a single bit value. More... | |
static const TCount | eCounterStateMask |
Valid object, and object in heap. More... | |
Protected Types inherited from CAppJobTask | |
using | TOnAppJobProgressCallback = std::function< void(const IAppJobProgress &)> |
typedef CAppJobDispatcher::TJobID | TJobID |
Protected Member Functions inherited from CAppJobTask | |
virtual ETaskState | x_OnWakeUp () |
"wakes up" a backgrounded job to resume processing More... | |
virtual void | x_Finish (IAppJob::EJobState state) |
virtual void | x_ReportError () |
void | x_SetOnAppJobProgress (TOnAppJobProgressCallback callback) |
Protected Member Functions inherited from CAppTask | |
virtual ETaskState | x_Run () |
override this function in derived classes More... | |
virtual bool | x_IsFiniteState () |
Protected Member Functions inherited from CObject | |
virtual void | DeleteThis (void) |
Virtual method "deleting" this object. More... | |
Protected Member Functions inherited from CWeakObject | |
void | CleanWeakRefs (void) const |
Method cleaning all CWeakRefs referencing at this moment to the object After calling to this method all existing CWeakRefs referencing to the object will return NULL, so it effectively will be equal to deleting the object. More... | |
Protected Member Functions inherited from CEventHandler | |
virtual const SEvtMap * | GetEventMap () const |
void | x_DeclareDead () |
Removes itself unavailable for async event delivery. More... | |
void | x_AddListenerToPool (CEventHandler *listener, int pool_name) |
Protected Attributes inherited from CAppJobTask | |
string | m_EngineName |
CIRef< IAppJob > | m_Job |
int | m_ProgressReportPeriod |
bool | m_ReportErrors |
TJobID | m_JobID |
IAppJob::EJobState | m_JobState |
string | m_StatusText |
TOnAppJobProgressCallback | m_OnAppJobProgress |
Protected Attributes inherited from CAppTask | |
CEventHandler * | m_Listener |
ETaskState | m_State |
const bool | m_Visible |
indicates whether the task is visible More... | |
string | m_Descr |
task description More... | |
int | m_DisplayDelay |
tasks display delay More... | |
Protected Attributes inherited from CEventHandler | |
TPools | m_Pools |
Static Protected Attributes inherited from CEventHandler | |
static const SEvtMap | sm_EvtMap |
CDataLoadingAppTask - a task that executes CDataLoadingAppJob.
Definition at line 97 of file edit_job.hpp.
CEditAppTask::CEditAppTask | ( | CEditAppJob & | job, |
const string & | descr = kEmptyStr |
||
) |
Definition at line 136 of file edit_job.cpp.
References CAppJob::GetDescr(), kEmptyStr, and CAppTask::m_Descr.
|
virtual |
we override this function because our logic is a bit more complex than one implemented in CAppJobTask::Run() - under some circumstances we may need to show a dialog and then relaunch the job.
Reimplemented from CAppJobTask.
Definition at line 145 of file edit_job.cpp.
References _ASSERT, IAppTask::eCompleted, CAppJobTask::GetJob(), CRef< C, Locker >::GetPointer(), and CAppJobTask::Run().