NAME

IWL::Input - input widget

INHERITANCE

IWL::Object -> IWL::Widget -> IWL::Input

DESCRIPTION

The Input widget provides the base for it's offspring widgets, such as the combobox or the text entry.

CONSTRUCTOR

IWL::Input->new ([%ARGS])

Where %ARGS is an optional hash parameter with with key-values corresponding to the attributes that a regular <input> markup would have.

IWL::Input->newMultipleFromHash (NAME => VALUE, ...)

Where NAME => VALUE is a hash of name/values for creating multiple input controls, where the keys are the names, and the values are the values. Returns an array of created inputs.

SIGNALS

change

Fires when the input loses the focus and its value has been modified since gaining focus

select

Fires when a user selects some text in a text field, including input and textarea

focus

Fires when an element receives focus either via the pointing device or by tab navigation

blur

Fires when an element loses focus either via the pointing device or by tabbing navigation

METHODS

setName (NAME)

Sets the name of the input to NAME

Parameter: NAME - the name to use

getName

Gets the name (attribute) of the input element.

setValue (VALUE)

Sets the value of the input to VALUE

Parameter: VALUE - the data to be set as the value

getValue

Gets the value of the input

setDisabled (BOOL)

Sets whether the input will be disabled

Parameters: BOOL - true if the input should be disabled (i.e. will not react to user input)

isDisabled

Returns true if the input is disabled

extractState (STATE)

Update the IWL::Stash(3pm) STATE according to the input state.

applyState (STATE)

Update the input element according to the IWL::Stash(3pm) STATE object. The STATE will get modified, i.e. the "used" element will be shifted from the according slot (name attribute) of the state.

LICENCE AND COPYRIGHT

Copyright (c) 2006-2007 Viktor Kojouharov. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perldoc perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.