User Tools

Site Tools


built_in:textedit

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
built_in:textedit [2015/02/15 14:30]
octazid [Options] SingleLine
built_in:textedit [2016/04/30 06:35] (current)
Line 1: Line 1:
 ====== TextEdit control ====== ====== TextEdit control ======
-===== Create ===== + 
-Create TextEdit objects using the CreateTextEdit method of the app object:+//(Information and examples taken from the DroidScript documentation)// 
 + 
 +===== Description ===== 
 +Create TextEdit objects using the **CreateTextEdit** method of the **[[built_in:app|app]]** object:
 <code>edt = app.CreateTextEdit( text, width, height, options );</code> <code>edt = app.CreateTextEdit( text, width, height, options );</code>
-You can use the SetOnChange method of the TextEdit to set the name of a function you want to be called when a the text is changed.+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 ==== 
 +<code javascript> 
 +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() ); 
 +}  
 +</code> 
 +You can change the look of a Text using the **SetBackColor** and **SetTextColor** functions on the Text object. 
 + 
 +==== Example - Blue on White ==== 
 +<code javascript> 
 +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 ); 
 +
 +</code> 
 +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.
  
-Use the SetText and GetText functions to set and get the text in the TextEdit 
 ===== Methods ===== ===== Methods =====
 Some controls use the same methods.\\ Some controls use the same methods.\\
 For examples of the **[[same methods]]** look here. For examples of the **[[same methods]]** look here.
-^Method ^Description ^ +^ Method                                                           ^ Description                                                                         
-|TextEdit.ClearHistory() | | +| TextEdit.ClearHistory()                                                                                                                              
-|TextEdit.Destroy() | | +| TextEdit.Destroy()                                                                                                                                   
-|TextEdit.GetAbsHeight() | | +| TextEdit.GetAbsHeight()                                                                                                                              
-|TextEdit.GetAbsWidth() | | +| TextEdit.GetAbsWidth()                                                                                                                               
-|TextEdit.GetCursorLine() | Returns the line with the Cursor as number| +| TextEdit.GetCursorLine()                                         | Returns the line with the Cursor as number                                          
-|TextEdit.GetCursorPos() | Returns the position of 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.GetHtml()                                               | Returns the Text of a Textedit as Html \\ use this if the contol has a Html option  
-|TextEdit.GetHeight() | | +| TextEdit.GetHeight()                                                                                                                                 
-|TextEdit.GetLineCount() | Returns the count of a line in the Textedit| +| 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.GetLineStart( lineNum )                                 | Returns the position of the start of a line as number                               
-|TextEdit.GetLineTop( lineNum ) | | +| TextEdit.GetLineTop( lineNum )                                                                                                                       
-|TextEdit.GetMaxLines() | Returns the count of all lines| +| TextEdit.GetMaxLines()                                           | Returns the count of all lines                                                      
-|TextEdit.GetPosition() | | +| TextEdit.GetPosition()                                                                                                                               
-|TextEdit.GetSelectedText()| Returns the selected Text| +| TextEdit.GetSelectedText()                                       | Returns the selected Text                                                           
-|TextEdit.GetSelectionEnd()| Returns the endposition of the selected Text as number| +| TextEdit.GetSelectionEnd()                                       | Returns the endposition of the selected Text as number                              
-|TextEdit.GetSelectionStart()| Returns the startposition 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.GetText()                                               | Returns the Text of the Textedit                                                    
-|TextEdit.GetTextSize( mode ) | Returns the Textsize of the Text | +| TextEdit.GetTextSize( mode )                                     | Returns the Textsize of the Text                                                    
-|TextEdit.GetType() | | +| TextEdit.GetType()                                               Returns "TextEdit"                                                                  
-|TextEdit.GetVisibility() | | +| TextEdit.GetVisibility()                                                                                                                             
-|TextEdit.GetWidth() | | +| TextEdit.GetWidth()                                                                                                                                  
-|TextEdit.InsertText( text,start,end ) | | +| TextEdit.InsertText( text,start,end )                                                                                                                
-|TextEdit.Redo() | | +| TextEdit.Redo()                                                                                                                                      
-|TextEdit.Release() | | +| TextEdit.Release()                                                                                                                                   
-|TextEdit.ReplaceText( text,start,end ) | | +| TextEdit.ReplaceText( text,start,end )                                                                                                               
-|TextEdit.SetBackColor( color ) | | +| TextEdit.SetBackColor( color )                                                                                                                       
-|TextEdit.SetBackGradient( color1,color2,color3,p4,p5,p6,p7 ) | | +| TextEdit.SetBackGradient( color1,color2,color3,p4,p5,p6,p7 )                                                                                         
-|TextEdit.SetBackGradientRadial( x,y,r,color1,color2,color3,p7 ) | | +| TextEdit.SetBackGradientRadial( x,y,r,color1,color2,color3,p7 )                                                                                      
-|TextEdit.SetBackground( imagefile,options ) | | +| TextEdit.SetBackground( imagefile,options )                                                                                                          
-|TextEdit.SetCursorPos( number ) | | +| TextEdit.SetCursorPos( number )                                                                                                                      
-|TextEdit.SetHint( text ) | | +| TextEdit.SetHint( text )                                                                                                                             
-|TextEdit.SetHtml( text ) | | +| TextEdit.SetHtml( text )                                                                                                                             
-|TextEdit.SetMargins( left,top,right,bottom ) | | +| TextEdit.SetMargins( left,top,right,bottom )                                                                                                         
-|TextEdit.SetOnChange( callback ) | Starts if the user change the Text in the Textedit | +| TextEdit.SetOnChange( callback )                                 | Starts if the user change the Text in the Textedit                                  | 
-|TextEdit.SetOnTouch( callback )| Starts if the user enter the Textedit | +| TextEdit.SetOnEnter( callback )|As of ver1.34 This disables enter key and fires callback
-|TextEdit.SetPadding( left,top,right,bottom ) | | +| TextEdit.SetOnTouch( callback )                                  | Starts if the user enter the Textedit                                               
-|TextEdit.SetPosition( left,top,width,height ) | | +| TextEdit.SetPadding( left,top,right,bottom )                                                                                                         
-|TextEdit.SetScale( x,y ) | | +| TextEdit.SetPosition( left,top,width,height )                                                                                                        
-|TextEdit.SetSelection( start,stop ) | Select Text \\  start and stop are the positions in the text as number| +| TextEdit.SetScale( x,y )                                                                                                                             
-|TextEdit.SetSize( width,height ) | | +| TextEdit.SetSelection( start,stop )                              | Select Text \\  start and stop are the positions in the text as number              
-|TextEdit.SetText( text ) | | +| TextEdit.SetSize( width,height )                                                                                                                     
-|TextEdit.SetTextColor( color ) | | +| TextEdit.SetText( text )                                                                                                                             
-|TextEdit.SetTextSize( size,mode ) | | +| TextEdit.SetTextColor( color )                                                                                                                       
-|TextEdit.SetVisibility( ShowHide ) | | +| TextEdit.SetTextSize( size,mode )                                                                                                                    
-|TextEdit.Undo() | |+| TextEdit.SetVisibility( ShowHide )                                                                                                                   
 +| TextEdit.Undo()                                                                                                                                      |
  
 ===== Options ===== ===== Options =====
  
