tbx  0.7.3
textchangedlistener.h
1 /*
2  * tbx RISC OS toolbox library
3  *
4  * Copyright (C) 2010 Alan Buckley All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the "Software"),
8  * to deal in the Software without restriction, including without limitation
9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10  * and/or sell copies of the Software, and to permit persons to whom the
11  * Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included
14  * in all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22  * THE SOFTWARE.
23  */
24 
25 #ifndef TBX_TEXTCHANGEDLISTENER_H_
26 #define TBX_TEXTCHANGEDLISTENER_H_
27 
28 #include "listener.h"
29 #include "eventinfo.h"
30 #include "gadget.h"
31 
32 namespace tbx
33 {
39  class TextChangedEvent : public EventInfo
40  {
41  public:
46  EventInfo(id_block, data) {};
47 
51  virtual ~TextChangedEvent() {};
52 
53 
60  bool too_long() const {return (_data.word[3] & 1)!=0;}
61 
71  std::string text() const {return (too_long()) ? text_from_gadget() : text_from_event();}
72 
73  protected:
80  virtual std::string text_from_gadget() const = 0;
81 
85  std::string text_from_event() const {return std::string(reinterpret_cast<const char *>(_data.word +4));}
86 
87  };
88 
93  {
94  public:
98  virtual void text_changed(TextChangedEvent &event) = 0;
99  };
100 }
101 
102 #endif /* TBX_TEXTCHANGEDLISTENER_H_ */
PollBlock & _data
raw data from the event
Definition: eventinfo.h:53
Event details for a change of text in a gadget.
Definition: textchangedlistener.h:39
Structure holding the raw data from a call to Wimp_Poll.
Definition: pollinfo.h:71
virtual ~TextChangedEvent()
Virtual destructor.
Definition: textchangedlistener.h:51
std::string text() const
Get the text of the gadget that delivered the event.
Definition: textchangedlistener.h:71
virtual void text_changed(TextChangedEvent &event)=0
The text has been changed.
Listener for text changed events.
Definition: textchangedlistener.h:92
Class to provide information on a toolbox event.
Definition: eventinfo.h:48
Base class for all toolbox event listeners.
Definition: listener.h:33
int word[64]
Array containing information return from Wimp_Poll.
Definition: pollinfo.h:76
bool too_long() const
Check if new text was delivered with the toolbox event.
Definition: textchangedlistener.h:60
const IdBlock & id_block() const
IdBlock for the current event.
Definition: eventinfo.h:71
std::string text_from_event() const
text from event data
Definition: textchangedlistener.h:85
Information passed back by the Toolbox with each toolbox event providing information on where the eve...
Definition: pollinfo.h:41
TextChangedEvent(IdBlock &id_block, PollBlock &data)
Construct the event.
Definition: textchangedlistener.h:45
virtual std::string text_from_gadget() const =0
Override in sub class to fetch text from the gadget.