Form Class Reference

A simple Form. More...

#include <Form.h>

Inheritance diagram for Form:

Public Member Functions
	Form (WContainerWidget *parent=0)
	Instantiate a new form. More...
Public Member Functions inherited from Wt::WTable
	WTable (WContainerWidget *parent=0)
virtual	~WTable ()
WTableCell *	elementAt (int row, int column)
WTableRow *	rowAt (int row)
WTableColumn *	columnAt (int column)
void	removeCell (WTableCell *item)
virtual void	removeCell (int row, int column)
virtual WTableRow *	insertRow (int row, WTableRow *tableRow=0)
virtual void	deleteRow (int row)
virtual WTableColumn *	insertColumn (int column, WTableColumn *tableColumn=0)
virtual void	deleteColumn (int column)
virtual void	clear ()
int	rowCount () const
int	columnCount () const
void	setHeaderCount (int count, Orientation orientation=Horizontal)
int	headerCount (Orientation orientation=Horizontal)
virtual void	moveRow (int from, int to)
virtual void	moveColumn (int from, int to)
Public Member Functions inherited from Wt::WWidget
virtual void	setPositionScheme (PositionScheme scheme)=0
virtual PositionScheme	positionScheme () const =0
virtual void	setOffsets (const WLength &offset, WFlags< Side > sides=All)=0
virtual WLength	offset (Side side) const =0
virtual void	resize (const WLength &width, const WLength &height)
virtual WLength	width () const =0
virtual WLength	height () const =0
virtual void	setMinimumSize (const WLength &width, const WLength &height)=0
virtual WLength	minimumWidth () const =0
virtual WLength	minimumHeight () const =0
virtual void	setMaximumSize (const WLength &width, const WLength &height)=0
virtual WLength	maximumWidth () const =0
virtual WLength	maximumHeight () const =0
virtual void	setLineHeight (const WLength &height)=0
virtual WLength	lineHeight () const =0
virtual void	setFloatSide (Side s)=0
virtual Side	floatSide () const =0
virtual void	setClearSides (WFlags< Side > sides)=0
virtual WFlags< Side >	clearSides () const =0
virtual void	setMargin (const WLength &margin, WFlags< Side > sides=All)=0
virtual WLength	margin (Side side) const =0
virtual void	setHiddenKeepsGeometry (bool enabled)=0
virtual bool	hiddenKeepsGeometry () const =0
virtual void	setHidden (bool hidden, const WAnimation &animation=WAnimation())=0
virtual bool	isHidden () const =0
virtual bool	isVisible () const =0
virtual void	setDisabled (bool disabled)=0
virtual bool	isDisabled () const =0
virtual bool	isEnabled () const =0
virtual void	setPopup (bool popup)=0
virtual bool	isPopup () const =0
virtual void	setInline (bool inlined)=0
virtual bool	isInline () const =0
virtual void	setDecorationStyle (const WCssDecorationStyle &style)=0
virtual WCssDecorationStyle &	decorationStyle ()=0
virtual void	setStyleClass (const WString &styleClass)=0
virtual WString	styleClass () const =0
virtual void	addStyleClass (const WString &styleClass, bool force=false)=0
virtual void	removeStyleClass (const WString &styleClass, bool force=false)=0
virtual bool	hasStyleClass (const WString &styleClass) const =0
virtual void	setVerticalAlignment (AlignmentFlag alignment, const WLength &length=WLength::Auto)=0
virtual AlignmentFlag	verticalAlignment () const =0
virtual WLength	verticalAlignmentLength () const =0
virtual void	setToolTip (const WString &text, TextFormat textFormat=PlainText)=0
virtual WString	toolTip () const =0
virtual void	setDeferredToolTip (bool enable, TextFormat textFormat=PlainText)=0
virtual void	refresh ()
virtual void	setAttributeValue (const std::string &name, const WString &value)=0
virtual WString	attributeValue (const std::string &name) const =0
virtual void	setJavaScriptMember (const std::string &name, const std::string &value)=0
virtual std::string	javaScriptMember (const std::string &name) const =0
virtual void	callJavaScriptMember (const std::string &name, const std::string &args)=0
virtual void	load ()=0
virtual bool	loaded () const =0
virtual void	setTabIndex (int index)=0
virtual int	tabIndex () const =0
virtual void	setId (const std::string &id)=0
virtual WWidget *	find (const std::string &name)=0
virtual void	setSelectable (bool selectable)=0
virtual void	doJavaScript (const std::string &js)=0

Private Member Functions
void	countryChanged ()
	The user selected a new country: adjust the cities combo box. More...
void	submit ()
	Submit the form. More...