-^Option ^Description ^ +^ Option      ^ Description                                                                  
-|AutoSelect|Select all Text if user enter the Textedit| +| AutoSelect  | Select all Text if user enter the Textedit                                   | 
-|Center|Justify the text in the middle| +| AutoSize    | Expand or shrink the control automatically so the text fits in the Textedit 
-|Left|Justify the text to the left| +| Bold        | Write bold text                                                              
-|Monospace|Shows the Text in a Monospace Font| +| Center      | Justify the text in the middle                                               | 
-|NoSpell|Disable the spell-checker| +| Extract     | Allows full-width keyboard in landscape                                      
-|Number|Defaults to the numeric keyboard| +| Left        | Justify the text to the left                                                 
-|NoKeyboard|Shows no Keyboard| +| Monospace   | Shows the Text in a Monospace Font                                           
-|ReadOnly|You cant change the Text| +| NoSpell     | Disable the spell-checker                                                    
-|Right|Justify the text to the right| +| Number      | Defaults to the numeric keyboard                                             
-|SingleLine|Does'nt make a linebreak if \\ text is longer than the control|+| NoKeyboard  | Shows no Keyboard                                                            
 +| ReadOnly    | You cant change the Text                                                     
 +| Right       | Justify the text to the right                                                
 +| SingleLine  Doesn'make a linebreak if \\ text is longer than the control               |
built_in/textedit.1424010650.txt.gz · Last modified: 2015/02/15 22:30 (external edit)