TextBox (QLineEdit)

The Qt documentation in C++ of this class can be read here: http://doc.trolltech.com/4.3/qlineedit.html

A control for the form object, is a one-line text editor.

It allows the user to enter and edit a single line of plain text with a useful collection of editing functions, including undo and redo, cut and paste, and drag and drop.

Most important

Methods	IsValid
Properties	Value , InputMask
Events	OnEvent

Please read the control class overview Control as well.

METHODS

IsValid

Function IsValid () As Boolean

Returns true, if input mask and validation is valid for the current input text.

SelectAll

Sub SelectAll()

not implemented yet:

setDragEnabled isDragEnabled cursorPosition setcursorPosition bool isModified () const void setModified ( bool ) hasSelectedText redoAvailable : const bool selectedText : const QString undoAvailable : const bool void backspace () void cursorBackward ( bool mark, int steps = 1 ) void cursorForward ( bool mark, int steps = 1 ) void cursorWordBackward ( bool mark ) void cursorWordForward ( bool mark ) void del () void deselect () void end ( bool mark ) void home ( bool mark ) void insert ( const QString & newText ) int selectionStart () const void clear () void copy () const void cut () void paste () void redo () void undo ()

PROPERTIES

Alignment

Property Alignment As String (ReadWrite)

How Value should be displayed. Should it be on top inside the boundaries of the control for example?

EchoMode

Property EchoMode As String (ReadWrite)

Normal	Display characters as they are entered. This is the default.
NoEcho	Do not display anything. This may be appropriate for passwords where even the length of the password should be kept secret.
Password	Display asterisks instead of the characters actually entered.
PasswordEchoOnEdit	Display characters as they are entered while editing otherwise display asterisks.

Value

Property Value As String (ReadWrite)

OldValue

Property OldValue As String (ReadOnly)

Text

Property Text As String (ReadWrite)

Same as Value. Provided for easy-use.

InputMask

Property InputMask As String (ReadWrite)

Holds the validation input mask.

Possible characters may be (Qt original documentation)

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 (1-9).
#	ASCII digit or plus/minus sign permitted but not required.
H	Hexadecimal character required. A-F, a-f, 0-9.
h	Hexadecimal character permitted but not required.
B	Binary character required. 0-1.
b	Binary character 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 semicolon and the character used for blanks: the blank characters are always removed from the text after editing. The default blank character is space.

Example

000.000.000.000;_	IP address; blanks are _.
HH:HH:HH:HH:HH:HH;_	MAC address
0000-00-00	ISO Date; blanks are space
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#	License number; blanks are - and all (alphabetic) characters are converted to uppercase.

ReadOnly

Property ReadOnly As Boolean (ReadWrite)

If it is true, the textbox value cannot be changed by the user.

ValidatorDouble

Property ValidatorDouble As Boolean (ReadWrite)

If it is true, the textbox value maybe a double value.

ValidatorInteger

Property ValidatorInteger As Boolean (ReadWrite)

If it is true, the textbox value maybe an integer value.

Maximum

Property Maximum As Integer (ReadWrite)

Defines how many characters may be entered.

Completer

Property Completer As String (ReadWrite)

Containts a list of words to be used to auto-complete text input. Words may be separated by ; or ,

not implemented yet:

ValidatorRegExp

EVENTS

OnEvent

Sub OnEvent()

This event is raised, whenever the user finished editing, which means that Return or Enter key is pressed or the TextBox loses focus. Note that if there is a validator or InputMask set and enter/return is pressed, the Event() will only be raised if the input follows the InputMask and one of the validators.

Example

Sub TextBox0_OnEvent()
  Print "TextBox0 pressed"
End Sub