Wt::WFormWidget Class Reference

A widget that correspond to an HTML form element. More...

#include <Wt/WFormWidget>

Inheritance diagram for Wt::WFormWidget:

Inheritance graph
[legend]

List of all members.

Public Slots

void setEnabled (bool enabled)
 Change the enabled state of the widget.
void enable ()
 Enable the widget.
void disable ()
 Disable the widget.
void setFocus ()
 Give focus to this widget.

Public Member Functions

 WFormWidget (WContainerWidget *parent=0)
 Construct a WFormWidget with an optional parent.
 ~WFormWidget ()
 Destroy a WFormWidget.
WLabellabel () const
 Get the label associated with this widget.
void setHidden (bool hidden)
 Set the hidden state of this widget.
bool isEnabled () const
 Return whether the widget is enabled.
void setValidator (WValidator *validator)
 Set a validator for this field.
WValidatorvalidator () const
 Get the validator.
virtual WValidator::State validate ()
 Validate the field.

Public Attributes

EventSignal< void > changed
 Signal emitted when the value was changed.
EventSignal< void > selected
 Signal emitted when ??
EventSignal< void > blurred
 Signal emitted when the widget lost focus.
EventSignal< void > focussed
 Signal emitted when the widget recieved focus.


Detailed Description

A widget that correspond to an HTML form element.

A WFormWidget may receive focus, can be disabled, and can have a label that acts as proxy for getting focus. It provides signals which reflect changes to its value, or changes to its focus.

Form widgets also have built-in support for validation, using setValidator(WValidator *). If the validator provide client-side validation, then an invalid validation state is reflected using the style class "Wt-invalid". On the server-side, you should run the validator using validate().


Constructor & Destructor Documentation

Wt::WFormWidget::~WFormWidget (  ) 

Destroy a WFormWidget.

If a label was associated with the widget, the label is updated as well to indicate the loss of the buddy.


Member Function Documentation

WLabel* Wt::WFormWidget::label (  )  const [inline]

Get the label associated with this widget.

Returns the label (if there is one) that acts as a proxy for this widget.

See also:
WLabel::setBuddy(WFormWidget *)

void Wt::WFormWidget::setHidden ( bool  hidden  )  [virtual]

Set the hidden state of this widget.

If the widget has a label, it hidden or shown together with this widget.

Reimplemented from Wt::WWebWidget.

void Wt::WFormWidget::setValidator ( WValidator validator  ) 

Set a validator for this field.

The validator is used to validate the current input.

If the validator has no parent yet, then ownership is transferred to the form field, and thus the validator will be deleted together with the form field.

The default value is 0.

See also:
validate()

void Wt::WFormWidget::setEnabled ( bool  enabled  )  [slot]

Change the enabled state of the widget.

A widget that is disabled cannot receive focus or user interaction.

void Wt::WFormWidget::enable (  )  [slot]

Enable the widget.

See also:
setEnabled(bool)

void Wt::WFormWidget::disable (  )  [slot]

Disable the widget.

See also:
setEnabled(bool)

void Wt::WFormWidget::setFocus (  )  [slot]

Give focus to this widget.

Giving focus to an input element only works when JavaScript is enabled.


Generated on Fri Jul 25 17:56:38 2008 for Wt by doxygen 1.5.3