void	createUI ()
void	addValidationStatus (int row, WFormWidget *field)
	Add a validation feedback for a field. More...
bool	validate ()
	Validate the form, and return whether succesfull. More...
bool	checkValid (WFormWidget *edit, const WString &text)
	Validate a single form field. More...

Private Attributes
WContainerWidget *	feedbackMessages_
WLineEdit *	nameEdit_
WLineEdit *	firstNameEdit_
WComboBox *	countryEdit_
WComboBox *	cityEdit_
WDateEdit *	birthDateEdit_
WLineEdit *	childCountEdit_
WLineEdit *	weightEdit_
WTextArea *	remarksEdit_

Additional Inherited Members
Protected Member Functions inherited from Wt::WWidget
virtual void	enableAjax ()=0
virtual void	propagateSetEnabled (bool enabled)=0
virtual void	render (WFlags< RenderFlag > flags)

Detailed Description

A simple Form.

Shows how a simple form can made, with an emphasis on how to handle validation.

Definition at line 35 of file Form.h.

Constructor & Destructor Documentation

Form::Form

(

WContainerWidget *

parent = 0

)

Instantiate a new form.

Definition at line 17 of file Form.C.

  : WTable(parent)
{
  createUI();
}

Member Function Documentation

void Form::addValidationStatus ( int  row, WFormWidget *  field  )

private

Add a validation feedback for a field.

bool Form::checkValid ( WFormWidget *  edit, const WString &  text  )

private

Validate a single form field.

Checks the given field, and appends the given text to the error messages on problems.

Definition at line 158 of file Form.C.

{
  if (edit->validate() != WValidator::Valid) {
    feedbackMessages_->addWidget(new WText(text));
    feedbackMessages_->addWidget(new WBreak());
    edit->label()->decorationStyle().setForegroundColor(Wt::red);
    edit->setStyleClass("Wt-invalid");

    return false;
  } else {
    edit->label()->decorationStyle().setForegroundColor(WColor());    
    edit->setStyleClass("");

    return true;
  }
}

void Form::countryChanged ( )

private

The user selected a new country: adjust the cities combo box.

Definition at line 124 of file Form.C.

{
  cityEdit_->clear();
  cityEdit_->addItem("");
  cityEdit_->setCurrentIndex(-1);

  switch (countryEdit_->currentIndex()) {
  case 0:
    break;
  case 1:
    cityEdit_->addItem("Antwerp");
    cityEdit_->addItem("Brussels");
    cityEdit_->addItem("Oekene");
    break;
  case 2:
    cityEdit_->addItem("Amsterdam");
    cityEdit_->addItem("Den Haag");
    cityEdit_->addItem("Rotterdam");
    break;
  case 3:
    cityEdit_->addItem("London");
    cityEdit_->addItem("Bristol");
    cityEdit_->addItem("Oxford");
    cityEdit_->addItem("Stonehenge");
    break;
  case 4:
    cityEdit_->addItem("Boston");
    cityEdit_->addItem("Chicago");
    cityEdit_->addItem("Los Angelos");
    cityEdit_->addItem("New York");
    break;
  }    
}

void Form::createUI ( )

private

Definition at line 23 of file Form.C.

