Difference between revisions of "TextField:setLayout"

From GiderosMobile
m (Text replacement - "<source" to "<syntaxhighlight")
Line 15: Line 15:
 
* alignX,alignY: relative alignment of the text inside its cell. Defaults to 0.5,0.5. '''Since 2020.7'''
 
* alignX,alignY: relative alignment of the text inside its cell. Defaults to 0.5,0.5. '''Since 2020.7'''
  
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
TextField:setLayout(layout)
 
TextField:setLayout(layout)
 
</source>
 
</source>
Line 24: Line 24:
 
=== <translate>Example</translate> ===
 
=== <translate>Example</translate> ===
  
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
-- a string variable
 
-- a string variable
 
local mystring = "Some very long text. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor."
 
local mystring = "Some very long text. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor."

Revision as of 15:31, 13 July 2023


Available since: Gideros 2017.10
Class: TextField

Description

Change the layout parameters for this TextField Layout parameters can contain the following fields:

  • w,h: Width/height of the area to layout the text in
  • flags: A or combination of FontBase.TLF_xxx constants instructing how to layout the text
  • letterSpacing: The space to add between each letter of the text
  • lineSpacing: The space to add between each line of the text
  • tabSpace: The size of a tab in space characters increment, default to 4 if unspecified
  • breakChar: A string that will be inserted to indicated broken words
  • alignX,alignY: relative alignment of the text inside its cell. Defaults to 0.5,0.5. Since 2020.7

<syntaxhighlight lang="lua"> TextField:setLayout(layout) </source>

Parameters

layout: (table) Layout parameters

Example

<syntaxhighlight lang="lua"> -- a string variable local mystring = "Some very long text. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor."

-- the text field with default system font local textfield = TextField.new(nil, mystring)

-- we set the string that will be used as sample for determining text line height textfield:setSample(mystring)

-- then we set the layout: width, height, line spacing and justify center textfield:setLayout( {w=200, h=100, lineSpacing=7, flags=FontBase.TLF_CENTER} )

-- finally, we set the text position and add it to stage textfield:setPosition(50, 50) stage:addChild(textfield) </source>