IWL::Entry - a text entry widget
IWL::Object -> IWL::Widget -> IWL::Input -> IWL::Entry
The entry widget is a single-line, text entry, also capable of showing password-type fields.
IWL::Entry->new ([%ARGS])
Where %ARGS is an optional hash parameter with with key-values.
Set to true if the entry is a password field.
Set to true if the entry is read-only
Set to whatever string should be shown as a default
The maximum number of characters the entry can hold
Since the Entry is a compound object, settings the class and the id will also set the above to the components of the Entry. They will automatically obtain a suffix of "_image1" for the left image, "_image2" for the right image, and "_text" for the text control.
The left icon of the entry
The right icon of the entry
Sets whether the type of the entry is a password type
Parameter: BOOL - a boolean value.
Returns true if the entry is a password type
Sets whether the type of the entry is read-only
Returns true if the entry is a read-only
Sets the text of the entry
Parameter: TEXT - the text.
Returns the text of the entry
Sets the default text of the entry
Returns the default text of the entry
Sets the maximum character length of the entry
Parameter: NUM - a number.
Returns the maximum character length of the entry
Sets the size of the entry field
Returns the size of the entry field
Sets the icon that is shown in the entry
Parameters: SRC - the source of the image, ALT - the alternate text of the image, POSITION - the icon position, either "left", or "right" (default: "left"), CLICKABLE - true if the icon is clickable (sets the cursor)
Returns the set image
Sets the icon that is shown in the entry, from a stock image
Parameters: STOCK_ID - the stock id of the image, POSITION - the icon position, either "left", or "right" (default: "left"), CLICKABLE - true if the icon is clickable (sets the cursor)
A wrapper function that adds a clear button to the end of the entry
Adds auto-completion for the entry
Parameters: URL - the url of the destination script, %OPTIONS - a hash with the following options:
The name of the parameter, which will hold the currently written string
The minimum number of typed character, in order to invoke an ajax call
Id of an element to be shown, during the ajax call
Sets the id of the entry and all of it's parts. Can optionally set the id of the control.
Parameters: ID - the id of the entry, CONTROL_ID - the id of the text control, optional
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.
1 POD Error
The following errors were encountered while parsing the POD:
You forgot a '=back' before '=head1'
To install IWL, copy and paste the appropriate command in to your terminal.
cpanm
cpanm IWL
CPAN shell
perl -MCPAN -e shell install IWL
For more information on module installation, please visit the detailed CPAN module installation guide.