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
Next revision Both sides next revision
built_in:textedit [2015/02/15 14:36]
octazid [Create] add SetOnTouch to the text
built_in:textedit [2016/04/29 22:32]
58.96.146.120 [Methods]
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 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.+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.txt · Last modified: 2016/04/30 06:35 (external edit)