Difference between revisions of "OOP344 Assignment Two"

From CDOT Wiki
Jump to: navigation, search
(Fardad adds io_textedit)
m (Undo revision 69911 by MCanaday49 (Talk) - SPAM)
 
(151 intermediate revisions by 23 users not shown)
Line 1: Line 1:
 
[[OOP344]] - [[OOP344 Student List]] - [[OOP344 Teams]] - [[OOP344 Assignment One]] - [[OOP344 Assignment Two]] - [[OOP344 IRC Schedules 20093 |OOP344 IRC Schedules]]<br />
 
[[OOP344]] - [[OOP344 Student List]] - [[OOP344 Teams]] - [[OOP344 Assignment One]] - [[OOP344 Assignment Two]] - [[OOP344 IRC Schedules 20093 |OOP344 IRC Schedules]]<br />
 +
- [[OOP344 Student Resources]]<br />
 
Under construction...
 
Under construction...
  
 +
=Due Dates=
  
==File Names==
+
*Saturday, November 28th:  Version 0.1 (Initial working version)
  
Save your work in separate files for each class. Name the files to the same name as the classes. Each class should have a header file and a code file.  
+
*Tuesday, December 8th:  Version 1.0 (Working version)
  
For example for the class IOField, create iofield.h and iofield.cpp. The header file should hold the class declaration and any other possible declaration related to the class. the "cpp" file should hold the definition (implementation) of the class and its methods and possible functions.
+
*Tuesday, December 8th to Thursday, December 17th: Final debugging and IRC meetings
 +
 
 +
=File Names=
 +
 
 +
Save your work in separate files for each class, and name the files to the same name as the classes; each class should have a header file and a code file.
 +
 
 +
For example for the class [[#IO_Field | IO_Field]], create ''IO_Field.h'' and ''IO_Field.cpp''. The header file should hold the class declaration, and any other possible declaration related to the class. The "cpp" file should hold the definition (implementation) of the class, and its methods and possible functions.
  
 
Create a Make file to build your project with respect to dependencies of classes.
 
Create a Make file to build your project with respect to dependencies of classes.
==SVN Quick Notes==
 
  
# Checkout the code $svn co svn://zenit.senecac.on.ca/ops344_093aXX/trunk/PRJ --username yourUserName
+
=SVN Quick Notes=
 +
 
 +
# Checkout the code $svn co svn://zenit.senecac.on.ca/ops344_093a'''XX'''/trunk/PRJ --username yourUserName   <sup>Remember, '''XX''' is your SVN number after your section ('a' etc.)</sup>
 
# Add selected ciol.h ciol.cpp and if present the class files (all compiled)  $svn add filename
 
# Add selected ciol.h ciol.cpp and if present the class files (all compiled)  $svn add filename
 
# Commit the new files $svn commit
 
# Commit the new files $svn commit
Line 18: Line 27:
 
# development starts.
 
# development starts.
  
==How to reuse your C code in C++ programs==
+
=How to reuse your C code in C++ programs=
 
Include your already existing C code into your C++ code as follows:
 
Include your already existing C code into your C++ code as follows:
  
Line 27: Line 36:
 
This tells to C++ compiler, the included header file contains C functions and should be complied and called as such. Remember, you do not need and should not rename your ciol.c to ciol.cpp, since the compiler is already aware of the C functions in ciol.c.
 
This tells to C++ compiler, the included header file contains C functions and should be complied and called as such. Remember, you do not need and should not rename your ciol.c to ciol.cpp, since the compiler is already aware of the C functions in ciol.c.
  
==Team Project Wiki Pages==
+
=Team Project Wiki Pages=
  
 
Add a link to your Team project Wiki pages here:
 
Add a link to your Team project Wiki pages here:
Line 41: Line 50:
 
[[OOP344_Team_++ | Team ++ website]]
 
[[OOP344_Team_++ | Team ++ website]]
  
[[ OOP344 Group3 | Team BINGO]]
+
[[ OOP344 BINGO | Team BINGO]]
  
 
[[ OOP344_Temporary | Team Temporary Name ]]
 
[[ OOP344_Temporary | Team Temporary Name ]]
Line 49: Line 58:
 
[[OOP344_Group_2 | Best Team Ever :) ]]
 
[[OOP344_Group_2 | Best Team Ever :) ]]
  
[[ ASOS Brigade | ASOS_Brigade]]
+
[[ OOP344_ASOS | ASOS_Brigade]]
 +
 
 +
[[ OOP344_Hasselhoff | Team Hasselhoff ]]
 +
 
 +
=General Definition Header file=
 +
create a file called: '''io_def.h'''. This file will contain any necessary definitions or inclusions for the project.
  
==General Definition Header file==
+
for now add the following define statements in '''io_def.h'''
create a file called: '''io_def.h'''. This file will contain any nessecary definitions or inclusions for the project. ultimately, users (future programmers) will only include this header file to be able to use the IO Classes.
 
for now add the following define statements in io_def.h
 
  
 
<big><pre>
 
<big><pre>
#define IO_NO_ACTION (0x1)
+
 
#define IO_CLEAR (0x2)
+
#ifndef _CRT_SECURE_NO_DEPRECATE
#define IO_SHOW_ALL (0x4)
+
#define _CRT_SECURE_NO_DEPRECATE
#define IO_SHOW_ERROR (0x8)
+
#endif
#define IO_SHOW_HELP (0x16)
+
#ifndef _CRT_SECURE_NO_WARNINGS
 +
#define _CRT_SECURE_NO_WARNINGS
 +
#endif
 +
#define IO_NO_ACTION (0x1u)
 +
#define IO_CLEAR (0x2u)
 +
#define IO_SHOW_ALL (0x4u)
 +
#define IO_SHOW_ERROR (0x8u)
 +
#define IO_SHOW_HELP (0x10u)
 +
 
 +
// frame chars
 
#define _FRAME_CHARS "|+-+|+-+"
 
#define _FRAME_CHARS "|+-+|+-+"
 +
#define _FRAME_UNDERLINE "      - "
 +
#define _FRAME_UNDEROVER "  -  - "
 +
#define _FRAME_LISTS "|/-\\|/-\\"
 +
#define _FRAME_MENUS "|+-+|+-+"
 +
 +
#define _CHECKLIST_CHARS "[X]"
 +
#define _RADIOLIST_CHARS "(o)"
 +
#define _MENU_CHARS "[]"
 +
#define _IO_TEXT_ALLOCATION_LINE_SIZE 1024
 +
 +
 +
#ifdef NO_FUNC
 +
# undef NO_FUNC
 +
#endif
 +
#define NO_FUNC ((void(*)(MessageStatus, IO_Form&))(0))
 +
 +
#ifdef NO_VFUNC
 +
# undef NO_VFUNC
 +
#endif
 +
#define NO_VFUNC ((bool(*)(const char*, IO_Form&))(0))
 +
 +
enum MessageStatus{ClearMessage,SetMessage};
 +
enum CheckListMode{CheckBox, Radio};
 +
enum MenuDir{Vertical, Horizontal};
 +
 +
#endif
 
</pre></big>
 
</pre></big>
  
==Mandatory Classes==
+
=Mandatory Classes=
 
As the first part of your project this semester, you are to create few classes to encapsulate [[OOP344 Assignment One|Console Input Output Library]]
 
As the first part of your project this semester, you are to create few classes to encapsulate [[OOP344 Assignment One|Console Input Output Library]]
  
<hr width="50%" />
+
==IO_Field==
 
 
<hr width="50%" />
 
 
 
<hr width="50%" />
 
===IO_Field===
 
  
 
'''IO_Field''' is the base class for all different types of Fields on a Form.
 
'''IO_Field''' is the base class for all different types of Fields on a Form.
 
<big><pre>
 
<big><pre>
class IO_Form; // forward declaration
+
class IO_Form;
 
class IO_Field{
 
class IO_Field{
 +
private:
 +
  int _row;
 +
  int _col;
 
protected:
 
protected:
 
   void* _data;
 
   void* _data;
   int _row;
+
  IO_Form* _owner;
   int _col;
+
   int getOwnerTop(void)const;
 +
   int getOwnerLeft(void)const;
 +
  void displayOwner(void)const;
 
public:
 
public:
   IO_Field(int row, int col);
+
   IO_Field(int row, int col, void* data = (void*)0);
   void* Data();
+
   virtual void* data(void);
   virtual void Display() = 0;
+
   virtual void display(void)const = 0;
   virtual int Edit(IO_Form* Owner=NULL)= 0;
+
   virtual int edit(void)= 0;
   virtual bool Editable() = 0;
+
   virtual bool editable(void)const = 0;
   virtual void Set(const void *) = 0;
+
   virtual void set(const void *) = 0;
   virtual ~IO_Field();
+
  virtual void set(IO_Form* owner);
 +
  int getRow(void)const;
 +
  int getCol(void)const;
 +
   virtual ~IO_Field(void);
 
};
 
};
 +
 +
</pre></big>
 +
===Constructor===
 +
 +
<big><pre>
 +
IO_Field(int row, int col, void* data = (void*)0);
 +
</pre></big>
 +
This constructor sets the corresponding attributes to the values of incoming arguments.
 +
 +
===Protected Methods===
 +
====getOwnerTop and left (optional)====
 +
<big><pre>
 +
  int getOwnerTop()const;
 +
  int getOwnerLeft()const;
 +
</pre></big>
 +
These two methods return the top and left, coordinates of the frame of the form in which the field exists.They simply return zero, if there is no owner. This can help the display methods of a field to place the field at the correct, relative position according to the form they are displayed in. 
 +
====displayOwner() (optional)====
 +
<big><pre>
 +
  void displayOwner()const;
 +
</pre></big>
 +
This method displays the owner of a field, if it exists. This can help a Field to hide itself, by displaying the owner, without displaying itself.
 +
===Public Methods===
 +
====data()====
 +
<big><pre>
 +
virtual void* data();
 
</pre></big>
 
</pre></big>
 +
Returns the value of the data attribute.
  
'''IO_Field(int row, int col);'''
+
====set(IO_Form*)====
  
This constructor set the corresponding attributes to the values of incoming arguments and sets the data attribute to NULL.
+
<big><pre>
 +
virtual void set(IO_Form* owner);
 +
</pre></big>
 +
Sets the '''_owner''' attribute to incoming argument.
  
 +
====getRow()====
  
'''void* Data();'''
+
<big><pre>
 +
int getRow(void)const;
 +
</pre></big>
 +
*if '''_owner''' is NULL, it returns the '''_row''' attribute
 +
*if '''_owner''' is not NULL it returns the sum of '''_row''' and '''_owner->getTop();''' (see IO_Frame for getTop())
  
Returns the value of the data attribute.
+
====getCol()====
  
'''virtual ~IOField();'''
+
<big><pre>
 +
int getCol(void)const;
 +
</pre></big>
 +
*if '''_owner''' is NULL, it returns the '''_col''' attribute
 +
*if '''_owner''' is not NULL it returns the sum of '''_col''' and '''_owner->getLeft();''' (see IO_Frame for getLeft())
  
 +
===Destructor===
 +
'''<big><pre>
 +
virtual ~IOField();
 +
</pre></big>'''
 
An empty destructor (the body of the method is blank)
 
An empty destructor (the body of the method is blank)
  
