Changes

Jump to: navigation, search

Console Framework Classes 20103 - OOP344

8,350 bytes removed, 14:09, 17 April 2013
m
Reverted edits by MCanaday49 (Talk) to last revision by Ldchen1
Start by creating mock-up classes (class declaration and definition with empty methods that only compiles and don't do anything)
Each class MUST have its own header file to hold its declaration and ""cpp" " file to hold its implementation. To make sure you do not do circular includes follow these simple guidelines:
* Add recompilation safeguards to all your header files.
* Always use forward declaration if possible instead of including a class.
* Use includes only in files in which the actual header file code is used. avoid ""just in case" " includes.
= General Internal Header file =
The general header file holds the common setting and definition between all classes in the frame work.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
#ifndef ___CONFW_H__
#define ___CONFW_H__
#define _CRT_SECURE_NO_WARNINGS
#endif
#include &amp;lt;<string.h&amp;gt;>
extern &amp;quot;"C&amp;quot;"{ #include &amp;quot;"iol.h&amp;quot;"
};
#define FW_BORDER_CHARS &amp;quot;"/-\\|/-\\|&amp;quot;"
#define FW_MAX_NO_FIELDS 100
# undef NO_HELPFUNC
#endif
#define NO_HELPFUNC ((void(*)(MessageStatus, FWDialog&amp;amp;))(0))
#ifdef NO_VALDFUNC
# undef NO_VALDFUNC
#endif
#define NO_VALDFUNC ((bool(*)(const char*, FWDialog&amp;amp;))(0))
#endif
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
=File Names=
Use the following rules to create filenames for your class.
These classes encapsulate all the functions written in IOL library in an Object Oriented method:
==Hierarchy==
&amp;lt;<big&amp;gt;&amp;lt;><pre&amp;gt;>
FWBorder
|
|-------- FWCheckList (Maybe?)
|-------- FWMenu (Maybe?)
&amp;lt;</pre&amp;gt;&amp;lt;></big&amp;gt;>
==FWBorder==
===Class Definition===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWBorder {
int _row;
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
====Properties====
int _row, holds the relative coordinate of top row of this border with respect to its container.&amp;lt;<br /&amp;gt;>int _col, same as _row, but for _col. &amp;lt;<br /&amp;gt;>int _height, height of the entity. &amp;lt;<br /&amp;gt;>int _width, width of the entity. &amp;lt;<br /&amp;gt;>char _border[9], characters used to draw the border: &amp;lt;<br /&amp;gt;>
: _border[0], left top
: _border[1], top side
: _border[6], bottom left
: _border[7], left side
bool _visible; Indicates if the border surrounding the entity is to be drawn or not. &amp;lt;<br /&amp;gt;>
FWBorder* _container; holds the container (another FWBorder) which has opened this one (owner or container of the current FWBorder). '''_container''' will be NULL if this FWBorder does not have a container, in which case, it will be full screen and no matter what the values of row, col, width and height are, FWBorder will be '''Full Screen''' (no border will be drawn)
====Methods====
The following are the pseudo code to get absRow( ) and as well as absCol( ):
&amp;lt;<pre&amp;gt;>
r = _row
Cnt = container
end
return r
&amp;lt;</pre&amp;gt;>
These two methods return the absolute coordinates of the FWBorder instance. (the row an column with respect to left top corner of the screen). These two functions are used to '''draw''' the border on the screen.
=====public=====
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWBorder(int Row=0, int Col=0, int Width=0,int Height=0,
bool Visible = false,
const char* Border=FW_BORDER_CHARS,
FWBorder* Container = (FWBorder*)0);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Sets the corresponding attributes to the incoming values in the argument list.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void visible(bool val);
bool visible()const;
int height()const;
int width()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
These Methods, set and get the corresponding attributes of the class
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool fullscreen()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns true if _container is null or else, it returns false;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual ~FWBorder();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
An empty virtual destructor.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual void draw(int refresh = FW_NO_REFRESH)const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
If _container is null then it just clears the screen and exits. &amp;lt;<br /&amp;gt;>Otherwise:&amp;lt;<br /&amp;gt;>
*If '''Refresh''' flag is set to FW_REFRESH, it will call the _container's draw, passing the same value as argument
*If the _visible flag is true, it will draw a box at _row and _col, with size of _width and _height using the _border characters and fills it with spaces. Otherwise it will just draw a box using spaces at the same location and same size.
Forward declaration of FWDialog is needed for this class;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWField: public FWBorder{
protected:
FWDialog* container();
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Attributes===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void* _data;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Will hold the address of any type of data a FWField can hold.
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWField(int Row = 0, int Col = 0,
int Width = 0, int Height =0,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Passes the corresponding attributes to it's parents constructor and then sets the _data attribute to the incoming Data argument.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
~FWField();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
An empty destructor
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual int edit() = 0;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Enforces the children to implement an edit() method
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual bool editable() const = 0;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Enforces the children to implement an editable() method that returns true if the class is to edit data and false if the class is to only display data.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual void set(const void* data) = 0;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Enforces the children to implement a set() method to set the _data attribute to the data the class is to work with.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual void* data();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns _data;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void container(FWDialog* theOwner);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Sets the _container attribute of FWBorder to '''theowner''' argument.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWDialog* container();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Casts the return value of FWBorder::container() to a FWDialog* and returns it.
FWLabel is child of FWField (therefore inheriting FWBorder too) responsible to display a short character string on the display.
This class is never editable
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWLabel: public FWField{
int _length;
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Attributes===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _length;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Holds the Length of the display area needed by iol_display.
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWLabel(const char *Str, int Row, int Col,
int Len = -1);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
*Passes corresponding arguments to its parent constructor
*Sets _length to the '''Len''' attribute.
*Then it will copy the content of what '''Str''' is pointing.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWLabel(int Row, int Col, int Len);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
*Passes corresponding arguments to its parent constructor
*Sets _length to the '''Len''' attribute.
This constructor is used when FWLabel is used for messaging and does not need initial value.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
~FWLabel();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Deallocates the memory pointed by _data;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void draw(int Refresh = FW_NO_REFRESH) const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Ignores the Refresh argument and make a direct call to '''iol_display''' to display the _data at '''absRow()''' and '''absCol()''' upto '''_length''' characters.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Since no editing is happening here, it just calls draw();
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool editable()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns False.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void set(const void* str);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
copies the string pointed by '''str''' upto '''_length''' characters to '''_data'''.
==FWDialog==
FWDialog is a collection of several FWField; it organizes and groups FWFields for user entry and interaction &amp;lt;<br /&amp;gt;>
The following definition is just a suggestion for how to implement this class. You can change it under with your professors confirmation to a better way if you like.
===Class Definition===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWDialog: public FWBorder{
int add(FWField* field, bool dynamic = true);
int add(FWField&amp;amp; field, bool dynamic = false); FWDialog&amp;amp; operator&amp;lt;&amp;lt;<<(FWField* field); FWDialog&amp;amp; operator&amp;lt;&amp;lt;<<(FWField&amp;amp; field);
FWField&amp;amp; operator[](unsigned int index); FWField&amp;amp; curField();
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Attributes===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _fnum;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Holds the number of FWFields added to FWDialog.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _curidx;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Holds the index of the FWFields that is being edited now.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWField* _fld[FW_MAX_NO_FIELDS];
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
An array of FWFields pointers. Initially all the elements of _fld is set to null. When a FWField is added to the form, it will be pointed by one of the elements of this array.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool _dyn[FW_MAX_NO_FIELDS];
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>An array of boolean values exactly to the number of elements of _fld. When FWField number &amp;quot;"n&amp;quot; " is added to FWDialog and is pointed by _fld[n-1], the corresponding _dyn[n-1] indicate if the FWField held in _fld[n-1] is dynamically allocated or not. the _dyn flags will be used in the destructor as deallocation condition for each _fld element.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool _editable;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Is set to true, if at least one of the FWFields in _fld is editable.
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWDialog(FWBorder *Container = (FWBorder*)0,
int Row = -1, int Col = -1,
bool Borderd = false,
const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Passes all the arguments to its parent constructor and then sets the FWDialog to an empty dialog.&amp;lt;<br /&amp;gt;>
(Sets all the Field pointers to null, flags to false and numbers to zero)
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
virtual ~FWDialog();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Loops through all the field pointers and checks to see if any of them are dynamically allocated and deletes them.
(it only deletes those fields that are flagged as dynamic)
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void draw(int fn = FW_NO_REFRESH)const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>If '''fn''' is '''FW_REFRESH''' or '''FW_FULL_FRAME''', it will call its parent draw with '''fn''' as its argument. Then It will draw all the '''Fields''' in the '''Dialog'''. &amp;lt;<br /&amp;gt;>If '''fn''' is '''FW_NO_REFRESH''', then it will just draw all the '''Fields''' in the '''Dialog'''.&amp;lt;<br /&amp;gt;>
If '''fn''' is a non-zero positive value, then it will only draw '''Field''' number '''fn''' in the dialog. (First added '''Field''' is field number one.)
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit(int fn = FW_NO_REFRESH);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
If '''FWDialog''' is not editable (all fields are non-editable), it will just display the Dialog and then waits for the user to enter a key and then terminates the function returning the key.&amp;lt;<br /&amp;gt;>
If fn is '''0''' or less, then before editing, the draw method is called with '''fn''' as its argument and then editing begins from the first editable Field.
Start editing from field number '''fn''';
Call the edit of each field and depending on the value returned, do the following:&amp;lt;<br /&amp;gt;>
# For '''ENTER_KEY''', '''TAB_KEY''' and '''DOWN_KEY''', go to next editable Field , if this is the last editable Field then restart from Field number one.
# For '''UP_KEY''' go to the previous editable Field, if there is no previous editable Field, go to the last editable Field in the Dialog.
# For any other key, terminate the edit function returning the character which caused the termination.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int add(FWField* field, bool dynamic = true);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Adds the '''FWField''' pointed by '''field''' to the Fields of the Dialog; by appending the value of the field pointer to the _fld array , setting the corresponding _dyn element to the value of dynamic argument and then increasing _fnum by one and returning it.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;"> int add(FWField&amp;amp; field, bool dynamic = false);&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Makes a direct call to the previous add() method, passing the address of the '''field''' argument and the value of the '''dynamic''' argument and returning what it returns.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;"> FWDialog&amp;amp; operator&amp;lt;&amp;lt;<<(FWField* field);&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Makes a direct call the first '''add()''' method returning a reference of the owner (the FWDialog);
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;"> FWDialog&amp;amp; operator&amp;lt;&amp;lt;<<(FWField&amp;amp; field);&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Makes a direct call the second '''add()''' method returning a reference of the owner (the FWDialog);
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool editable();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
If at least one editable field exist in the Dialog, it returns true, otherwise, it returns false;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int fieldNum()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns number of fields added to the Dialog.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int curIndex()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns the index of the Field that was just being edited.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;"> FWField&amp;amp; operator[](unsigned int index);&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns the reference of the Field with incoming index. (Note that here, the first field index is '''0''')
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;"> FWField&amp;amp; curField();&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns the reference of the Field that was just being edited.
===Class Definition===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWLineEdit: public FWField{
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWLineEdit(char* Str, int Row, int Col, int Width,
int Maxdatalen, int* Insertmode,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>LineEdit, sets the Field's _data to the value of str. If LineEdit is instantiated with this constructor then it will edit an external string provided by the caller function of LineEdit. LineEdit in this case is not creating any dynamic memory, therefore _dyn is set to false (therefore the destructor will not attempt to deallocate the memory pointed by _data).&amp;lt;<br /&amp;gt;>The location (row and col) and Bordered are directly passed to the parent (FWField) and str is passed as data to the parent constructor. Unlike Label, LineEdit could have border or not so depending on this (Bordered being true or false) the Height is set to 3 or 1 respectfully. &amp;lt;<br /&amp;gt;>
(hint: use '''? :''' operator to pass the proper value to FWField's constructor)
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWLineEdit(int Row, int Col, int Width,
int Maxdatalen, int* Insertmode,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Works exactly like the previous constructor with one difference; since no external data is passed to be edited here, this constructor must <span class="plainlinks">[http://www.thepiggybackrider.com/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;/*CITATION*/">kid carrier</span>]</span> &lt;span class=&quot;plainlinks&quot;&gt;[http://www.thepiggybackrider.com/ &lt;span style=&quot;color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;/*CITATION*/&quot;&gt;child carrier&lt;/span&gt;]&lt;/span&gt; allocate enough dynamic memory to accommodate editing of '''Maxdatalen''' characters. Then make it an empty string and set Fields's _data to point to it. Make sure _dyn is set to true in this case, so the destructor knows that it has to deallocate the memory at the end.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
~FWLineEdit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
If '''_dyn''' is true, it will deallocate the character array pointed by Fields's '''_data'''
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void draw(int Refresh = FW_NO_REFRESH)const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>If the Border is visible, it will first call Border's draw passing '''Refresh'''as an argument to it.&amp;lt;<br /&amp;gt;>Then it will make a direct call to iol_display to show the data kept in Field's '''_data'''.&amp;lt;<br /&amp;gt;>
The values used for the arguments of iol_display are:
*str: address of string pointed by _data + the value of _offset
*len: width() (''reduce by two is border is visible''')
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Makes and direct call to, and returns '''iol_edit()'''.
For the coordinates and width arguments follow the same rules as the draw function.
For the rest of the arguments of iol_edit, use the attributes of '''FWLineEdit'''.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool editable()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Always return true;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void set(const void* Str);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Copies the characters pointed by '''Str''' into the memory pointed by Field's '''_data''' up to '''_maxdatalen''' characters.
When in edit mode, to indicate the editing mode, it will surround the text with squared brackets.
===Class Definition===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWButton: public FWField{
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWButton(const char *Str, int Row, int Col,
bool Bordered = true,
const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>When creating a Button, allocate enough memory to hold the contents of the '''Str''' and set Field's _data to point to it. Then copy the content of '''Str''' into the newly allocated memory.&amp;lt;<br /&amp;gt;>Pass all the arguments directly to Field's constructor.&amp;lt;<br /&amp;gt;>For Field size (width and hight) do the following:&amp;lt;<br /&amp;gt;>
For width: Set width to the length of '''Str''' + 2 (adding 2 for surrounding brackets) or if the Button is bordered set width to the length of '''Str''' + 4 (adding 2 for surrounding brackets and 2 for the borders).
For height: Set the height to 1 or if the Button is bordered, set the height to 3.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
~FWButton();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Deallocates the allocated memory pointed by Field's '''_data'''.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void draw(int Refresh = FW_NO_REFRESH) const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
*First calls Border's draw()
use iol_display to display the Button's text (pointed by Field's _data)
*If bordered
*:display the text at absRow()+1 and absCol()+2
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>First draw() the Button, then surround it by squared brackets, place the cursor under the first character of Button's text and wait for user entry.&amp;lt;<br /&amp;gt;>When user hits a key, if the key is ENTER_KEY or SPACE, return FW_BUTTON_HIT (defined in confw.h) otherwise return the entered key.&amp;lt;<br /&amp;gt;>
Make sure the surrounding characters are replaced with spaces before exiting the edit() method.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool editable()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Always returns true;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void set(const void* str);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Reallocate memory for new text set it to content of '''str''':
:''First deallocated what is pointed by Field's '''_data'''.''&amp;lt;<br /&amp;gt;>
:''Then allocate new memory to the size of content of '''str''' and copy the content into it and make Field's '''_data''' point to it.''
FWCheck prints a checkbox and a Label in front of it and waits for user entry to possibly toggle the checkbox and exit.
===Class Definition===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWCheck : public FWLabel {
int _flag;
void checked(bool val);
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Attributes===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _flag;
int _radio;
char _format[4];
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
*'''_flag''' holds the status of the Checkbox (0: unchecked or 1: checked).
*'''_radio''' dictates the behavior of the Checkbox as a radio-button, or a check-mark.
*'''_format''' holds the characters, the Checkbox is drawn with (i.e. &amp;quot;"[X]&amp;quot;", &amp;quot;"(O)&amp;quot;", &amp;quot;&amp;lt;"<*&amp;gt;&amp;quot;>", etc...).
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWCheck(bool Checked,const char* Format, const char* Text, int Row, int Col, bool IsRadio = false);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
To create a FWCheck, pass Text, Row and Col + 4 to Parents Str, Row, Col. (added 4 to Col to make space for the checkmark at left).
Store Checked, IsRadio and Format in class attributes for future use.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void draw(int Refresh = FW_NO_REFRESH) const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>First call Label's draw passing Refresh as argument.&amp;lt;<br /&amp;gt;>Then display a checkbox using iol_displayflag() using '''_format''' and '''_flag''' at absRow() and absCol(). &amp;lt;<br /&amp;gt;>
''(make sure there is a space between the checkmark and the Label text)''
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Direct call and return of iol_flag, using same arguments used in draw();
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool editable()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Always returns true;
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void set(const void* flag);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Set the '''_flag''' to the boolean pointed by '''flag''' attribute.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void *data();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Returns address of '''_flag'''
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool checked()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Return true if '''_flag''' is not zero.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void checked(bool val);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Sets '''_flag''' to 1 if val is true, or zero if val is false.
===Class Definition===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWValEdit: public FWLineEdit{
void (*_help)(MessageStatus, FWDialog&amp;amp;); bool (*_validate)(const char*, FWDialog&amp;amp;);
public:
FWValEdit(char* Str, int Row, int Col, int Width,
int Maxdatalen, int* Insertmode,
bool (*Validate)(const char* , FWDialog&amp;amp;) = NO_VALDFUNC, void (*Help)(MessageStatus, FWDialog&amp;amp;) = NO_HELPFUNC,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
FWValEdit(int Row, int Col, int Width,
int Maxdatalen, int* Insertmode,
bool (*Validate)(const char* , FWDialog&amp;amp;) = NO_VALDFUNC, void (*Help)(MessageStatus, FWDialog&amp;amp;) = NO_HELPFUNC,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
int edit();
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Attributes===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;"> void (*_help)(MessageStatus, FWDialog&amp;amp;); bool (*_validate)(const char*, FWDialog&amp;amp;);&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Pointers to keep the address of possible help and validation function.&amp;lt;<br /&amp;gt;>
''Note that if these two are NULL, then ValEdit works exactly like LineEdit''
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWValEdit(char* Str, int Row, int Col, int Width,
int Maxdatalen, int* Insertmode,
bool (*Validate)(const char* , FWDialog&amp;amp;) = NO_VALDFUNC, void (*Help)(MessageStatus, FWDialog&amp;amp;) = NO_HELPFUNC,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
FWValEdit(int Row, int Col, int Width,
int Maxdatalen, int* Insertmode,
bool (*Validate)(const char* , FWDialog&amp;amp;) = NO_VALDFUNC, void (*Help)(MessageStatus, FWDialog&amp;amp;) = NO_HELPFUNC,
bool Bordered = false,
const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>They Pass the arguments to corresponding parents constructor.&amp;lt;<br /&amp;gt;>
Then they Set '''_validate''' and '''_help''' attributes to their corresponding values in argument list.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>If the container() is NULL then this function works exactly like LineEdit::edit().&amp;lt;<br /&amp;gt;>
If the container() is not NULL:
#If _help function exist it calls the function passing MessageStatus::SetMessage and container()'s reference as arguments.
#It will return the terminating key
''Navigation keys are Up key, Down key, Tab key or Enter key.''&amp;lt;<br /&amp;gt;>
''MessageStatus is enumerated in confw.h'''
at any time by calling the data() method the array of strings is converted back to a newline separated and null terminated array of characters (Converted back to text) and returned.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
class FWText:public FWField{
AnArrayOfStrings _lines; // see below
};
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
===Attributes===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
AnArrayOfStrings _lines;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Could be one the following:
*A two dimensional array of characters: char _lines[max_number_of_lines][max_number_of_characters_in_line+1];&amp;lt;<br /&amp;gt;>
*: In this case you text size is limited to the max_number_of_lines and can not grow more than that.
*A dynamic array of strings: [[Dynamic Array Of Strings - OOP344 | StrArr]] _lines;&amp;lt;<br /&amp;gt;>*: This case ([[Dynamic Array Of Strings - OOP344 | StrArr]]) is designed to simulate a two dimensional array of characters (or an array of strings) and has no limit in the number of lines and expands automatically if needed. You can use the code for ([[Dynamic Array Of Strings - OOP344 | StrArr]]) at your own risk to implement FWText, or you can design your own logic.&amp;lt;<br /&amp;gt;>
*A Doubly Linked List (Queue) of strings [[Queue of Strings - OOP344 | StrQue]]
*: [[Queue of Strings - OOP344 | StrQue]] is a Queue of null terminated characters arrays (strings) and like StrArr has no limit in the number of lines and expands automatically if needed. Like StrArr, you can use the code for [[Queue of Strings - OOP344 | StrQue]] at your own risk to implement FWText, or you can design your own logic.&amp;lt;<br /&amp;gt;>If you found any bugs or problems with [[Queue of Strings - OOP344 | StrQue]] or [[Dynamic Array Of Strings - OOP344 | StrArr]], do not modify it yourself but instead, please blog about it and send an email to [[mailto:fardad.soleimanloo@senecac.on.ca?subject=OOP344-StrQue me]] and I will take care of updating it.&amp;lt;<br /&amp;gt;>
You can also find the code for [[Queue of Strings - OOP344 | StrQue]] and it's tester program in class notes repo: (svn://zenit.senecac.on.ca/oop344/trunk/C/13-Nov12).
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool _readOnly;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Keeps the status of the text being read only, or editable. (note that when read only, you can still scroll the text to left and right or up and down, but you can't modify the text).&amp;lt;<br /&amp;gt;>
This flag is passed to iol_edit for the same reason.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _curpos;
int _fieldlen;
int* _insertmode;
int _offset;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Variables to be used with iol_edit to edit the lines of text.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _lcurpos;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Line Cursor Position; this variable keeps track of which line of text the cursor is on. _lcurpos is zero, if the cursor is on the fist line appearing in the Border.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int _loffset;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Offset Of the First Line; this variable keeps track of which line is the first appearing in the border. _loffset is zero, if the first string (line) of the string array is appearing on the fist line of the Border.&amp;lt;<br /&amp;gt;&amp;lt;><br /&amp;gt;>
'''_lcurpos''' and '''_loffset''' have the same responsibility as _curpos, and _offset, but only for lines of the text. So as the left and right scrolling is done by manipulating _offset and _curpos, up and down scrolling of lines in the text are done by manipulating '''_loffset''' and '''_lcurpose'''
===Methods===
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWText(int Row, int Col, int Width, int Height, bool Readonly,
int* Insertmode, const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Sets all the attributes to their proper/corresponding values&amp;lt;<br /&amp;gt;>
:''Note that FWText is always bordered''
If dynamic array of strings is used, initial text is allocated and set to an empty text.&amp;lt;<br /&amp;gt;>&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
FWText(const char* Str, int Row, int Col, int Width, int Height, bool Readonly,
int* Insertmode, const char* Border=FW_BORDER_CHARS);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Works exactly like the previous constructor, but also it will call the '''set''' method of FWText to split the incoming text ('''Str''') at newline characters into an array of strings.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void draw(int Refresh = FW_NO_REFRESH)const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
#Calls its parents draw, to draw the border.
#Using iol_display, it prints lines of text from index _loffset, up to height()-2 times.
#:Note that each line is printed from _offset character using absRow() and absCol(), up o width()-2 characters
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void set(const void *Str);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Converts the newline delimited array of characters (the text) into an array of strings.&amp;lt;<br /&amp;gt;>Set starts with the first string in the array of strings and copies the characters of the array to the current string until it reaches a newline character. &amp;lt;<br /&amp;gt;>
Then it will null terminate the current string and go to the next string in the array of strings and repeats the same over and over until it reaches the end of the text.
:''Note that if '''FW_MAX_LINE_CHARS''' is reached before getting to the newline character, the current string is null terminated and copying continues into the next one''.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
void *data();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Converts the array of strings, back to a single string of text and returns it.&amp;lt;<br /&amp;gt;>'''data()''' first calculates the size of the whole text including the newline characters at the end of each line. Then it will allocated enough memory to hold it all.&amp;lt;<br /&amp;gt; > Finally, it will concatenate all the strings back into the allocated memory adding a newline character to the end of each of them and returns it.&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
int edit();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>Draws the text area and then starts the editing from the first line.&amp;lt;<br /&amp;gt;>The whole text should scroll to left, right, up or down instead, if the cursor tries to pass the edges of the text area.&amp;lt;<br /&amp;gt;>When Enter key is hit, if in insertmode, a new line is inserted after the current line and any text after the cursor in the line should be moved into it.&amp;lt;<br /&amp;gt;>When Backspace key is hit at the beginning of the line, the content of the current line should be moved to the previous line, the and current line should be deleted. The cursor in this case should stand in front of the copied data. &amp;lt;<br /&amp;gt;>
:''Note that this will not happen if the sum of the length of the current and previous lines are more than FW_MAX_LINE_CHARS''
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool editable()const;
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
Always return true.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
bool readOnly()const;
void readOnly(bool val);
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
These two methods Get and Set the _readOnly attribute.
&amp;lt;<big&amp;gt;&amp;lt;><syntaxhighlight lang=&amp;quot;"cpp&amp;quot;&amp;gt;">
~FWText();
&amp;lt;</syntaxhighlight&amp;gt;&amp;lt;></big&amp;gt;>
It deallocates the allocated memory. (If any memory allocation is used).
*Here is a sample of a make file on Linux, you can also find this '''makefile''' at svn://zenit.senecac.on.ca/oop344/trunk/C/Prj/makefile
&amp;lt;<big&amp;gt;&amp;lt;><pre&amp;gt;>
prj: iol.o fwborder.o fwfield.o fwlabel.o fwlineedit.o fwbutton.o fwcheck.o fwveditline.o fwdialog.o fwtext.o strarr.o testmains.o
c++ iol.o fwborder.o fwfield.o fwlabel.o fwlineedit.o fwbutton.o fwcheck.o fwveditline.o fwdialog.o fwtext.o strarr.o testmains.o \
c++ -c testmains.cpp
&amp;lt;</pre&amp;gt;&amp;lt;></big&amp;gt;>
==Testing==
3
edits

Navigation menu