{
  WLabel *label;
  int row = 0;

  // Title
  elementAt(row, 0)->setColumnSpan(3);
  elementAt(row, 0)->setContentAlignment(AlignTop | AlignCenter);
  elementAt(row, 0)->setPadding(10);
  WText *title = new WText(tr("example.form"),
                           elementAt(row, 0));
  title->decorationStyle().font().setSize(WFont::XLarge);

  // error messages
  ++row;
  elementAt(row, 0)->setColumnSpan(3);
  feedbackMessages_ = elementAt(row, 0);
  feedbackMessages_->setPadding(5);

  WCssDecorationStyle& errorStyle = feedbackMessages_->decorationStyle();
  errorStyle.setForegroundColor(Wt::red);
  errorStyle.font().setSize(WFont::Smaller);
  errorStyle.font().setWeight(WFont::Bold);
  errorStyle.font().setStyle(WFont::Italic);

  // Name
  ++row;
  nameEdit_ = new WLineEdit(elementAt(row, 2));
  label = new WLabel(tr("example.name"), elementAt(row, 0));
  label->setBuddy(nameEdit_);
  nameEdit_->setValidator(new WValidator(true));
  nameEdit_->enterPressed().connect(this, &Form::submit);

  // First name
  ++row;
  firstNameEdit_ = new WLineEdit(elementAt(row, 2));
  label = new WLabel(tr("example.firstname"), elementAt(row,0));
  label->setBuddy(firstNameEdit_);

  // Country
  ++row;
  countryEdit_ = new WComboBox(elementAt(row, 2));
  countryEdit_->addItem("");
  countryEdit_->addItem("Belgium");
  countryEdit_->addItem("Netherlands");
  countryEdit_->addItem("United Kingdom");
  countryEdit_->addItem("United States");
  label = new WLabel(tr("example.country"), elementAt(row, 0));
  label->setBuddy(countryEdit_);
  countryEdit_->setValidator(new WValidator(true));
  countryEdit_->changed().connect(this, &Form::countryChanged);

  // City
  ++row;
  cityEdit_ = new WComboBox(elementAt(row, 2));
  cityEdit_->addItem(tr("example.choosecountry"));
  label = new WLabel(tr("example.city"), elementAt(row, 0));
  label->setBuddy(cityEdit_);

  // Birth date
  ++row;

  birthDateEdit_ = new WDateEdit(elementAt(row, 2));
  birthDateEdit_->setBottom(WDate(1900, 1, 1));
  birthDateEdit_->setTop(WDate::currentDate());
  label = new WLabel(tr("example.birthdate"), elementAt(row, 0));
  label->setBuddy(birthDateEdit_);
  birthDateEdit_->setFormat("dd/MM/yyyy");
  birthDateEdit_->validator()->setMandatory(true);

  // Child count
  ++row;
  childCountEdit_ = new WLineEdit("0", elementAt(row, 2));
  label = new WLabel(tr("example.childcount"),
                     elementAt(row, 0));
  label->setBuddy(childCountEdit_);
  childCountEdit_->setValidator(new WIntValidator(0,30));
  childCountEdit_->validator()->setMandatory(true);

  ++row;
  remarksEdit_ = new WTextArea(elementAt(row, 2));
  remarksEdit_->setColumns(40);
  remarksEdit_->setRows(5);
  label = new WLabel(tr("example.remarks"),
                     elementAt(row, 0));
  label->setBuddy(remarksEdit_);

  // Submit
  ++row;
  WPushButton *submit = new WPushButton(tr("submit"),
                                        elementAt(row, 0));
  submit->clicked().connect(this, &Form::submit);
  submit->setMargin(15, Top);
  elementAt(row, 0)->setColumnSpan(3);
  elementAt(row, 0)->setContentAlignment(AlignTop | AlignCenter);

  // Set column widths for label and validation icon
  elementAt(2, 0)->resize(WLength(30, WLength::FontEx), WLength::Auto);
  elementAt(2, 1)->resize(20, WLength::Auto);
}

void Form::submit ( )

private

Submit the form.

Definition at line 192 of file Form.C.

{
  if (validate()) {
    // do something useful with the data...
    std::wstring name
      = firstNameEdit_->text() + L" " + nameEdit_->text();

    std::wstring remarks
      = remarksEdit_->text();

    clear();

    new WText(WString::fromUTF8("<p>Thank you, {1}, "
                                "for all this precious data.</p>").arg(name),
              elementAt(0, 0));
    
    if (!remarks.empty())
      new WText("<p>You had some remarks. Splendid !</p>", elementAt(0, 0));

    wApp->quit();
  }
}

bool Form::validate ( )

private

Validate the form, and return whether succesfull.

Definition at line 175 of file Form.C.

{
  feedbackMessages_->clear();
  bool valid = true;

  if (!checkValid(nameEdit_, tr("error.name")))
    valid = false;
  if (!checkValid(countryEdit_, tr("error.country")))
    valid = false;
  if (!checkValid(birthDateEdit_, tr("error.birthdate")))
    valid = false;
  if (!checkValid(childCountEdit_, tr("error.childcount")))
    valid = false;

  return valid;
}

Member Data Documentation

WDateEdit* Form::birthDateEdit_

private

Definition at line 61 of file Form.h.

WLineEdit* Form::childCountEdit_

private

Definition at line 62 of file Form.h.

WComboBox* Form::cityEdit_

private

Definition at line 59 of file Form.h.

WComboBox* Form::countryEdit_

private

Definition at line 58 of file Form.h.

WContainerWidget* Form::feedbackMessages_

private

Definition at line 53 of file Form.h.

WLineEdit* Form::firstNameEdit_

private

Definition at line 56 of file Form.h.

WLineEdit* Form::nameEdit_

private

Definition at line 55 of file Form.h.

WTextArea* Form::remarksEdit_

private

Definition at line 65 of file Form.h.

WLineEdit* Form::weightEdit_

private

Definition at line 63 of file Form.h.

---

The documentation for this class was generated from the following files:

• /build/witty-HtnADi/witty-3.3.3+dfsg/examples/form/Form.h
• /build/witty-HtnADi/witty-3.3.3+dfsg/examples/form/Form.C