'''virtual void Display() = 0;'''<br />
+
===Pure Virtual Methods===
'''virtual int Edit(IO_Form* Owner=NULL)= 0;'''<br />
+
<big><pre>
'''virtual bool Editable() = 0;'''<br />
+
virtual void display() = 0;
'''virtual void Set(const void *) = 0;'''<br />
+
virtual int edit()= 0;
 
+
virtual bool editable() = 0;
 +
virtual void set(const void *) = 0;
 +
</pre></big>
  
 
These are pure virtual methods enforcing the creation of the identical methods in the derived classes. This make the IO_Field class an abstract class.
 
These are pure virtual methods enforcing the creation of the identical methods in the derived classes. This make the IO_Field class an abstract class.
Note: The purpose of passing a IO_Form pointer to the Edit method, is to make the future Edit methods capable of sending a message (errors and help messages)to the Screen they are being Edited on.
+
Note: The purpose of passing an IO_Form pointer to the Edit method, is to make the future Edit methods capable of sending a message (errors and help messages)to the Screen they are being Edited on.
<hr width="50%" />
 
<hr width="50%" />
 
 
 
<hr width="50%" />
 
  
===IO_Frame===
+
==IO_Frame==
  
'''IO_Frame''' class, encapsulates a frame. It Draws a frame at left top corner of '''col''' and '''row''' with specified '''width''' and '''height'''.
+
'''IO_Frame''' class, encapsulates a frame. It Draws a frame at left top corner of '''left''' and '''top''' with specified '''width''' and '''height'''.
  
 
A Frame can be instantiated as follows:
 
A Frame can be instantiated as follows:
 
<big><pre>
 
<big><pre>
IO_Frame(int row, int col, int width, int height, const char* frameChars = (const char*)0);
+
IO_Frame(int top, int left, int width, int height, const char* frameChars = (const char*)0);
 
</pre></big>
 
</pre></big>
  
Line 152: Line 242:
 
</pre></big>
 
</pre></big>
  
If however, the '''frameChars''' argument is missing (it is NULL) then a defaut, defined value in "io_def.h"; '''_FRAME_CHARS''' should be used.
+
If however, the '''frameChars''' argument is missing (it is NULL) then a default, defined value in "io_def.h"; '''_FRAME_CHARS''' should be used.
 +
 
 +
===Public Methods===
 +
 
 +
====display()====
 +
<big><pre>
 +
void display(int topOffset=0, int leftOffset=0)const;
 +
</pre></big>
 +
'''display()''', starts from top + topOffset and left + leftOffset and draws the frame to the width and height received from the constructor.
 +
 
 +
====getLeft()====
 +
 
 +
<big><pre>
 +
int getLeft();
 +
</pre></big>
 +
 
 +
returns the '''_left''' attribute;
 +
 
 +
====getTop()====
  
<hr width="50%" />
 
====Public Method====
 
 
<big><pre>
 
<big><pre>
void Display(void);
+
int getTop();
 
</pre></big>
 
</pre></big>
'''Display()''', displays the frame with the specified coordinates and size in its constructor
 
  
<hr width="50%" />
+
returns the '''_top''' attribute;
====Destructor====
+
 
 +
====void set()====
 +
<big><pre>
 +
void set(int top, int left);
 +
</pre></big>
  
IO_Frame has a virtual destructor. This destructor does nothing.
+
sets the '''_top and _left''' attributes to corresponding arguments.
<hr width="50%" />
 
  
<hr width="50%" />
+
===Destructor===
  
<hr width="50%" />
+
IO_Frame has a virtual destructor. This destructor does nothing.
  
===IO_Form===
+
==IO_Form==
  
'''IO_Frame''' is inherited into a container class called '''IO_Form'''. '''IO_Form''' organizes the '''IO_Field''' classes and give the user a panel to use them sequentially.
+
'''[[#IO_Frame | IO_Frame]]''' is inherited into a container class called '''IO_Form'''. '''IO_Form''' organizes the '''[[#IO_Field | IO_Field]]''' classes and give the user a panel to use them sequentially.
  
'''IO_Form''' should be able to hold unlimited number of '''IO_Fields'''. (Use either a dynamic array, or linked list structure of '''IO_Fields''' to implement this)
+
'''IO_Form''' should be able to hold unlimited number of '''[[#IO_Field | IO_Fields]]'''. (Use either a dynamic array, or linked list structure of '''[[#IO_Field | IO_Fields]]''' to implement this)
 
<hr width="50%" />
 
<hr width="50%" />
====Constructor====
+
===Constructor===
  
 
'''IO_Form''' is constructed as follows:  
 
'''IO_Form''' is constructed as follows:  
Line 189: Line 297:
 
<hr width="50%" />
 
<hr width="50%" />
  
====Destructor====
+
===Destructor===
  
 
<big><pre>
 
<big><pre>
Line 199: Line 307:
 
<hr width="50%" />
 
<hr width="50%" />
  
====Privete Methods====
+
===Private Methods===
  
=====Adding a Field to the Form=====
+
====Adding a Field to the Form====
 
the '''IO_Form''' must be able to add several IO_Field classes to itself, one at a time and then provide the user, the means of editing them in order they were added.  
 
the '''IO_Form''' must be able to add several IO_Field classes to itself, one at a time and then provide the user, the means of editing them in order they were added.  
  
Line 207: Line 315:
 
int add(IO_Field* f, bool dynamic, bool submitter);
 
int add(IO_Field* f, bool dynamic, bool submitter);
 
</pre></big>
 
</pre></big>
'''IO_Form''' uses this private '''add''' method to provide means of adding fields through several public add methods. this method adds an IO_Field to the end of the IO_Fields in the IO_Form;
+
'''IO_Form''' uses this private '''add''' method to provide means of adding fields through several public add methods. this method adds an '''[[#IO_Field | IO_Field]]''' to the end of the '''[[#IO_Field | IO_Fields]]''' in the IO_Form;
 +
 
 +
*'''f'''        : Is the address of the '''[[#IO_Field | IO_Field]]''' begin added to the '''IO_Form'''
 +
*'''dynamic'''  : If set to true, it sets this '''[[#IO_Field | IO_Field]]''' to be deallocated by '''IO_Form''''s destructor at the end;
 +
*'''submitter''': If set to true, it tags this '''[[#IO_Field | IO_Field]]''' to terminate the '''IO_Form''''s edit() if ENTER_KEY is hit. see the edit() method for more info.
  
*'''f''': is the address of the IO_Field begin added to the IO_Form
+
'''add()''' also calls '''set(IO_Form* owner)''' of '''[[#IO_Field | IO_Field]]''' and passes its pointer ''(this)'' to it. By doing this, each '''[[#IO_Field | IO_Field]]''' will know who is its owner.
*'''dynamic''': if set to true, it sets this IO_Field to be deallocated by IO_Form's destructor at the end;
+
'''add()''' returns the number of fields currently in IO_FORM.
*'''submitter''': if set to true, it tags this IO_Field to terminate the IO_Form's edit() if ENTER_KEY is hit. see the edit() method for more info.
 
 
<hr width="50%" />
 
<hr width="50%" />
====Public Methods====
+
 
=====Add methods=====
+
===Public Methods===
 +
====Add methods====
 
<big><pre>
 
<big><pre>
 
int add(IO_Field* f, bool submitter  = false);
 
int add(IO_Field* f, bool submitter  = false);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a dynamic IO_field.
+
Uses the private add() method to add a dynamic '''[[#IO_Field | IO_Field]]'''.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
 
int add(IO_Field& f, bool submitter = false);
 
int add(IO_Field& f, bool submitter = false);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a non-dynamaic IO_field.
+
Uses the private add() method to add a non-dynamic '''[[#IO_Field | IO_Field]]'''.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
 
int addHelp(IO_Label* L);
 
int addHelp(IO_Label* L);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a dynamaic IO_field and also saves its address for the general help message label of the Form.
+
Uses the private add() method to add a dynamic '''[[#IO_Field | IO_Field]]''' and also saves its address for the general help message label of the Form.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
 
int addHelp(IO_Label& L);
 
int addHelp(IO_Label& L);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a non-dynamaic IO_field and also saves its address for the general help message label of the Form.
+
Uses the private add() method to add a non-dynamic '''[[#IO_Field | IO_Field]]''' and also saves its address for the general help message label of the Form.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
 
int addError(IO_Label* L);
 
int addError(IO_Label* L);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a dynamaic IO_field and also saves its address for the general error message label of the Form.
+
Uses the private add() method to add a dynamic '''[[#IO_Field | IO_Field]]''' and also saves its address for the general error message label of the Form.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
 
int addError(IO_Label& L);
 
int addError(IO_Label& L);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a dynamaic IO_field and also saves its address for the general error message label of the Form.
+
Uses the private add() method to add a non-dynamic '''[[#IO_Field | IO_Field]]''' and also saves its address for the general error message label of the Form.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
IO_Form &operator<<(IO_Field* f);
+
IO_Form& operator<<(IO_Field* f);
 
</pre></big>
 
</pre></big>
  
Uses the private add() method to add a non-submitter, dynamic IO_field.
+
Uses the private add() method to add a non-submitter, dynamic '''[[#IO_Field | IO_Field]]'''.
 
<hr width="50%" />
 
<hr width="50%" />
 
<big><pre>
 
<big><pre>
IO_Form &operator<<(IO_Field& f);
+
IO_Form& operator<<(IO_Field& f);
 
</pre></big>
 
</pre></big>
Uses the private add() method to add a non-submitter, non-dynamic IO_field.
+
Uses the private add() method to add a non-submitter, non-dynamic '''[[#IO_Field | IO_Field]]'''.
 
<hr width="50%" />
 
<hr width="50%" />
  
=====Setting General Error and Help masseges=====
+
====Setting General Error and Help messages ====
 
<big><pre>
 
<big><pre>
 
void setError(const char* mes);
 
void setError(const char* mes);
Line 264: Line 376:
 
Set the text of the general Error message and the general Help message of the Form.
 
Set the text of the general Error message and the general Help message of the Form.
 
<hr width="50%" />
 
<hr width="50%" />
=====Number of fields in Form=====
+
====Number of fields in Form====
  
 
<big><pre>
 
<big><pre>
int lenght();
+
int length();
 
</pre></big>
 
</pre></big>
 
Returns number of fields currently in IO_Form.
 
Returns number of fields currently in IO_Form.
 
<hr width="50%" />
 
<hr width="50%" />
  
=====Acessing Field Data=====
+
====Accessing Field Data====
 
<big><pre>
 
<big><pre>
 
void* data(unsigned int fieldnumber=0);
 
void* data(unsigned int fieldnumber=0);
 
</pre></big>
 
</pre></big>
Returns address of the data of "fieldnumber"th,  IO_Field in the IO_Form. If "fieldnumber" is zero, then it returns the data of the current IO_Field.
+
Returns address of the data of "fieldnumber"th,  '''[[#IO_Field | IO_Field]]''' in the IO_Form. If "fieldnumber" is zero, then it returns the data of the current '''[[#IO_Field | IO_Field]]'''.
<hr width="50%" />
 
 
 
  
=====The index operator=====
+
====The index operator====
 
<big><pre>
 
<big><pre>
 
IO_Field& operator[](unsigned int index);
 
