lineedit class
Simple line editor for inputting short text
Inherits
object widget
Description
This is a simple, one-line editor usually used for inputting short text like names, phone numbers etc. It can display text in three echo modes (see $setEchoMode() for details).
Functions
<string> $text()
Returns text contained by the widget.
See also $setText().
$setText(<text:string>)
Sets editor text to <text>.
See also $text().
$setEchoMode(<echo_mode:string>)
Sets the line edit's echo mode. Possible value are:

-Normal: display chars as they entered
-Noecho: do not display anything
-Password: display asterisks instead of the characters actually entered
See also $echoMode().
<string> $echoMode()
Return the line edit's echo mode. See also $setEchoMode().
<integer> $maxLength()
Returns the current maximum length of the text that can be typed in the editor.
See also $setMaxLength().
$setMaxLength(<max_lenght:integer>)
Sets maximum length of the text that can be typed in the editor.
See also $maxLength().
<boolean> $frame()
Returns '1' if the editor is drawn inside a frame, which is 2 pixels wide, '0' otherwise.
See also $setFrame().
$setFrame(<bframe:boolean>)
Sets editor frame drawing to <bool>.
See also $frame().
<integer> $cursorPosition()
Returns current cursor position in the editor.
See also $setCursorPosition().
$setCursorPosition(<index:integer>)
Moves the cursor to place pointed by <index>.
See also $cursorPosition().
$selectAll()
Selects whole text inside the editor.
See also $setSelection(), $cut(), $copy(), $paste().
$setSelection(<start:integer>, <length:integer>)
Selects <length> characters in the editor starting at position <start>.
See also $selectAll(), $cut(), $copy(), $paste().
$copy()
Copies selected text in the editor to the clipboard.
See also $setSelection(), $cut(), $paste().
$cut()
Cuts selected text from the editor to the clipboard.
See also $setSelection(), $copy(), $paste().
$paste()
Pastes text from the clipboard into the editor. The pasted text will start at cursor position.
See also $setSelection(), $copy(), $cut().
$clear()
Deletes all text from the editor. Equal to calling $setText("").
$setDragEnabled(<bEnabled:bool>)
With this property user can drag text in the lineedit.
$setReadOnly(<bReadonly:boolean>)
Sets the lineedit to read-only mode.
$setInputMask(<mask:string>)
Sets the validation input mask to inputMask.
Example:

%ledit_example->$setInputMask( "+99 99 99 99 99;_" );

%ledit_example->$setInputMask( "000.000.000.000;_" );

%ledit_example->IP Number Mask.

%ledit_example->setInputMask( ">AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#" );
The mask format understands these mask characters:

Character Meaning

A - ASCII alphabetic character required. A-Z, a-z.

a - ASCII alphabetic character permitted but not required.

N - ASCII alphanumeric character required. A-Z, a-z, 0-9.

n - ASCII alphanumeric character permitted but not required.

X - Any character required.

x - Any character permitted but not required.

9 - ASCII digit required. 0-9.

0 - ASCII digit permitted but not required.

D - ASCII digit required. 1-9.

d - ASCII digit permitted but not required.

# - ASCII digit or plus/minus sign permitted but not required.

> - All following alphabetic characters are uppercased.

< - All following alphabetic characters are lowercased.

! - Switch off case conversion.

\ - Use \ to escape the special characters listed above to use them as separators.
The mask consists of a string of mask characters and separators, optionally
followed by a semi-colon and the character used for blanks: the blank characters
are always removed from the text after editing. The default blank character is space.
$returnPressedEvent()
This function is called by the framework when the enter key is pressed.
$lostFocusEvent()
Called when the lineedit lost focus.
$textChangedEvent(<new text:string>)
This event is called when the text changed, In $0 there is the new text.
$setCompleter(<completion_mode:string>,<completion_list:array>)
Provides completions based on an array. Valid completion_mode are: PopupCompletion: Current completions are displayed in a popup below the lineedit. UnfilteredPopupCompletion: All possible completions are displayed in a popup window with the most likely suggestion selected. InlineCompletion: Completions appear as selected text.
$disableCompleter()
Disable temporally the completer.
$enableCompleter()
Enable the completer.
$removeCompleter()
Remove the completer.
Signals
$returnPressed()
This signal is emitted by the default implementation of $returnPressedEvent().
$lostFocus()
This signal is emitted by the default implementation of $lostFocusEvent().
$textChanged()
This signal is emitted by the default implementation of $textChangedEvent().

Index, Object Classes