Page Comparison

{alias:qlineedit}
h2. Name

*qlineedit* — one line text editor

h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}
*qlineedit* \[ _cmds_ ...]

{panel}

h2. Description

The *qlineedit* command creates a QLineEdit object. This is a one-line entry-field for text where the user may interactively edit the contents. An optional callback string may be assigned that will be called whenever the text is changed interactively by the user. The text itself is appended to the callback string before evaluation. It is the responsibility of the programmer to ensure that the resulting string is a valid Tcl command. 

The contents of the text field may be set using the [qsettext] command. Use [qclear] to clear the field. To retrieve the text use [qtext].
h2. Arguments

_cmds_
{indent} 
One or more commands to be performed when the text changes. The text contained in the QLineEdit is appended before evaluation. The commands must be a string or a list which adheres to Tcl's syntax. For such, a string may be either a single word or several words grouped as one string using quotes. A list is delimited by the '\{' and '}' characters. 

{indent} 

h2. Examples

h3. Ex.1: QLineEdit
{anchor:QLineEdit}

{noformat:|borderWidth=1|bgColor=#eeeeee}
# Callback for lineedit
proc do_something { text } {

}

set w [qwidget ]
qsetwindowtitle QLineEdit
qvboxlayout {
	qlineedit
	qsettext Hello

	# Calls 'do_something' whenever a change takes place
	# The text as appended to the callback expression
	qlineedit do_something

}
qshow $w

{noformat}

!att:_img_cmd^qlineedit.png!

Example +QLineEdit+ shows two QLineEdits, one of which is assigned a callback string. Whenever the text in the textfield is edited, the entire text will be appended to the callback expression, thus forming a valid call to the procedure 'do_something'.