Difference between revisions of "TextField"

From GiderosMobile
m (Text replacement - "<source" to "<syntaxhighlight")
m (Text replacement - "</source>" to "</syntaxhighlight>")
Line 15: Line 15:
 
stage:addChild(textfield)
 
stage:addChild(textfield)
 
textfield:setText("some other text") -- change the text
 
textfield:setText("some other text") -- change the text
</source>
+
</syntaxhighlight>
  
 
'''Example 2:''' default font:
 
'''Example 2:''' default font:
Line 22: Line 22:
 
local textfield2 = TextField.new(nil, "some text with default font")
 
local textfield2 = TextField.new(nil, "some text with default font")
 
stage:addChild(textfield2)
 
stage:addChild(textfield2)
</source>
+
</syntaxhighlight>
  
 
'''Example 3:''' TTFont:
 
'''Example 3:''' TTFont:
Line 30: Line 30:
 
text:setPosition(100, 100)
 
text:setPosition(100, 100)
 
stage:addChild(text)
 
stage:addChild(text)
</source>
+
</syntaxhighlight>
  
 
'''Example 4:''' colored text:
 
'''Example 4:''' colored text:
Line 37: Line 37:
 
text:setPosition(32, 64)
 
text:setPosition(32, 64)
 
stage:addChild(text)
 
stage:addChild(text)
</source>
+
</syntaxhighlight>
  
 
=== See also ===
 
=== See also ===

Revision as of 14:33, 13 July 2023

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: Sprite

Description

The TextField class is used to create objects for text display.

Examples

Example 1: bitmap font:

local font = Font.new("myfont.txt", "myfont.png") -- you need to add your bitmap font
local textfield = TextField.new(font, "some text")
stage:addChild(textfield)
textfield:setText("some other text") -- change the text

Example 2: default font:

-- to use the default font, pass nil value for the font parameter
local textfield2 = TextField.new(nil, "some text with default font")
stage:addChild(textfield2)

Example 3: TTFont:

local font = TTFont.new("fonts/Tahoma.ttf", 32, "", true, 1) -- you need to add your .ttf font
local text = TextField.new(font, "This is a text")
text:setPosition(100, 100)
stage:addChild(text)

Example 4: colored text:

local text = TextField.new(nil, "This is a \e[color=#f005]semi transparent red\e[color] text")
text:setPosition(32, 64)
stage:addChild(text)

See also

CompositeFont

Methods

TextField.new creates a new TextField object with the specified font and text
TextField:getLayout retrieves the layout parameters of the Textfield
TextField:getLetterSpacing returns the letter-spacing property which is used to increase or decrease the space between characters in a text
TextField:getLineHeight gets the textfield line height
TextField:getPointFromTextPosition returns the coordinates from a given offset within the text
TextField:getSample gets the string used as sample for determining line height
TextField:getText returns the textfield text
TextField:getTextColor returns the textfield text color in hexadecimal format
TextField:getTextPositionFromPoint returns the offset into a text from x,y coordinates
TextField:setFont sets the textfield font to use
TextField:setLayout changes the textfield layout parameters
TextField:setLetterSpacing sets the letter-spacing property which is used to increase or decrease the space between characters in a text
TextField:setSample sets the sample string used for determining the text line height
TextField:setText sets the textfield text to be displayed
TextField:setTextColor sets the textfield text color in hexadecimal format

Events

Constants