IO_Field& operator[](unsigned int index);
 
</pre></big>
 
</pre></big>
Returns the reference of the IO_Field, number "fieldnumber-1". First Field has the index 0;
+
Returns the reference of the '''[[#IO_Field | IO_Field]]''', number "fieldnumber-1". First Field has the index 0;
 
<hr width="50%" />
 
<hr width="50%" />
  
=====Displaying the Form=====
+
====Displaying the Form====
 
<big><pre>
 
<big><pre>
 
void display(unsigned int how = IO_CLEAR | IO_SHOW_ALL ,unsigned int fieldnumber = 0 );   
 
void display(unsigned int how = IO_CLEAR | IO_SHOW_ALL ,unsigned int fieldnumber = 0 );   
 +
</pre></big>
  
</pre></big>
+
Displays the Form and all the Fields on it.
  
--- incomplete ---
+
'''fieldnumber''' is the number of the field that was returned by any of the '''add()''' functions.
  
 +
'''how:''' is a binary mask, and following bits can be set in it:
 +
<blockquote>
 +
IO_CLEAR (0x2u)<br />
 +
IO_SHOW_ALL (0x4u)<br />
 +
IO_SHOW_ERROR (0x8u)<br />
 +
IO_SHOW_HELP (0x10u)<br />
 +
</blockquote>
 +
The display function work in the following order:
 +
# If IO_CLEAR bit is set in '''how''', then before anything the screen should be cleared.
 +
# If the field number is 0 (zero) then
 +
## if IO_SHOW_ALL is set in '''how''', then all the fields are displayed in the order they were added
 +
## otherwise either of IO_SHOW_ERROR or IO_SHOW_HELP is set, only their corresponding designated IO_Label will be displayed.
 +
# if the field number is not zero, then the IO_Field number "fieldnumber" will be displayed. If the number is larger than the number of fields in the IO_Form then it will be rotated back from the beginning. (i.e. if there are 4 fields in the form and fieldnumber is 5, then filed number 1 will be displayed)
 
<hr width="50%" />
 
<hr width="50%" />
  
=====Editing(running) the Form=====
+
====Editing(running) the Form====
 
<big><pre>
 
<big><pre>
int edit(unsigned int fieldnumber = 0);
+
int edit(unsigned int* fieldnumber = (unsigned int*)0, bool Clear = true);
 
</pre></big>
 
</pre></big>
  
--- incomplete ---
+
If neither of the '''[[#IO_Field | IO_Fields]]''' is editable, it displays all the '''[[#IO_Field | IO_Fields]]''', then waits for a key entry and then ends the function by returning the key entered.
<hr width="50%" />
+
 
<hr width="50%" />
+
If the fieldnumber pointer is NULL, it should use a local variable’s address with the value of “0” zero instead.
<hr width="50%" />
+
 
 +
If *fieldnumber is (0) zero, then display all the fields before editing the fields and then set *fieldnumber to (1) one.
 +
 
 +
Start editing from field number *fieldnumber.
 +
 
 +
Call the edit of each field and depending on the value returned, do the following:
 +
 
 +
* For '''TAB_KEY''' and '''DOWN_KEY''', go to next editable  '''[[#IO_Field | IO_Field]]''', if this is the last editable  '''[[#IO_Field | IO_Field]]''' then restart from  '''[[#IO_Field | IO_Field]]''' number one.
 +
 
 +
* For '''UP_KEY''' go to the previous editable '''[[#IO_Field | IO_Field]]''', if there is no previous editable '''[[#IO_Field | IO_Field]]''', go to the last editable '''[[#IO_Field | IO_Field]]''' of the ''IO_Form'' and continue the search for an editable '''[[#IO_Field | IO_Field]]'''.
 +
 
 +
* For '''ENTER_KEY''' do exactly as '''TAB_KEY''', except that if the current '''[[#IO_Field | IO_Field]]''' is a submitter (is tagged to be a submitter when added), in which case terminate the edit function returning the '''ENTER_KEY'''.
  
 +
* For any other key, terminate the edit function returning the character which caused the termination.
  
 +
<hr width="50%" />
  
===IO_Label===
+
==IO_Label==
 
'''IO_Label''' class mostly, encapsulates the '''[[OOP344_Assignment_One#void_io_display.28const_char_.2Astr.2C_int_row.2C_int_col.2C_int_len.29|io_display()]]''' function.
 
'''IO_Label''' class mostly, encapsulates the '''[[OOP344_Assignment_One#void_io_display.28const_char_.2Astr.2C_int_row.2C_int_col.2C_int_len.29|io_display()]]''' function.
 
Inherit a new class called IO_Label from IO_Field to Display a text message on IO_Form. In addition to the attributes of its parent IO_Field, IO_Label has a private integer attribute called _len. _len is used to hold the length of Field in which the text is to be displayed.
 
Inherit a new class called IO_Label from IO_Field to Display a text message on IO_Form. In addition to the attributes of its parent IO_Field, IO_Label has a private integer attribute called _len. _len is used to hold the length of Field in which the text is to be displayed.
Line 318: Line 455:
 
</pre></big>
 
</pre></big>
 
This constructor will create an empty (blank) IO_Label with capacity of len characters.
 
This constructor will create an empty (blank) IO_Label with capacity of len characters.
In this case '''row''' and '''col''' are passed to the parent for initialisation and '''_len''' (the attribute) is set to the incoming argument '''len'''.
+
In this case '''row''' and '''col''' are passed to the parent for initialization and '''_len''' (the attribute) is set to the incoming argument '''len'''.
 
Then IO_Field::_data will be set to the address of a newly allocated memory to the size of '''_len + 1 ''' bytes which also will be set to an empty string.
 
Then IO_Field::_data will be set to the address of a newly allocated memory to the size of '''_len + 1 ''' bytes which also will be set to an empty string.
 
''Note that '''data''' is a void pointer; to use it here, you must cast it to a character pointer!''<br />
 
''Note that '''data''' is a void pointer; to use it here, you must cast it to a character pointer!''<br />
 
<big><pre>
 
<big><pre>
   IO_Label(char* str, int row, int col, int len = -1);
+
   IO_Label(const char* str, int row, int col, int len = -1);
 
</pre></big>
 
</pre></big>
If '''len''' is greater than zero, This constructor will create an IO_Label by allocating len + 1 characters pointed by IO_Field::_data, and then the contents of '''str''' is copied into IO_Fiedl::_data up to '''len''' characters. '''_len''' attribute is set to '''len''';
+
If '''len''' is greater than zero, This constructor will create an IO_Label by allocating len + 1 characters pointed by IO_Field::_data, and then the contents of '''str''' is copied into IO_Field::_data up to '''len''' characters. '''_len''' attribute is set to '''len''';
 
If '''len''' is less than or equal to zero, then '''len''' will be set to the length of '''str''' and then constructor will work as previous case.
 
If '''len''' is less than or equal to zero, then '''len''' will be set to the length of '''str''' and then constructor will work as previous case.
 
Like the previous constructor it will pass '''row''' and '''col''' to its parent.
 
Like the previous constructor it will pass '''row''' and '''col''' to its parent.
====Public Methods====
+
===Public Methods===
 
<big><pre>
 
<big><pre>
void Display(void);
+
void display(void);
 
</pre></big>
 
</pre></big>
'''Display()''' is a direct call to '''io_display()''' function printing '''_data''', at '''_row''' and '''_col''' up to '''_len''' characters. If '''_len''' is less than zero, then '''_data''' will be printed to the end.
+
'''Display()''' is a direct call to '''io_display()''' function printing '''_data''', at '''getRow()''' and '''getCol()''' up to '''_len''' characters. If '''_len''' is less than zero, then '''_data''' will be printed to the end.
 
<big><pre>
 
<big><pre>
   void Set(const void* str);
+
   void set(const void* str);
 
</pre></big>
 
</pre></big>
 
'''Set()''' will copy the content of '''str''' into '''IO_Field::_data''' up to '''_len''' characters, if '''_len''' is not negative.
 
'''Set()''' will copy the content of '''str''' into '''IO_Field::_data''' up to '''_len''' characters, if '''_len''' is not negative.
 
<big><pre>
 
<big><pre>
bool IO_Label::Editable(void)const;
+
bool editable(void)const;
 
</pre></big>
 
</pre></big>
 
'''Editable()''' returns false!.
 
'''Editable()''' returns false!.
 
<big><pre>
 
<big><pre>
   int Edit(IO_Form* Owner=(IO_Form*)0);
+
   int edit(void);
 
</pre></big>
 
</pre></big>
 
'''Edit()''', Calls '''Display()''' and returns '''0'''. This method ignores the '''Owner''', IO_Form pointer.
 
'''Edit()''', Calls '''Display()''' and returns '''0'''. This method ignores the '''Owner''', IO_Form pointer.
Line 349: Line 486:
 
