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 [2014/10/30 18:30]
cokeramirez Added some options
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 TextEd 
 ===== Methods ===== ===== Methods =====
-^Method ^Description ^ +Some controls use the same methods.\\ 
-|edt.ClearHistory| | +For examples of the **[[same methods]]** look here. 
-|edt.GetCursorLine| | +^ Method                                                           ^ Description                                                                         
-|edt.GetCursorPos| | +TextEdit.ClearHistory()                                          |                                                                                     | 
-|edt.GetHeight| | +| TextEdit.Destroy()                                                                                                                                   | 
-|edt.GetLineCount| | +| TextEdit.GetAbsHeight()                                          |                                                                                     | 
-|edt.GetLineStart| | +| TextEdit.GetAbsWidth()                                                                                                                               
-|edt.GetLineTop| | +TextEdit.GetCursorLine()                                         Returns the line with the Cursor as number                                          
-|edt.GetMaxLines| | +TextEdit.GetCursorPos()                                          Returns the position of the Cursor as number                                        
-|edt.GetText| | +TextEdit.GetHtml()                                               | Returns the Text of a Textedit as Html \\ use this if the contol has a Html option 
-|edt.GetVisibility| | +| TextEdit.GetHeight()                                                                                                                                 
-|edt.GetWidth| | +TextEdit.GetLineCount()                                          Returns the count of a line in the Textedit                                         
-|edt.Redo| | +TextEdit.GetLineStart( lineNum )                                 Returns the position of the start of a line as number                               
-|edt.Release| | +TextEdit.GetLineTop( lineNum )                                                                                                                       
-|edt.SetBackColor| | +TextEdit.GetMaxLines()                                           Returns the count of all lines                                                      
-|edt.SetBackGradient| | +TextEdit.GetPosition()                                                                                                                               | 
-|edt.SetBackGradientRadial| | +| TextEdit.GetSelectedText()                                       | Returns the selected Text                                                           | 
-|edt.SetBackground| | +| TextEdit.GetSelectionEnd()                                       | Returns the endposition of the selected Text as number                              | 
-|edt.SetCursorPos| | +| TextEdit.GetSelectionStart()                                     | Returns the startposition of the selected text as number                            | 
-|edt.SetHtml| | +| TextEdit.GetText()                                               | Returns the Text of the Textedit                                                    | 
-|edt.SetMargins| | +| TextEdit.GetTextSize( mode )                                     | Returns the Textsize of the Text                                                    | 
-|edt.SetOnChange| | +| TextEdit.GetType()                                               Returns "TextEdit"                                                                  
-|edt.SetPadding| | +TextEdit.GetVisibility()                                                                                                                             
-|edt.SetPosition| | +TextEdit.GetWidth()                                                                                                                                  
-|edt.SetSize| | +TextEdit.InsertText( text,start,end )                            |                                                                                     | 
-|edt.SetText| | +| TextEdit.Redo()                                                                                                                                      
-|edt.SetTextColor| | +TextEdit.Release()                                                                                                                                   | 
-|edt.SetTextSize| | +| TextEdit.ReplaceText( text,start,end )                                                                                                               
-|edt.SetVisibility| | +TextEdit.SetBackColor( color )                                                                                                                       
-|edt.Undo| |+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 ===== ===== Options =====
  
-^Option ^Description ^ +^ Option      ^ Description                                                                  ^ 
-|Left|Justify the text to the left| +| AutoSelect  | Select all Text if user enter the Textedit                                   | 
-|NoSpell|Disable the spell-checker| +| AutoSize    | Expand or shrink the control automatically so the text fits in the Textedit 
-|Number|Defaults to the numeric keyboard|+| 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               |
built_in/textedit.1414693858.txt.gz · Last modified: 2014/10/31 02:30 (external edit)