edt = app.CreateTextEdit( text, width, height, options );
You can use the **SetOnChange** or the **SetOnTouch** methods of the TextEdit to set the name of a function you want to be called when a the text is changed.
Use the **SetText** and **GetText** functions to set and get the text in the TextEdit.
==== Example - Using OnChange ====
function OnStart()
{
lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
edt = app.CreateTextEdit( "Edit me", 0.8, 0.3 );
edt.SetOnChange( edt_OnChange );
lay.AddChild( edt );
txt = app.CreateText( "", 0.8, 0.3 );
txt.SetMargins( 0, 0.02, 0, 0 );
lay.AddChild( txt );
app.AddLayout( lay );
}
function edt_OnChange()
{
txt.SetText( edt.GetText() );
}
You can change the look of a Text using the **SetBackColor** and **SetTextColor** functions on the Text object.
==== Example - Blue on White ====
function OnStart()
{
lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
edt = app.CreateTextEdit( "Hello", 0.8, 0.4 );
edt.SetTextColor( "#ff6666ff" );
edt.SetBackColor( "#ffffffff" );
lay.AddChild( edt );
app.AddLayout( lay );
}
You can also set a background image/pattern or background gradient for the Text using the **SetBackground** and **SetBackGradient** functions. See **[[built_in:layouts|Layouts]]** for examples of how to use these functions.
===== Methods =====
Some controls use the same methods.\\
For examples of the **[[same methods]]** look here.
^ Method ^ Description ^
| TextEdit.ClearHistory() | |
| TextEdit.Destroy() | |
| TextEdit.GetAbsHeight() | |
| TextEdit.GetAbsWidth() | |
| TextEdit.GetCursorLine() | Returns the line with the Cursor as number |
| TextEdit.GetCursorPos() | Returns the position of the Cursor as number |
| TextEdit.GetHtml() | Returns the Text of a Textedit as Html \\ use this if the contol has a Html option |
| TextEdit.GetHeight() | |
| TextEdit.GetLineCount() | Returns the count of a line in the Textedit |
| TextEdit.GetLineStart( lineNum ) | Returns the position of the start of a line as number |
| TextEdit.GetLineTop( lineNum ) | |
| TextEdit.GetMaxLines() | Returns the count of all lines |
| TextEdit.GetPosition() | |
| TextEdit.GetSelectedText() | Returns the selected Text |
| TextEdit.GetSelectionEnd() | Returns the endposition of the selected Text as number |
| TextEdit.GetSelectionStart() | Returns the startposition of the selected text as number |
| TextEdit.GetText() | Returns the Text of the Textedit |
| TextEdit.GetTextSize( mode ) | Returns the Textsize of the Text |
| TextEdit.GetType() | Returns "TextEdit" |
| TextEdit.GetVisibility() | |
| TextEdit.GetWidth() | |
| TextEdit.InsertText( text,start,end ) | |
| TextEdit.Redo() | |
| TextEdit.Release() | |
| TextEdit.ReplaceText( text,start,end ) | |
| TextEdit.SetBackColor( color ) | |
| TextEdit.SetBackGradient( color1,color2,color3,p4,p5,p6,p7 ) | |
| TextEdit.SetBackGradientRadial( x,y,r,color1,color2,color3,p7 ) | |
| TextEdit.SetBackground( imagefile,options ) | |
| TextEdit.SetCursorPos( number ) | |
| TextEdit.SetHint( text ) | |
| TextEdit.SetHtml( text ) | |
| TextEdit.SetMargins( left,top,right,bottom ) | |
| TextEdit.SetOnChange( callback ) | Starts if the user change the Text in the Textedit |
| TextEdit.SetOnEnter( callback )|As of ver1.34 This disables enter key and fires callback|
| TextEdit.SetOnTouch( callback ) | Starts if the user enter the Textedit |
| TextEdit.SetPadding( left,top,right,bottom ) | |
| TextEdit.SetPosition( left,top,width,height ) | |
| TextEdit.SetScale( x,y ) | |
| TextEdit.SetSelection( start,stop ) | Select Text \\ start and stop are the positions in the text as number |
| TextEdit.SetSize( width,height ) | |
| TextEdit.SetText( text ) | |
| TextEdit.SetTextColor( color ) | |
| TextEdit.SetTextSize( size,mode ) | |
| TextEdit.SetVisibility( ShowHide ) | |
| TextEdit.Undo() | |
===== Options =====
^ Option ^ Description ^
| AutoSelect | Select all Text if user enter the Textedit |
| AutoSize | Expand or shrink the control automatically so the text fits in the Textedit |
| Bold | Write bold text |
| Center | Justify the text in the middle |
| Extract | Allows full-width keyboard in landscape |
| Left | Justify the text to the left |
| Monospace | Shows the Text in a Monospace Font |
| NoSpell | Disable the spell-checker |
| Number | Defaults to the numeric keyboard |
| NoKeyboard | Shows no Keyboard |
| ReadOnly | You cant change the Text |
| Right | Justify the text to the right |
| SingleLine | Doesn't make a linebreak if \\ text is longer than the control |