The destructor, delete[]s the '''_data'''. (make sure '''_data''' is casted to char* before deleting.
 
The destructor, delete[]s the '''_data'''. (make sure '''_data''' is casted to char* before deleting.
 
<big><pre>
 
<big><pre>
   IO_Label &operator=(const char* str);
+
   IO_Label& operator=(const char* str);
 +
</pre></big>
 +
'''operator=()''', Calls '''set()''' and returns itself.
 +
 
 +
==IO_Edit==
 +
 
 +
Inherit IO_Field and IO_Frame into a new class called IO_Edit. (Read: Practical Programming Techniques Using C++, pages 94 to 96, ''Multiple Inheritance'' topic)
 +
 
 +
IO_Edit, encapsulates the '''[[OOP344_Assignment_One#Line_and_Selection_Editor|io_edit()]]''' function of ciol library when isTextEditor is false. IO_Edit calls the io_edit function to edit a string that is either created dynamically by the IO_Edit itself, or a string that is external and is received through the constructor arguments.
 +
 
 +
Also IO_Edit gives the user the option of surrounding the editing line with a frame.
 +
 
 +
Editing without a frame at row:2 col:5
 +
<big><pre>
 +
01234567890123456789012345678901234567890123456789
 +
1
 +
2    Hello! I am editing a text_
 +
3
 +
4
 +
5
 +
</pre></big>
 +
Editing with a frame at row:2 col:5 (the actual editing happens at row:2+1 and col: 5+1
 +
<big><pre>
 +
01234567890123456789012345678901234567890123456789
 +
1
 +
2    +-------------------------------------+
 +
3    |Hello! I am editing a text_          |
 +
4    +-------------------------------------+
 +
5
 +
</pre></big>
 +
 
 +
==Constructors and Destructor==
 +
 
 +
====Constructors====
 +
IO_Edit can be created in two ways:
 +
<big><pre>
 +
IO_Edit::IO_Edit(int row, int col, int fieldlen,
 +
    int maxdatalen, int* insertmode,
 +
    bool framed = false, const char* frameChars = (const char*)0);
 +
</pre></big>
 +
This constructor dynamically creates an array of '''maxdatalen''' + 1 chars (an empty string) and sets IO_Field::_data to point to it.
 +
 
 +
'''row and col and frameChars''' will be passed directly to the Frame class's '''top and left and frameChars''', respectively. But since an IO_Frame needs to surround the edit field, it has to have one char extra for each side. Therefore, (fieldlen + 2) should be passed to IO_Frame as width and 3 should be passed to IO_Frame as height.
 +
 
 +
On the other hand, the IO_Field class holds the actual coordinate at which, the editing should happen. So, depending on the value of the '''framed''' being false or true the values, '''(row and col)''' or '''(row+1 and col+1)''' will be passed to IO_Field's constructor respectively.
 +
 
 +
The IO_Edit In this case is marked to be dynamic, so at destruction time, the memory is deallocated.
 +
 
 +
All the arguments needed for ciol's io_edit() function should be kept as attributes so they can be used at edit() time.
 +
 
 +
<big><pre>
 +
 
 +
IO_Edit::IO_Edit(char* str, int row, int col, int fieldlen,
 +
    int maxdatalen, int* insertmode,
 +
    bool framed = false, const char* frameChars = (const char*)0);
 +
</pre></big>
 +
This constructor works exactly like the above constructor, with one exception. The data being edited is not dynamic here. So the IO_Fields::_data should point where the '''str''' argument is pointing to.
 +
Obviously, in this case IO_Edit should be marked as non-dynamic so at destruction time, the memory is NOT deallocated.
 +
 
 +
====Destructor====
 +
 
 +
The IO_Edit's destructor, checks to see if the object is marked to be dynamic. In this case it will delete[] the character content of IO_Field's _data.
 +
 
 +
===Public Methods===
 +
 
 +
====display()====
 +
<big><pre>
 +
void IO_Edit::display()const;
 +
</pre></big>
 +
display, first checks to see if IO_Edit is framed. if it is it will call the IO_Frame's display(), using _owner->getTop() and _owner->getLeft() as its topOffset and leftOffset arguments.
 +
Then it will makes a direct call to ciol's io_display() function passing IO_Field's data, getRow() and getCol() and also the fieldlen value form IO_Edit's attributes.
 +
<blockquote>
 +
Passing _owner->getTop() and _owner->getLeft() to IO_Frame's display() and also, using getRow() and getCol() for extracting row and col from IO_Field, makes row and col of the IO_Edit, relative to top, left of the form it is on. (if IO_Edit belongs to an IO_Form, that is, if _owner is not NULL)
 +
</blockquote >
 +
 
 +
====edit()====
 +
 
 +
<big><pre>
 +
int IO_Edit::edit();
 +
</pre></big>
 +
edit() makes a direct call to ciol's io_edit with corresponding data from the IO_Edit's attributes.
 +
 
 +
the '''Owner''' argument is simply ignored.
 +
 
 +
edit() returns the value returned by ciol's io_edit.
 +
 
 +
====editable()====
 +
<big><pre>
 +
bool  IO_Edit::editable()const;
 
</pre></big>
 
</pre></big>
'''operator=()''', Calls '''Set()''' and returns itself.
 
  
===IO_Edit===
+
Always returns true;
  
===IO_CheckList===
+
====set()====
  
===IO_Radio===
+
<big><pre>
 +
void IO_Edit::set(const void *str);
 +
</pre></big>
  
===IO_Menu===
+
set() copies the incoming string '''str''' into the IO_Field's '''_data''' up to '''maxdatalen''' characters.
  
===IO_MenuBar===
+
(note: if using strncpy() make sure the string is null terminated)
  
===IO_TextEdit===
 
  
==The Text Editor==
+
 
 +
==IO_Vedit==
 +
Inherit IO_Edit to a Validated line editor called IO_Vedit.
 +
IO_Vedit, works exactly like  an IO_Edit, with two differences.
 +
IO_Vedit has two extra attributes that are pointers to Validation and Help functions:
 +
<big><pre>
 +
  void (*_Help)(MessageStatus, IO_Form&);
 +
  bool (*_Validate)(const char*, IO_Form&);
 +
</pre></big>
 +
 
 +
===Constructors===
 +
<big><pre>
 +
  IO_Vedit(int row, int col, int fieldlen,
 +
    int maxdatalen, int* insertmode,
 +
    bool framed = false,
 +
    bool (*Validate)(const char* , IO_Form&) = NO_VFUNC,
 +
    void (*Help)(MessageStatus, IO_Form&) = NO_FUNC,
 +
    const char* frameChars = (const char*)0);
 +
  IO_Vedit(char* str, int row, int col, int fieldlen,
 +
    int maxdatalen, int* insertmode,
 +
    bool framed = false,
 +
    bool (*Validate)(const char*, IO_Form&) = NO_VFUNC,
 +
    void (*Help)(MessageStatus, IO_Form&) = NO_FUNC,
 +
    const char* frameChars = (const char*)0);
 +
</pre></big>
 +
 
 +
These two constructors pass all the information directly to IO_Edit's constructor and then set the "function pointers" attributes to their corresponding arguments.
 +
 
 +
===Public Function===
 +
 
 +
<big><pre>
 +
int edit();
 +
</pre></big>
 +
 
 +
* if '''_owner''' of IO_Vedit is null, then it simply calls the IO_Edit's '''edit()''' and terminates (returning the same value as IO_Edit::edit())
 +
* if '''_owner''' is not null
 +
** if the help function pointer attribute is not NULL, it will call it passing '''SetMesssage'' , and '''*_owner''' as arguments (This will show the help message for this field, before editing begins.)
 +
** if the validation function pointer is not null then it will call the IO_Edit::edit() and validate the data with it by keep repeating the IO_Edit::edit() until either validation function return true or the IO_Edit::edit() was terminated by a non navigation key.
 +
** Navigation keys are: '''UP_KEY DOWN_KEY TAB_KEY and ENTER_KEY'''
 +
** Right before the IO_Vedit::edit() Terminates, if the help function pointer attribute is not NULL, it will call it again passing '''ClearMesssage'' , and '''*_owner''' as arguments (this will clear the help message after editing is done.)
 +
** IO_Vedit::edit() will return the return value of IO_Edit::edit().
 +
 
 +
==IO_CheckList==
 +
IO_Checklist a child of IO_Field and IO_Frame and is responsible to create an option list for user, letting her choose one or many of them and submit the selection.
 +
IO_Checklist can work in two modes:
 +
 
 +
*Radio mode; were the selection is exclusive and each selection deselects the rest of the selections.
 +
 
 +
*CheckBox mode; where the selection is inclusive and many selections can be done at the same time.
 +
 
 +
''Note that IO_CheckList is always framed...''
 +
===Constructor===
 +
Checklist is created as follows:
 +
<big><pre>
 +
  IO_CheckList(CheckListMode mode, int row, int col,
 +
    const char* items,
 +
    const char* format = (const char*)0,
 +
    const char* frameChars = _FRAME_LISTS);
 +
</pre></big>
 +
*'''mode''' is one of the two selection of <big><code>enum CheckListMode{CheckBox, Radio}</code></big> that should be defined in io_def.h.
 +
*'''row''' and '''col''' are the top, left corner of the frame surrounding the options.
 +
*'''items''' is a "newline" separated list of options in a string.
 +
*'''format''' is a 3 char string that holds the shape of a checked option(i.e. "[X]" or "<@>"),if the format is zero, then depending of the value of '''mode''' being '''Radio''' or '''CheckBox''', frame will be defaulted to '''_RADIOLIST_CHARS''' or '''_CHECKLIST_CHARS''' respectively.
 +
*'''frameChars''' is a string with the characters building the frame.
 +
 
 +
'''Member Variables:'''
 +
*'''char** _items''' is a pointer to an array of character pointers.
 +
*'''int _len''' contains the number of character pointers in _items. In other words, the number of items in the checklist.
 +
*'''int _titlelen''' contains the length of the longest item in the list. 
 +
 
 +
===Public Methods===
 +
 
 +
<big><pre>
 +
  void display()const;
 +
</pre></big>
 +
*display every item in one line. It first call the IO_Frame's display(), using _owner->getTop() and _owner->getLeft() as its topOffset and leftOffset arguments. Then display the checkbox and check item.
 +
 
 +
<big><pre>
 +
  int edit(void);
 +
</pre></big>
 +
*This function can change the status for each check item. Use UPKEY and DOWNKEY to select the individual check item, SPACE key to toggle the check status, and other keys to exit the edit mode. This function returns the last key value.
 +
 
 +
<big><pre>
 +
  int selectedIndex(void);
 +
</pre></big>
 +
*return the index of the first checked item. return -1 if none of them checked.
 +
 
 +
<big><pre>
 +
  bool  editable()const;
 +
</pre></big>
 +
*always return true.
 +
 
 +
<big><pre>
 +
  void set(const void *flags);
 +
</pre></big>
 +
*set the status (checked or unchecked)for each item.
 +
 
 +
<big><pre>
 +
  bool& operator[](unsigned int index);
 +
</pre></big>
 +
*return the checked status for the item indexed by parameter index.
 +
 
 +
<big><pre>
 +
  int length(void);
 +
</pre></big>
 +
*return the number of items
 +
---incomplete---
 +
 
 +
==IO_Menu==
 +
IO_Menu is a child of IO_Field and IO_Frame and is responsible for creating a menu in which the user can select one item and submit the selection.
 +
IO_Menu can be organized in two ways, Vertical and Horizontal.
 +
 
 +
*Vertical:
 +
<blockquote>
 +
  The menu items will be displayed vertically and the list will be framed.
 +
</blockquote>
 +
*Horizontally
 +
<blockquote>
 +
  The menu items will be displayed horizontally and the list will NOT be framed.
 +
</blockquote>
 +
 
 +
===Constructor===
 +
This is how an IO_Menu is created:
 +
<big><pre>
 +
  IO_Menu(int row, int col,
 +
    const char* items,int selIndex = 0,MenuDir dir = Vertical,
 +
    const char* format = _MENU_CHARS,
 +
    const char* frameChars = _FRAME_MENUS);
 +
</pre></big>
 +
*'''row''' and '''col''' are the top, left of where the menu will be displayed.
 +
*'''items''' is a "newline" separated list of menu items.
 +
*'''selIndex''' is the selected index of the menu, when it is initially displayed.
 +
*'''dir''' is one of the <big><code>enum MenuDir{Vertical, Horizontal}</code></big> values defined in io_def.h.
 +
*'''format''' is a 2 char, string, holding the surrounding chars of a selected menu item.
 +
*'''frameChars''' are the characters building the frame (if the object is framed).
 +
 
 +
===Public Methods===
 +
<big><pre>
 +
void display()const;
 +
</pre></big>
 +
This function displays menu items horizontally or vertically.For vertical menu,
 +
the menu items will be framed.
 +
<big><pre>
 +
int edit(void);
 +
</pre></big>
 +
This function allows users to navigate through menu items by pressing page down
 +
& up keys for vertical menu and right & left keys for horizontal menu. By
 +
pressing space key,current menu item would be selected, our previous selected
 +
menu item would be displayed then deselected.Other keys just terminates the
 +
function and returns the key.
 +
<big><pre>
 +
int selectedIndex(void);
 +
</pre></big>
 +
<big><pre>
 +
void selectedIndex(int);
 +
</pre></big>
 +
<big><pre>
 +
bool  editable()const;
 +
</pre></big>
 +
<big><pre>
 +
void set(const void *index);
 +
</pre></big>
 +
<big><pre>
 +
void set(int index);
 +
</pre></big>
 +
<big><pre>
 +
bool operator[](unsigned int index);
 +
</pre></big>
 +
<big><pre>
 +
int length(void);
 +
</pre></big>
 +
This function returns length of menu. In other words, it returns number of menu
 +
items.
 +
 
 +
==IO_TextEdit==
 +
Inherit IO_Field and IO_Frame into a new class called IO_TextEdit. (Read: Practical Programming Techniques Using C++, pages 94 to 96, Multiple Inheritance topic)
 +
 
 +
IO_TextEdit, uses the io_edit() function of ciol library having its isTextEditor flag set to true (1). IO_TextEdit calls the io_edit function repeatedly to edit series of strings that is created dynamically by the IO_TextEdit. If initially a newline-separated (\n) string is provided, IO_TextEdit will split the string into several strings and copy them into dynamically allocated series of strings.
 +
 
 +
IO_TextEdit will do the edit in a framed multiline text field. Editing begins with the cursor at the top left of the field or from the position the editing was terminated last time.
 +
 
 +
Each line can be edited using the io_edit. If during the process of editing the string is shifted, make sure all lines are shifted together. If in overstrike mode hitting the enter key goes to next line. Otherwise (in insert mode) it should insert a new line after the current line and if there is any data after the current position, the data should be cut, and pasted to the newly created line. The cursor should stand at the beginning of the new line.
 +
 
 +
Up and Down arrows should focus the editing on previous and next lines respectfully and if needed, to accommodate this the lines should shift to up and down. However, if UP and Down keys are hit on the first or last line of data, then the function will terminate returning those values.
 +
 
 +
Page up and down should scroll the lines in the text field up and down "height-2" times, or better to say, scroll the text a page up or down if possible. if paging is not possible, then the keys are ignored.
 +
 
 +
Each line in the text can be the maximum of "_IO_TEXT_ALLOCATION_LINE_SIZE" characters, defined in io_def.h
 +
 
 +
===Constructors===
 +
 
 +
IO_TextEdit can be created as follows:
 +
 
 +
===Dynamic Data===
 +
 
 +
<big><pre>IO_TextEdit(int row, int col, int width, int height,int* insertmode,
 +
    int maxLines = -1,const char* frameChars = (const char*)0);</pre></big>
 +
 
 +
This constructor set the class to dynamically create "series of strings" to be edited by io_edit function in the edit method when needed.The arguments, row and column are top and left coordinates of the text field and width and height are the width and height of the text field.
 +
 
 +
insertMode is where the insert flag status is kept.
 +
 
 +
frameChars hold the optional characters to build the frame.
 +
 
 +
The "single dimension string" representation of the "series of the strings" holding the text, in this case, will be allocated and kept dynamically.
 +
 
 +
maxLines argument will limit the number of the lines in text, unless it is set to -1.
 +
 
 +
===Non-dynamic Data===
 +
 
 +
<big><pre>IO_TextEdit(char* str, int row, int col, int width, int height,int* insertmode,
 +
  int maxLines = -1,const char* frameChars = (const char*)0);</pre></big>
 +
 
 +
This constructor initially splits the newline separated data from the "str" argument into series of lines that are created dynamically to be edited by the io_edit function in the edit method. The arguments, row and column are top and left coordinates of the text field and width and height are the width and height of the text field.
 +
 
 +
insertMode is where the insert flag status is kept.
 +
 
 +
frameChars hold the optional characters to build the frame.
 +
 
 +
The "single dimension string" representation of the "series of the strings" holding the text will then be where str argument is pointing to. No dynamic memory is allocated for this.It is the caller program's responsibility to accommodate enough space for the data;
 +
 
 +
maxLines argument will limit the number of the lines in text, unless it is set to -1.
 +
 
 +
Make sure you store the address of where str is pointing in the _data of IO_Field for future use.
 +
 
 +
==Public Methods==
 +
 
 +
===void display()const;===
 +
 
 +
Displays the frame, and in the frame it will display the text from the top left being the first character of the first line or otherwise any position it was been right before the editing was terminated the last time.
 +
 
 +
===void *data();===
 +
 
 +
first converts back the series of string to a single dimension newline separated string of characters pointed by the IO_Field's data, and then returns it.
 +
 
 +
If object is dynamic (created by the first constructor) then you may have to reallocate memory to make room for conversion.
 +
 
 +
If object is not dynamic, (made by the second constructor) then the conversion's target will be the _data of IO_Field that was set by the constructor. No dynamic memory allocation should be done for the conversion. It is the user program of the object's responsibility to provide enough memory for this.
 +
 
 +
Make sure you modify void IO_Field::data(); method to virtual for this to work;
 +
 
 +
===int edit();===
 +
 
 +
Edits the text one line at a the framed text field created by the constructor as mentioned in the description of the class.
 +
 
 +
===bool  editable()const;===
 +
 
 +
Always returns true;
 +
 
 +
===void set(const void *str);===
 +
 
 +
splits the newline separated data from the "str" argument into "series of strings" that are created dynamically to be edited by the io_edit function in the edit method.
 +
 
 +
===virtual ~IO_TextEdit();===
 +
 
 +
deallocates the "series of strings" created for editing purposes. Also if object holds the data dynamically (created by fist constructor) it will deallocate memory pointed by the IO_Fields _data;
 +
 
 +
=The Application=
  
 
=Tips=
 
=Tips=
 +
 +
==Sample Main==
 +
<big><pre>
 +
#include "io_def.h"
 +
#include "io_form.h"
 +
#include "io_label.h"
 +
#include "io_edit.h"
 +
#include "io_vedit.h"
 +
#include <string.h>
 +
#include <stdio.h>
 +
bool ValidYear(const char* data, IO_Form& F){
 +
  bool res = true;
 +
  int i = atoi(data);
 +
  if( i < 1895 || i > 2010){
 +
    res = false;
 +
    F[4].set("Invalid");
 +
  }
 +
  else{
 +
    res = true;
 +
    F[4].set("");
 +
  }
 +
  F[4].display();
 +
  return res;
 +
}
 +
bool ValidRating(const char*data, IO_Form& F){
 +
  bool res = true;
 +
  double d = atof(data);
 +
  if( d<0.0 || d>10 ){
 +
    res = false;
 +
    F[6].set("Invalid");
 +
  }
 +
  else{
 +
    res = true;
 +
    F[6].set("");
 +
  }
 +
  F[6].display();
 +
  return res;
 +
}
 +
void YearHelp(MessageStatus m, IO_Form& F){
 +
  if(m == SetMessage){
 +
    F.setHelp("years valid between 1895 and 2010");
 +
  }
 +
  else{
 +
    F.setHelp("");
 +
  }
 +
  F.display(IO_SHOW_HELP);
 +
}
 +
void RateHelp(MessageStatus m, IO_Form& F){
 +
  if(m == SetMessage){
 +
    F.setHelp("Numbers between 0.0 and 10");
 +
  }
 +
  else{
 +
    F.setHelp("");
 +
  }
 +
  F.display(IO_SHOW_HELP);
 +
}
 +
 +
int main(void){
 +
  io_init();
 +
  int insert = 1;
 +
  char str[51] = "testing this";
 +
  IO_Form F(true, 1, 3, 70,21 );
 +
  F <<new IO_Label("| Movie Information Entry |", 0, 3)
 +
    <<new IO_Label("Name:", 2,2)<<new IO_Label("Director:", 5, 2)
 +
    <<new IO_Label("Release Date:", 8, 2)<<new IO_Label(8, 21, 10)
 +
    <<new IO_Label("User rating 1->10:", 11, 2)<<new IO_Label(11, 25, 10)
 +
    <<new IO_Label("Classification:", 14, 2)
 +
    <<new IO_Label("Genre:", 2, 36)
 +
    <<new IO_Label("Comment:", 13, 29)
 +
    <<new IO_Edit(1, 7, 15, 25, &insert, true, _FRAME_UNDERLINE)
 +
    <<new IO_Edit(4, 11, 15, 30, &insert, true, _FRAME_UNDERLINE)
 +
    <<new IO_Vedit(7,15, 5, 4, &insert, true, ValidYear, YearHelp,  _FRAME_UNDERLINE)
 +
    <<new IO_Vedit(10,20,4, 3, &insert, true, ValidRating, RateHelp, _FRAME_UNDERLINE);
 +
  F.addHelp(new IO_Label(19,2, 60));
 +
  F.edit();
 +
  io_end();
 +
  return 0;
 +
};
 +
</pre></big>
 +
 +
Screen Shot of the above program:
 +
 +
<big><pre>
 +
  +--| Movie Information Entry |---------------------------------------+
 +
  |                                                                    |
 +
  | Name:                            Genre:                          |
 +
  |      ---------------                                              |
 +
  |                                                                    |
 +
  | Director:                                                          |
 +
  |          ---------------                                          |
 +
  |                                                                    |
 +
  | Release Date:                                                      |
 +
  |              -----                                                |
 +
  |                                                                    |
 +
  | User rating 1->10:                                                |
 +
  |                    ----                                            |
 +
  |                            Comment:                                |
 +
  | Classification:                                                    |
 +
  |                                                                    |
 +
  |                                                                    |
 +
  |                                                                    |
 +
  |                                                                    |
 +
  |                                                                    |
 +
  +--------------------------------------------------------------------+
 +
</pre></big>
 +
 +
==IO_Form==
 +
 +
If you want to use a linkedlist to implement IO_Form having a node like this would be a good idea:
 +
 +
<big><pre>
 +
class IO_Node{
 +
  IO_Field* _f;
 +
  bool _dynamic;
 +
  bool _submitter;
 +
  IO_Node* next;
 +
  IO_Node* prev;
 +
  ...
 +
  ...
 +
  ...
 +
};
 +
</pre></big>
 +
And then make your IO_Form a linkedlist of IO_Nodes....
 +
 +
With this you can have the IO_field kept in the node and at the same time keep track of the IO_Field being dynamically created and if it is a submitter or not. So the data of the node will be the three attributes; '''_f''', '''_dynamic''', and '''_submitter'''.
  
 
==Fardad adds io_textedit==
 
==Fardad adds io_textedit==
Line 373: Line 980:
 
This is an edited dialogue copied from an IRC meeting
 
This is an edited dialogue copied from an IRC meeting
  
'''fardad:''' I am going to do IO_TextEdit. I will write the steps as I am doing it
+
'''fardad:''' I am going to do (the skeleton of) IO_TextEdit as an example. I will write the steps as I am doing it
  
 
#I am adding a headerfile and cpp file to my visual studio this will add the headerfile and the cpp file to the working copy.
 
#I am adding a headerfile and cpp file to my visual studio this will add the headerfile and the cpp file to the working copy.
 
#In solution exp. rightclick on headerfiles, add / new item
 
#In solution exp. rightclick on headerfiles, add / new item
 
#Added code/headerfile: "io_textedit.h"
 
#Added code/headerfile: "io_textedit.h"
#Now i am righclicking on sourcefiles/newitem code/cpp file
+
#Now i am rightclicking on sourcefiles/newitem code/cpp file
#Added inclusion guards code to the headerifle (#ifndef __IO_TEXTEDIT_H__.....)
+
#Added inclusion guards code to the headerfile (#ifndef __IO_TEXTEDIT_H__.....)
#Included general headerifle in io_textedit.h. It will have all necessary definitions and includes for the project
+
#Included general headerfile in io_textedit.h. It will have all necessary definitions and includes for the project
#Adding io_textedit.h and io_textdit.cpp to working copy($svn add ..., this tags them to be added to repository the next time svn is commited)  
+
#Adding io_textedit.h and io_textdit.cpp to working copy($svn add ..., this tags them to be added to repository the next time svn is committed)  
 
#Compiled and it was successful, so I will commit now
 
#Compiled and it was successful, so I will commit now
  
'''fardad:''' Done, you can now update you working copy and see what I did.  You should do the same for all the other classes.  It should not take you more than 30 minutes to do you part, just pick a class and write it.
+
'''fardad:''' Done, you can now update you working copy and see what I did.  You should do the same for all the other classes.  It should not take you more than 30 minutes to do your part, just pick a class and write it.
 +
 
 +
==Compiling under linux==
 +
 
 +
If anyone is actually trying to compile under linux, they will notice quickly it fails.
 +
 
 +
To compile in matrix, use:
 +
 
 +
g++ yada.cpp yadoo.cpp -x c ciol.c -lncurses
 +
 
 +
 
 +
If you have many cpp's, you may also do
 +
 
 +
g++ *.cpp -x c ciol.c -lncurses

Latest revision as of 13:15, 17 April 2013

OOP344 - OOP344 Student List - OOP344 Teams - OOP344 Assignment One - OOP344 Assignment Two - OOP344 IRC Schedules
- OOP344 Student Resources
Under construction...

Contents

Due Dates

  • Saturday, November 28th: Version 0.1 (Initial working version)
  • Tuesday, December 8th: Version 1.0 (Working version)
  • Tuesday, December 8th to Thursday, December 17th: Final debugging and IRC meetings

File Names

Save your work in separate files for each class, and name the files to the same name as the classes; each class should have a header file and a code file.

For example for the class IO_Field, create IO_Field.h and IO_Field.cpp. The header file should hold the class declaration, and any other possible declaration related to the class. The "cpp" file should hold the definition (implementation) of the class, and its methods and possible functions.

Create a Make file to build your project with respect to dependencies of classes.

SVN Quick Notes

  1. Checkout the code $svn co svn://zenit.senecac.on.ca/ops344_093aXX/trunk/PRJ --username yourUserName Remember, XX is your SVN number after your section ('a' etc.)
  2. Add selected ciol.h ciol.cpp and if present the class files (all compiled) $svn add filename
  3. Commit the new files $svn commit
  4. Team members check out the individually
  5. development starts.

How to reuse your C code in C++ programs

Include your already existing C code into your C++ code as follows:

extern "C"{
#include "ciol.h"
};

This tells to C++ compiler, the included header file contains C functions and should be complied and called as such. Remember, you do not need and should not rename your ciol.c to ciol.cpp, since the compiler is already aware of the C functions in ciol.c.

Team Project Wiki Pages

Add a link to your Team project Wiki pages here:

West Side Connection

A Team

All are welcome

BITE

Team ++ website

Team BINGO

Team Temporary Name

Team Funktion website

Best Team Ever :)

ASOS_Brigade

Team Hasselhoff

General Definition Header file

create a file called: io_def.h. This file will contain any necessary definitions or inclusions for the project.

for now add the following define statements in io_def.h


#ifndef _CRT_SECURE_NO_DEPRECATE
#define _CRT_SECURE_NO_DEPRECATE
#endif
#ifndef _CRT_SECURE_NO_WARNINGS
#define _CRT_SECURE_NO_WARNINGS
#endif
#define IO_NO_ACTION (0x1u)
#define IO_CLEAR (0x2u)
#define IO_SHOW_ALL (0x4u)
#define IO_SHOW_ERROR (0x8u)
#define IO_SHOW_HELP (0x10u)

// frame chars
#define _FRAME_CHARS "|+-+|+-+"
#define _FRAME_UNDERLINE "      - "
#define _FRAME_UNDEROVER "  -   - "
#define _FRAME_LISTS "|/-\\|/-\\"
#define _FRAME_MENUS "|+-+|+-+"

#define _CHECKLIST_CHARS "[X]"
#define _RADIOLIST_CHARS "(o)"
#define _MENU_CHARS "[]"
#define _IO_TEXT_ALLOCATION_LINE_SIZE 1024
 

#ifdef NO_FUNC
# undef NO_FUNC
#endif
#define NO_FUNC ((void(*)(MessageStatus, IO_Form&))(0))

#ifdef NO_VFUNC
# undef NO_VFUNC
#endif
#define NO_VFUNC ((bool(*)(const char*, IO_Form&))(0))

enum MessageStatus{ClearMessage,SetMessage};
enum CheckListMode{CheckBox, Radio};
enum MenuDir{Vertical, Horizontal};

#endif

Mandatory Classes

As the first part of your project this semester, you are to create few classes to encapsulate Console Input Output Library

IO_Field

IO_Field is the base class for all different types of Fields on a Form.

class IO_Form;
class IO_Field{
private:
  int _row;
  int _col;
protected:
  void* _data;
  IO_Form* _owner;
  int getOwnerTop(void)const;
  int getOwnerLeft(void)const;
  void displayOwner(void)const;
public:
  IO_Field(int row, int col, void* data = (void*)0);
  virtual void* data(void);
  virtual void display(void)const = 0;
  virtual int edit(void)= 0;
  virtual bool editable(void)const = 0;
  virtual void set(const void *) = 0;
  virtual void set(IO_Form* owner);
  int getRow(void)const;
  int getCol(void)const;
  virtual ~IO_Field(void);
};

Constructor

IO_Field(int row, int col, void* data = (void*)0);

This constructor sets the corresponding attributes to the values of incoming arguments.

Protected Methods

getOwnerTop and left (optional)

  int getOwnerTop()const;
  int getOwnerLeft()const;

These two methods return the top and left, coordinates of the frame of the form in which the field exists.They simply return zero, if there is no owner. This can help the display methods of a field to place the field at the correct, relative position according to the form they are displayed in.

displayOwner() (optional)

  void displayOwner()const;

This method displays the owner of a field, if it exists. This can help a Field to hide itself, by displaying the owner, without displaying itself.

Public Methods

data()

virtual void* data();

Returns the value of the data attribute.

set(IO_Form*)

virtual void set(IO_Form* owner);

Sets the _owner attribute to incoming argument.

getRow()

int getRow(void)const;
  • if _owner is NULL, it returns the _row attribute
  • if _owner is not NULL it returns the sum of _row and _owner->getTop(); (see IO_Frame for getTop())

getCol()

int getCol(void)const;
  • if _owner is NULL, it returns the _col attribute
  • if _owner is not NULL it returns the sum of _col and _owner->getLeft(); (see IO_Frame for getLeft())

Destructor

virtual ~IOField();

An empty destructor (the body of the method is blank)

Pure Virtual Methods

virtual void display() = 0;
virtual int edit()= 0;
virtual bool editable() = 0;
virtual void set(const void *) = 0;

These are pure virtual methods enforcing the creation of the identical methods in the derived classes. This make the IO_Field class an abstract class. Note: The purpose of passing an IO_Form pointer to the Edit method, is to make the future Edit methods capable of sending a message (errors and help messages)to the Screen they are being Edited on.

IO_Frame

IO_Frame class, encapsulates a frame. It Draws a frame at left top corner of left and top with specified width and height.

A Frame can be instantiated as follows:

IO_Frame(int top, int left, int width, int height, const char* frameChars = (const char*)0);

the frameChars are characters used to draw the frame, characters in order are:

  1. left side
  2. left top corner
  3. top side
  4. top right corner
  5. right side
  6. right bottom corner
  7. bottom side
  8. bottom left corner

So to draw this:

  /--------\
  |        |
  |        |  
  |        |
  \--------/

frame chars should be:

"|/-\|/-\"

If however, the frameChars argument is missing (it is NULL) then a default, defined value in "io_def.h"; _FRAME_CHARS should be used.

Public Methods

display()

void display(int topOffset=0, int leftOffset=0)const;

display(), starts from top + topOffset and left + leftOffset and draws the frame to the width and height received from the constructor.

getLeft()

int getLeft();

returns the _left attribute;

getTop()

int getTop();

returns the _top attribute;

void set()

void set(int top, int left);

sets the _top and _left attributes to corresponding arguments.

Destructor

IO_Frame has a virtual destructor. This destructor does nothing.

IO_Form

IO_Frame is inherited into a container class called IO_Form. IO_Form organizes the IO_Field classes and give the user a panel to use them sequentially.

IO_Form should be able to hold unlimited number of IO_Fields. (Use either a dynamic array, or linked list structure of IO_Fields to implement this)


Constructor

IO_Form is constructed as follows:

 IO_Form(bool framed = false, 
         int row = 0, int col = 0 , int width = 0 , int height = 0, 
         const char* frameChars = (const char*)0);

framed: if true, IO_Form will use its parent to draw a frame around itself when display()ed row, col, width and height are passed to the parent under following conditions:
If framed is true and "width or height" are 0 (zero) then the full size of the terminal is used for dimensions of the IO_Frame.


Destructor

virtual ~IO_Form();

When IO_Form is going out of scope, is being destroyed, all dynamic IO_Fields are deleted. (the rest will not be deallocated)


Private Methods

Adding a Field to the Form

the IO_Form must be able to add several IO_Field classes to itself, one at a time and then provide the user, the means of editing them in order they were added.

int add(IO_Field* f, bool dynamic, bool submitter);

IO_Form uses this private add method to provide means of adding fields through several public add methods. this method adds an IO_Field to the end of the IO_Fields in the IO_Form;

  • f  : Is the address of the IO_Field begin added to the IO_Form
  • dynamic  : If set to true, it sets this IO_Field to be deallocated by IO_Form's destructor at the end;
  • submitter: If set to true, it tags this IO_Field to terminate the IO_Form's edit() if ENTER_KEY is hit. see the edit() method for more info.

add() also calls set(IO_Form* owner) of IO_Field and passes its pointer (this) to it. By doing this, each IO_Field will know who is its owner. add() returns the number of fields currently in IO_FORM.


Public Methods

Add methods

int add(IO_Field* f, bool submitter  = false);

Uses the private add() method to add a dynamic IO_Field.


int add(IO_Field& f, bool submitter = false);

Uses the private add() method to add a non-dynamic IO_Field.


int addHelp(IO_Label* L);

Uses the private add() method to add a dynamic IO_Field and also saves its address for the general help message label of the Form.


int addHelp(IO_Label& L);

Uses the private add() method to add a non-dynamic IO_Field and also saves its address for the general help message label of the Form.


int addError(IO_Label* L);

Uses the private add() method to add a dynamic IO_Field and also saves its address for the general error message label of the Form.


int addError(IO_Label& L);

Uses the private add() method to add a non-dynamic IO_Field and also saves its address for the general error message label of the Form.


IO_Form& operator<<(IO_Field* f);

Uses the private add() method to add a non-submitter, dynamic IO_Field.


IO_Form& operator<<(IO_Field& f);

Uses the private add() method to add a non-submitter, non-dynamic IO_Field.


Setting General Error and Help messages

void setError(const char* mes);
void setHelp(const char* mes);

Set the text of the general Error message and the general Help message of the Form.


Number of fields in Form

int length();

Returns number of fields currently in IO_Form.


Accessing Field Data

void* data(unsigned int fieldnumber=0);

Returns address of the data of "fieldnumber"th, IO_Field in the IO_Form. If "fieldnumber" is zero, then it returns the data of the current IO_Field.

The index operator

IO_Field& operator[](unsigned int index);

Returns the reference of the IO_Field, number "fieldnumber-1". First Field has the index 0;


Displaying the Form

void display(unsigned int how = IO_CLEAR | IO_SHOW_ALL ,unsigned int fieldnumber = 0 );  

Displays the Form and all the Fields on it.

fieldnumber is the number of the field that was returned by any of the add() functions.

how: is a binary mask, and following bits can be set in it:

IO_CLEAR (0x2u)
IO_SHOW_ALL (0x4u)
IO_SHOW_ERROR (0x8u)
IO_SHOW_HELP (0x10u)

The display function work in the following order:

  1. If IO_CLEAR bit is set in how, then before anything the screen should be cleared.
  2. If the field number is 0 (zero) then
    1. if IO_SHOW_ALL is set in how, then all the fields are displayed in the order they were added
    2. otherwise either of IO_SHOW_ERROR or IO_SHOW_HELP is set, only their corresponding designated IO_Label will be displayed.
  3. if the field number is not zero, then the IO_Field number "fieldnumber" will be displayed. If the number is larger than the number of fields in the IO_Form then it will be rotated back from the beginning. (i.e. if there are 4 fields in the form and fieldnumber is 5, then filed number 1 will be displayed)

Editing(running) the Form

int edit(unsigned int* fieldnumber = (unsigned int*)0, bool Clear = true);

If neither of the IO_Fields is editable, it displays all the IO_Fields, then waits for a key entry and then ends the function by returning the key entered.

If the fieldnumber pointer is NULL, it should use a local variable’s address with the value of “0” zero instead.

If *fieldnumber is (0) zero, then display all the fields before editing the fields and then set *fieldnumber to (1) one.

Start editing from field number *fieldnumber.

Call the edit of each field and depending on the value returned, do the following:

  • For UP_KEY go to the previous editable IO_Field, if there is no previous editable IO_Field, go to the last editable IO_Field of the IO_Form and continue the search for an editable IO_Field.
  • For ENTER_KEY do exactly as TAB_KEY, except that if the current IO_Field is a submitter (is tagged to be a submitter when added), in which case terminate the edit function returning the ENTER_KEY.
  • For any other key, terminate the edit function returning the character which caused the termination.

IO_Label

IO_Label class mostly, encapsulates the io_display() function. Inherit a new class called IO_Label from IO_Field to Display a text message on IO_Form. In addition to the attributes of its parent IO_Field, IO_Label has a private integer attribute called _len. _len is used to hold the length of Field in which the text is to be displayed. IO_Label holds its data dynamically and will never point to an external one. IO_Label can be created in two ways;

  IO_Label(int row, int col, int len);

This constructor will create an empty (blank) IO_Label with capacity of len characters. In this case row and col are passed to the parent for initialization and _len (the attribute) is set to the incoming argument len. Then IO_Field::_data will be set to the address of a newly allocated memory to the size of _len + 1 bytes which also will be set to an empty string. Note that data is a void pointer; to use it here, you must cast it to a character pointer!

  IO_Label(const char* str, int row, int col, int len = -1);

If len is greater than zero, This constructor will create an IO_Label by allocating len + 1 characters pointed by IO_Field::_data, and then the contents of str is copied into IO_Field::_data up to len characters. _len attribute is set to len; If len is less than or equal to zero, then len will be set to the length of str and then constructor will work as previous case. Like the previous constructor it will pass row and col to its parent.

Public Methods

void display(void);

Display() is a direct call to io_display() function printing _data, at getRow() and getCol() up to _len characters. If _len is less than zero, then _data will be printed to the end.

  void set(const void* str);

Set() will copy the content of str into IO_Field::_data up to _len characters, if _len is not negative.

bool editable(void)const;

Editable() returns false!.

  int edit(void);

Edit(), Calls Display() and returns 0. This method ignores the Owner, IO_Form pointer.

   ~IO_Label(void);

The destructor, delete[]s the _data. (make sure _data is casted to char* before deleting.

  IO_Label& operator=(const char* str);

operator=(), Calls set() and returns itself.

IO_Edit

Inherit IO_Field and IO_Frame into a new class called IO_Edit. (Read: Practical Programming Techniques Using C++, pages 94 to 96, Multiple Inheritance topic)

IO_Edit, encapsulates the io_edit() function of ciol library when isTextEditor is false. IO_Edit calls the io_edit function to edit a string that is either created dynamically by the IO_Edit itself, or a string that is external and is received through the constructor arguments.

Also IO_Edit gives the user the option of surrounding the editing line with a frame.

Editing without a frame at row:2 col:5

01234567890123456789012345678901234567890123456789
1
2    Hello! I am editing a text_
3
4
5

Editing with a frame at row:2 col:5 (the actual editing happens at row:2+1 and col: 5+1

01234567890123456789012345678901234567890123456789
1
2    +-------------------------------------+
3    |Hello! I am editing a text_          |
4    +-------------------------------------+
5

Constructors and Destructor

Constructors

IO_Edit can be created in two ways:

IO_Edit::IO_Edit(int row, int col, int fieldlen,
    int maxdatalen, int* insertmode,
    bool framed = false, const char* frameChars = (const char*)0);

This constructor dynamically creates an array of maxdatalen + 1 chars (an empty string) and sets IO_Field::_data to point to it.

row and col and frameChars will be passed directly to the Frame class's top and left and frameChars, respectively. But since an IO_Frame needs to surround the edit field, it has to have one char extra for each side. Therefore, (fieldlen + 2) should be passed to IO_Frame as width and 3 should be passed to IO_Frame as height.

On the other hand, the IO_Field class holds the actual coordinate at which, the editing should happen. So, depending on the value of the framed being false or true the values, (row and col) or (row+1 and col+1) will be passed to IO_Field's constructor respectively.

The IO_Edit In this case is marked to be dynamic, so at destruction time, the memory is deallocated.

All the arguments needed for ciol's io_edit() function should be kept as attributes so they can be used at edit() time.


IO_Edit::IO_Edit(char* str, int row, int col, int fieldlen,
    int maxdatalen, int* insertmode, 
    bool framed = false, const char* frameChars = (const char*)0);

This constructor works exactly like the above constructor, with one exception. The data being edited is not dynamic here. So the IO_Fields::_data should point where the str argument is pointing to. Obviously, in this case IO_Edit should be marked as non-dynamic so at destruction time, the memory is NOT deallocated.

Destructor

The IO_Edit's destructor, checks to see if the object is marked to be dynamic. In this case it will delete[] the character content of IO_Field's _data.

Public Methods

display()

void IO_Edit::display()const;

display, first checks to see if IO_Edit is framed. if it is it will call the IO_Frame's display(), using _owner->getTop() and _owner->getLeft() as its topOffset and leftOffset arguments. Then it will makes a direct call to ciol's io_display() function passing IO_Field's data, getRow() and getCol() and also the fieldlen value form IO_Edit's attributes.

Passing _owner->getTop() and _owner->getLeft() to IO_Frame's display() and also, using getRow() and getCol() for extracting row and col from IO_Field, makes row and col of the IO_Edit, relative to top, left of the form it is on. (if IO_Edit belongs to an IO_Form, that is, if _owner is not NULL)

edit()

int IO_Edit::edit();

edit() makes a direct call to ciol's io_edit with corresponding data from the IO_Edit's attributes.

the Owner argument is simply ignored.

edit() returns the value returned by ciol's io_edit.

editable()

bool  IO_Edit::editable()const;

Always returns true;

set()

void IO_Edit::set(const void *str);

set() copies the incoming string str into the IO_Field's _data up to maxdatalen characters.

(note: if using strncpy() make sure the string is null terminated)


IO_Vedit

Inherit IO_Edit to a Validated line editor called IO_Vedit. IO_Vedit, works exactly like an IO_Edit, with two differences. IO_Vedit has two extra attributes that are pointers to Validation and Help functions:

  void (*_Help)(MessageStatus, IO_Form&);
  bool (*_Validate)(const char*, IO_Form&);

Constructors

  IO_Vedit(int row, int col, int fieldlen,
    int maxdatalen, int* insertmode,
    bool framed = false,
    bool (*Validate)(const char* , IO_Form&) = NO_VFUNC, 
    void (*Help)(MessageStatus, IO_Form&) = NO_FUNC,
    const char* frameChars = (const char*)0);
  IO_Vedit(char* str, int row, int col, int fieldlen,
    int maxdatalen, int* insertmode, 
    bool framed = false,
    bool (*Validate)(const char*, IO_Form&) = NO_VFUNC, 
    void (*Help)(MessageStatus, IO_Form&) = NO_FUNC,
    const char* frameChars = (const char*)0);

These two constructors pass all the information directly to IO_Edit's constructor and then set the "function pointers" attributes to their corresponding arguments.

Public Function

 int edit();
  • if _owner of IO_Vedit is null, then it simply calls the IO_Edit's edit() and terminates (returning the same value as IO_Edit::edit())
  • if _owner is not null
    • if the help function pointer attribute is not NULL, it will call it passing SetMesssage , and *_owner' as arguments (This will show the help message for this field, before editing begins.)
    • if the validation function pointer is not null then it will call the IO_Edit::edit() and validate the data with it by keep repeating the IO_Edit::edit() until either validation function return true or the IO_Edit::edit() was terminated by a non navigation key.
    • Navigation keys are: UP_KEY DOWN_KEY TAB_KEY and ENTER_KEY
    • Right before the IO_Vedit::edit() Terminates, if the help function pointer attribute is not NULL, it will call it again passing ClearMesssage , and *_owner' as arguments (this will clear the help message after editing is done.)
    • IO_Vedit::edit() will return the return value of IO_Edit::edit().

IO_CheckList

IO_Checklist a child of IO_Field and IO_Frame and is responsible to create an option list for user, letting her choose one or many of them and submit the selection. IO_Checklist can work in two modes:

  • Radio mode; were the selection is exclusive and each selection deselects the rest of the selections.
  • CheckBox mode; where the selection is inclusive and many selections can be done at the same time.

Note that IO_CheckList is always framed...

Constructor

Checklist is created as follows:

  IO_CheckList(CheckListMode mode, int row, int col,
    const char* items,
    const char* format = (const char*)0,
    const char* frameChars = _FRAME_LISTS);
  • mode is one of the two selection of enum CheckListMode{CheckBox, Radio} that should be defined in io_def.h.
  • row and col are the top, left corner of the frame surrounding the options.
  • items is a "newline" separated list of options in a string.
  • format is a 3 char string that holds the shape of a checked option(i.e. "[X]" or "<@>"),if the format is zero, then depending of the value of mode being Radio or CheckBox, frame will be defaulted to _RADIOLIST_CHARS or _CHECKLIST_CHARS respectively.
  • frameChars is a string with the characters building the frame.

Member Variables:

  • char** _items is a pointer to an array of character pointers.
  • int _len contains the number of character pointers in _items. In other words, the number of items in the checklist.
  • int _titlelen contains the length of the longest item in the list.

Public Methods

  void display()const;
  • display every item in one line. It first call the IO_Frame's display(), using _owner->getTop() and _owner->getLeft() as its topOffset and leftOffset arguments. Then display the checkbox and check item.
  int edit(void);
  • This function can change the status for each check item. Use UPKEY and DOWNKEY to select the individual check item, SPACE key to toggle the check status, and other keys to exit the edit mode. This function returns the last key value.
  int selectedIndex(void);
  • return the index of the first checked item. return -1 if none of them checked.
  bool  editable()const;
  • always return true.
  void set(const void *flags);
  • set the status (checked or unchecked)for each item.
  bool& operator[](unsigned int index);
  • return the checked status for the item indexed by parameter index.
  int length(void);
  • return the number of items

---incomplete---

IO_Menu

IO_Menu is a child of IO_Field and IO_Frame and is responsible for creating a menu in which the user can select one item and submit the selection. IO_Menu can be organized in two ways, Vertical and Horizontal.

  • Vertical:

The menu items will be displayed vertically and the list will be framed.

  • Horizontally

The menu items will be displayed horizontally and the list will NOT be framed.

Constructor

This is how an IO_Menu is created:

  IO_Menu(int row, int col,
    const char* items,int selIndex = 0,MenuDir dir = Vertical,
    const char* format = _MENU_CHARS,
    const char* frameChars = _FRAME_MENUS);
  • row and col are the top, left of where the menu will be displayed.
  • items is a "newline" separated list of menu items.
  • selIndex is the selected index of the menu, when it is initially displayed.
  • dir is one of the enum MenuDir{Vertical, Horizontal} values defined in io_def.h.
  • format is a 2 char, string, holding the surrounding chars of a selected menu item.
  • frameChars are the characters building the frame (if the object is framed).

Public Methods

void display()const;

This function displays menu items horizontally or vertically.For vertical menu, the menu items will be framed.

int edit(void);

This function allows users to navigate through menu items by pressing page down & up keys for vertical menu and right & left keys for horizontal menu. By pressing space key,current menu item would be selected, our previous selected menu item would be displayed then deselected.Other keys just terminates the function and returns the key.

int selectedIndex(void);
void selectedIndex(int);
bool  editable()const;
void set(const void *index);
void set(int index);
bool operator[](unsigned int index);
int length(void);

This function returns length of menu. In other words, it returns number of menu items.

IO_TextEdit

Inherit IO_Field and IO_Frame into a new class called IO_TextEdit. (Read: Practical Programming Techniques Using C++, pages 94 to 96, Multiple Inheritance topic)

IO_TextEdit, uses the io_edit() function of ciol library having its isTextEditor flag set to true (1). IO_TextEdit calls the io_edit function repeatedly to edit series of strings that is created dynamically by the IO_TextEdit. If initially a newline-separated (\n) string is provided, IO_TextEdit will split the string into several strings and copy them into dynamically allocated series of strings.

IO_TextEdit will do the edit in a framed multiline text field. Editing begins with the cursor at the top left of the field or from the position the editing was terminated last time.

Each line can be edited using the io_edit. If during the process of editing the string is shifted, make sure all lines are shifted together. If in overstrike mode hitting the enter key goes to next line. Otherwise (in insert mode) it should insert a new line after the current line and if there is any data after the current position, the data should be cut, and pasted to the newly created line. The cursor should stand at the beginning of the new line.

Up and Down arrows should focus the editing on previous and next lines respectfully and if needed, to accommodate this the lines should shift to up and down. However, if UP and Down keys are hit on the first or last line of data, then the function will terminate returning those values.

Page up and down should scroll the lines in the text field up and down "height-2" times, or better to say, scroll the text a page up or down if possible. if paging is not possible, then the keys are ignored.

Each line in the text can be the maximum of "_IO_TEXT_ALLOCATION_LINE_SIZE" characters, defined in io_def.h

Constructors

IO_TextEdit can be created as follows:

Dynamic Data

IO_TextEdit(int row, int col, int width, int height,int* insertmode,
     int maxLines = -1,const char* frameChars = (const char*)0);

This constructor set the class to dynamically create "series of strings" to be edited by io_edit function in the edit method when needed.The arguments, row and column are top and left coordinates of the text field and width and height are the width and height of the text field.

insertMode is where the insert flag status is kept.

frameChars hold the optional characters to build the frame.

The "single dimension string" representation of the "series of the strings" holding the text, in this case, will be allocated and kept dynamically.

maxLines argument will limit the number of the lines in text, unless it is set to -1.

Non-dynamic Data

IO_TextEdit(char* str, int row, int col, int width, int height,int* insertmode,
   int maxLines = -1,const char* frameChars = (const char*)0);

This constructor initially splits the newline separated data from the "str" argument into series of lines that are created dynamically to be edited by the io_edit function in the edit method. The arguments, row and column are top and left coordinates of the text field and width and height are the width and height of the text field.

insertMode is where the insert flag status is kept.

frameChars hold the optional characters to build the frame.

The "single dimension string" representation of the "series of the strings" holding the text will then be where str argument is pointing to. No dynamic memory is allocated for this.It is the caller program's responsibility to accommodate enough space for the data;

maxLines argument will limit the number of the lines in text, unless it is set to -1.

Make sure you store the address of where str is pointing in the _data of IO_Field for future use.

Public Methods

void display()const;

Displays the frame, and in the frame it will display the text from the top left being the first character of the first line or otherwise any position it was been right before the editing was terminated the last time.

void *data();

first converts back the series of string to a single dimension newline separated string of characters pointed by the IO_Field's data, and then returns it.

If object is dynamic (created by the first constructor) then you may have to reallocate memory to make room for conversion.

If object is not dynamic, (made by the second constructor) then the conversion's target will be the _data of IO_Field that was set by the constructor. No dynamic memory allocation should be done for the conversion. It is the user program of the object's responsibility to provide enough memory for this.

Make sure you modify void IO_Field::data(); method to virtual for this to work;

int edit();

Edits the text one line at a the framed text field created by the constructor as mentioned in the description of the class.

bool editable()const;

Always returns true;

void set(const void *str);

splits the newline separated data from the "str" argument into "series of strings" that are created dynamically to be edited by the io_edit function in the edit method.

virtual ~IO_TextEdit();

deallocates the "series of strings" created for editing purposes. Also if object holds the data dynamically (created by fist constructor) it will deallocate memory pointed by the IO_Fields _data;

The Application

Tips

Sample Main

#include "io_def.h"
#include "io_form.h"
#include "io_label.h"
#include "io_edit.h"
#include "io_vedit.h"
#include <string.h>
#include <stdio.h>
bool ValidYear(const char* data, IO_Form& F){
  bool res = true;
  int i = atoi(data);
  if( i < 1895 || i > 2010){
    res = false;
    F[4].set("Invalid");
  }
  else{
    res = true;
    F[4].set("");
  }
  F[4].display();
  return res;
}
bool ValidRating(const char*data, IO_Form& F){
  bool res = true;
  double d = atof(data);
  if( d<0.0 || d>10 ){
    res = false;
    F[6].set("Invalid");
  }
  else{
    res = true;
    F[6].set("");
  }
  F[6].display();
  return res;
}
void YearHelp(MessageStatus m, IO_Form& F){
   if(m == SetMessage){
    F.setHelp("years valid between 1895 and 2010");
  }
  else{
    F.setHelp("");
  }
  F.display(IO_SHOW_HELP);
}
void RateHelp(MessageStatus m, IO_Form& F){
  if(m == SetMessage){
    F.setHelp("Numbers between 0.0 and 10");
  }
  else{
    F.setHelp("");
  }
  F.display(IO_SHOW_HELP);
}

int main(void){
  io_init();
  int insert = 1;
  char str[51] = "testing this";
  IO_Form F(true, 1, 3, 70,21 );
  F <<new IO_Label("| Movie Information Entry |", 0, 3)
    <<new IO_Label("Name:", 2,2)<<new IO_Label("Director:", 5, 2)
    <<new IO_Label("Release Date:", 8, 2)<<new IO_Label(8, 21, 10)
    <<new IO_Label("User rating 1->10:", 11, 2)<<new IO_Label(11, 25, 10)
    <<new IO_Label("Classification:", 14, 2)
    <<new IO_Label("Genre:", 2, 36)
    <<new IO_Label("Comment:", 13, 29)
    <<new IO_Edit(1, 7, 15, 25, &insert, true, _FRAME_UNDERLINE)
    <<new IO_Edit(4, 11, 15, 30, &insert, true, _FRAME_UNDERLINE)
    <<new IO_Vedit(7,15, 5, 4, &insert, true, ValidYear, YearHelp,  _FRAME_UNDERLINE)
    <<new IO_Vedit(10,20,4, 3, &insert, true, ValidRating, RateHelp, _FRAME_UNDERLINE);
  F.addHelp(new IO_Label(19,2, 60));
  F.edit();
  io_end();
  return 0;
};

Screen Shot of the above program:

   +--| Movie Information Entry |---------------------------------------+
   |                                                                    |
   | Name:                             Genre:                           |
   |       ---------------                                              |
   |                                                                    |
   | Director:                                                          |
   |           ---------------                                          |
   |                                                                    |
   | Release Date:                                                      |
   |               -----                                                |
   |                                                                    |
   | User rating 1->10:                                                 |
   |                    ----                                            |
   |                            Comment:                                |
   | Classification:                                                    |
   |                                                                    |
   |                                                                    |
   |                                                                    |
   |                                                                    |
   |                                                                    |
   +--------------------------------------------------------------------+

IO_Form

If you want to use a linkedlist to implement IO_Form having a node like this would be a good idea:

class IO_Node{
  IO_Field* _f;
  bool _dynamic;
  bool _submitter;
  IO_Node* next;
  IO_Node* prev;
  ...
  ...
  ...
};

And then make your IO_Form a linkedlist of IO_Nodes....

With this you can have the IO_field kept in the node and at the same time keep track of the IO_Field being dynamically created and if it is a submitter or not. So the data of the node will be the three attributes; _f, _dynamic, and _submitter.

Fardad adds io_textedit

This is an edited dialogue copied from an IRC meeting

fardad: I am going to do (the skeleton of) IO_TextEdit as an example. I will write the steps as I am doing it

  1. I am adding a headerfile and cpp file to my visual studio this will add the headerfile and the cpp file to the working copy.
  2. In solution exp. rightclick on headerfiles, add / new item
  3. Added code/headerfile: "io_textedit.h"
  4. Now i am rightclicking on sourcefiles/newitem code/cpp file
  5. Added inclusion guards code to the headerfile (#ifndef __IO_TEXTEDIT_H__.....)
  6. Included general headerfile in io_textedit.h. It will have all necessary definitions and includes for the project
  7. Adding io_textedit.h and io_textdit.cpp to working copy($svn add ..., this tags them to be added to repository the next time svn is committed)
  8. Compiled and it was successful, so I will commit now

fardad: Done, you can now update you working copy and see what I did. You should do the same for all the other classes. It should not take you more than 30 minutes to do your part, just pick a class and write it.

Compiling under linux

If anyone is actually trying to compile under linux, they will notice quickly it fails.

To compile in matrix, use:

g++ yada.cpp yadoo.cpp -x c ciol.c -lncurses


If you have many cpp's, you may also do

g++ *.cpp -x c ciol.c -lncurses