DroidScript Wiki

User Tools

Site Tools

Trace:
built_in:text

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:text [2014/12/05 13:29]
162.252.85.172 [Methods] 		built_in:text [2019/06/22 01:01] (current)
Line 1: Line 1:
 ====== Text control ====== ====== Text control ======
-===== Create ===== 
-Create Text objects using the **CreateText** method of the [[app]] object: 
  
 +//(Information and examples taken from the DroidScript documentation)//
 +
 +===== Description =====
 +Create Text objects using the **CreateText** method of the **[[app]]** object:
 <code>txt = app.CreateText( text, width, height, options );</code> <code>txt = app.CreateText( text, width, height, options );</code>
 You can use the **"Multiline"** option to allow multi-line text and the **"Left"** or **"Right"** options to align the text. The default is single line centered text. You can use the **"Multiline"** option to allow multi-line text and the **"Left"** or **"Right"** options to align the text. The default is single line centered text.
  
-Use the SetText and GetText functions of the Text object to set and get it's text.+Use the **SetText** and **GetText** functions of the Text object to set and get it's text. 
 + 
 +==== Example - Single line ==== 
 +<code javascript> 
 +function OnStart() 
 +{ 
 +  lay = app.CreateLayout( "Linear", "VCenter,FillXY" ); 
 + 
 +  txt = app.CreateText( "Hello" ); 
 +  txt.SetTextSize( 22 ); 
 +  lay.AddChild( txt ); 
 + 
 +  app.AddLayout( lay ); 
 +}  
 +</code> 
 +You can change the look of a Text using the **SetBackColor** and **SetTextColor** functions on the Text object. 
 + 
 +==== Example - Multi line ==== 
 +<code javascript> 
 +function OnStart() 
 +{ 
 +  lay = app.CreateLayout( "Linear", "VCenter,FillXY" ); 
 + 
 +  txt = app.CreateText( "Hello\nWorld", 0.8, 0.2, "Multiline" ); 
 +  txt.SetTextSize( 12 ); 
 +  txt.SetTextColor( "#ff6666ff" ); 
 +  txt.SetBackColor( "#ffffffff" ); 
 +  lay.AddChild( txt ); 
 + 
 +  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. 
 ===== Methods ===== ===== Methods =====
-^Method ^Description ^ +Some controls use the same methods.\\ 
-|Text.Destroy() | | +For examples of the **[[same methods]]** look here. 
-|Text.GetAbsHeight() | | +^ Method                                                       ^ Description                                                                           ^ 
-|Text.GetAbsWidth() | | +| Text.Destroy()                                               |                                                                                       | 
-|Text.GetHeight() | | +| Text.GetAbsHeight()                                          |                                                                                       | 
-|Text.GetLineCount() | | +| Text.GetAbsWidth()                                           |                                                                                       | 
-|Text.GetLineStart( line ) | | +| Text.GetHeight()                                             |                                                                                       | 
-|Text.GetLineTop( line ) | | +| Text.GetLineCount()                                          |                                                                                       | 
-|Text.GetMaxLines() | | +| Text.GetLineStart( line )                                    |                                                                                       | 
-|Text.GetPosition() | | +| Text.GetLineTop( line )                                      |                                                                                       | 
-|Text.GetText() | | +| Text.GetMaxLines()                                           |                                                                                       | 
-|Text.GetTextSize( mode ) | | +| Text.GetPosition()                                           |                                                                                       | 
-|Text.GetType() | | +| Text.GetText()                                               |                                                                                       | 
-|Text.GetVisibility() | | +| Text.GetTextSize( mode )                                     |                                                                                       | 
-|Text.GetWidth() | | +| [[built_in:gettype|Text.GetType()]]                          | Returns "Text"                                                                        | 
-|Text.Release() | | +| Text.GetVisibility()                                         |                                                                                       | 
-|Text.SetBackColor( p1 ) | | +| Text.GetWidth()                                              |                                                                                       | 
-|Text.SetBackGradient( p1,p2,p3,p4,p5,p6,p7 ) | | +| Text.Release()                                               |                                                                                       | 
-|Text.SetBackGradientRadial( p1,p2,p3,p4,p5,p6,p7 ) | | +| Text.SetBackColor( color )                                   |                                                                                       | 
-|Text.SetBackground( p1,p2 ) | | +| Text.SetBackGradient( color1,color2,color3,p4,p5,p6,p7 )     |                                                                                       | 
-|Text.SetEllipsize( mode ) | | +| Text.SetBackGradientRadial( x,y,r,color1,color2,color3,p7 )  |                                                                                       | 
-|Text.SetFontFile( file ) | | +| Text.SetBackground( imagefile,options )                      |                                                                                       | 
-|Text.SetHtml( html ) | | +| Text.SetEllipsize( mode )                                    | Shorten long text with "..."  mode="**Start**","**Middle**", "**End**" or "**marq**"  | 
-|Text.SetMargins( left,top,right,bottom ) | | +| Text.SetFontFile( file )                                     |                                                                                       | 
-|Text.SetOnLongTouch( callback ) | | +| Text.SetHtml( html )                                         |                                                                                       | 
-|Text.SetOnTouch( callback ) | | +| Text.SetMargins( left,top,right,bottom )                     |                                                                                       | 
-|Text.SetOnTouchDown( callback ) | | +| Text.SetOnLongTouch( callback )                              |                                                                                       | 
-|Text.SetOnTouchMove( callback ) | | +| Text.SetOnTouch( callback )                                  |                                                                                       | 
-|Text.SetOnTouchUp( callback ) | | +| Text.SetOnTouchDown( callback )                              |                                                                                       | 
-|Text.SetPadding( p1,p2,p3,p4 ) | | +| Text.SetOnTouchMove( callback )                              |                                                                                       | 
-|Text.SetPosition( p1,p2,p3,p4 ) | | +| Text.SetOnTouchUp( callback )                                |                                                                                       | 
-|Text.SetScale( x,y ) | | +| Text.SetPadding( left,top,right,bottom )                     |                                                                                       | 
-|Text.SetSize( p1,p2 ) | | +| Text.SetPosition( left,top,width,height )                    |                                                                                       | 
-|Text.SetText( text ) | | +| Text.SetScale( x,y )                                         |                                                                                       | 
-|Text.SetTextColor( color ) | | +| Text.SetSize( width,height )                                 |                                                                                       | 
-|Text.SetTextShadow( radius,dx,dy,color ) | | +| Text.SetText( text )                                         |                                                                                       | 
-|Text.SetTextSize( size,mode ) | | +| Text.SetTextColor( color )                                   |                                                                                       | 
-|Text.SetTouchable( touchable ) | | +| Text.SetTextShadow( radius,dx,dy,color )                     |                                                                                       | 
-|Text.SetVisibility( HideShow ) | |+| Text.SetTextSize( size,mode )                                |                                                                                       | 
 +| Text.SetTouchable( touchable )                               |                                                                                       | 
 +| Text.SetVisibility( HideShow )                               |                                                                                       | 
 + 
 +===== Options ===== 
 + 
 +^ Option       ^ Description                                          ^ 
 +| AutoScale    | reduces text size to fit if needed                   | 
 +| Bold         | Write bold Text                                      | 
 +| FontAwesome  | Use this to display Icons \\ from this inbuilt font  | 
 +| Html         |                                                      | 
 +| Left         |                                                      | 
 +| Monospace    | use monospace font                                   | 
 +| Multiline    |                                                      | 
 +| Right        |                                                      | 
 +| NoWrap       |                                                      | 
 +| Log          | Log=='multiline,left,nowrap'                         | 
 + 
built_in/text.1417786195.txt.gz · Last modified: 2014/12/05 21:29 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki