#include <Wt/WFormWidget>
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. | |
WLabel * | label () 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. | |
WValidator * | validator () 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. |
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().
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.
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.
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.
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] |
void Wt::WFormWidget::disable | ( | ) | [slot] |
void Wt::WFormWidget::setFocus | ( | ) | [slot] |
Give focus to this widget.
Giving focus to an input element only works when JavaScript is enabled.