source: src/Actions/ActionStatusList.hpp

Candidate_v1.6.1
Last change on this file was 26b4eb4, checked in by Frederik Heber <heber@…>, 10 years ago

Added observable ActionStatusList to ActionQueue.

  • this allows to fetch Status messages from Actions at a central place.
  • Action::pushStatus() as befriended proxy to ActionQueue::pushStatus() added.
  • equipped ActionStatusList with a thread lock to protect access.
  • Property mode set to 100644
File size: 1.9 KB
Line 
1/*
2 * ActionStatusList.hpp
3 *
4 * Created on: Jun 19, 2014
5 * Author: heber
6 */
7
8
9#ifndef ACTIONSTATUSLIST_HPP_
10#define ACTIONSTATUSLIST_HPP_
11
12// include config.h
13#ifdef HAVE_CONFIG_H
14#include <config.h>
15#endif
16
17#include <boost/thread.hpp>
18#include <list>
19#include <string>
20
21#include "CodePatterns/Assert.hpp"
22#include "CodePatterns/Observer/Observable.hpp"
23
24namespace MoleCuilder {
25
26class ActionQueue;
27
28/** Class contains list of status messages and can be observed by UI's StatusBars.
29 *
30 * It always belongs to the ActionQueue.
31 *
32 */
33class ActionStatusList : public Observable
34{
35 //!> only ActionQueue may create this class
36 friend class ActionQueue;
37private:
38 /** Constructor for class ActionStatusList.
39 *
40 */
41 ActionStatusList();
42
43 /** Destructor for class ActionStatusList.
44 *
45 */
46 virtual ~ActionStatusList();
47
48 /** Function to push a message to the list.
49 *
50 * This is only accessible to ActionQueue to prevent anything but Actions
51 * to give a Status message. ActionQueue::pushStatus() has access.
52 *
53 * \param _msg message to push
54 */
55 void pushMessage(const std::string &_msg);
56
57public:
58 /** Get first message to enter list and remove from list.
59 *
60 * \return first message in list
61 */
62 std::string popFirstMessage();
63
64 /** Get number of messages in the list.
65 *
66 * \return number of messages
67 */
68 size_t size() const
69 {
70 return m_StatusList.size();
71 }
72
73 //!> enumeration of all notification channels
74 enum NotificationType {
75 StatusAdded, // new status message added
76 NotificationType_MAX // denotes the maximum of available notification types
77 };
78
79private:
80 //!> typedef for the list of status message
81 typedef std::list<std::string> StatusList_t;
82 //> list of status message
83 StatusList_t m_StatusList;
84 //!> internal mutex to synchronize access to queue
85 boost::mutex mtx_queue;
86};
87
88}
89
90#endif /* ACTIONSTATUSLIST_HPP_ */
Note: See TracBrowser for help on using the repository browser.