ArduinoLibs
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Form.h
1 /*
2  * Copyright (C) 2012 Southern Storm Software, Pty Ltd.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included
12  * in all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20  * DEALINGS IN THE SOFTWARE.
21  */
22 
23 #ifndef Form_h
24 #define Form_h
25 
26 #include "LCD.h"
27 
28 class Field;
29 
30 #define FORM_CHANGED 1
31 
32 class Form {
33 public:
34  explicit Form(LiquidCrystal &lcd);
35  ~Form();
36 
37  int dispatch(int event);
38 
39  void nextField();
40  void prevField();
41  void defaultField();
42 
43  void addField(Field *field);
44  void removeField(Field *field);
45 
46  Field *currentField() const { return current; }
47  void setCurrentField(Field *field);
48 
49  bool isCurrent(Field &field) const { return current == &field; }
50 
51  void show();
52  void hide();
53  bool isVisible() const { return visible; }
54 
55 private:
56  LiquidCrystal *_lcd;
57  Field *first;
58  Field *last;
59  Field *current;
60  bool visible;
61 
62  friend class Field;
63 };
64 
65 #endif
bool isVisible() const
Returns true if the form is shown; false if the form is hidden.
Definition: Form.h:53
Form(LiquidCrystal &lcd)
Constructs a new form and associates it with lcd.
Definition: Form.cpp:47
Manages a single data input/output field within a Form.
Definition: Field.h:28
int dispatch(int event)
Dispatches event to the currently active field using Field::dispatch().
Definition: Form.cpp:99
Manager for a form containing data input/output fields.
Definition: Form.h:32
void nextField()
Changes to the next field in the "tab order".
Definition: Form.cpp:118
void addField(Field *field)
Adds field to this form.
Definition: Form.cpp:165
void hide()
Hides the form, or does nothing if the form is not on-screen.
Definition: Form.cpp:293
void removeField(Field *field)
Removes field from this form.
Definition: Form.cpp:187
void setCurrentField(Field *field)
Sets the current field that is displayed on-screen.
Definition: Form.cpp:230
~Form()
Detaches all remaining fields and destroys this form.
Definition: Form.cpp:58
void show()
Shows the form, or does nothing if the form is already on-screen.
Definition: Form.cpp:274
void defaultField()
Changes to default field (i.e., the first field).
Definition: Form.cpp:152
bool isCurrent(Field &field) const
Returns true if field is currently displayed on-screen, false otherwise.
Definition: Form.h:49
void prevField()
Changes to the previous field in the "tab order".
Definition: Form.cpp:135
Field * currentField() const
Returns the current field that is displayed on-screen.
Definition: Form.h:46