Difference between revisions of "TextField"
(removed language stuff) |
|||
(2 intermediate revisions by one other user not shown) | |||
Line 10: | Line 10: | ||
=== Examples === | === Examples === | ||
'''Example 1:''' bitmap font: | '''Example 1:''' bitmap font: | ||
− | < | + | <syntaxhighlight lang="lua"> |
local font = Font.new("myfont.txt", "myfont.png") -- you need to add your bitmap font | local font = Font.new("myfont.txt", "myfont.png") -- you need to add your bitmap font | ||
local textfield = TextField.new(font, "some text") | local textfield = TextField.new(font, "some text") | ||
stage:addChild(textfield) | stage:addChild(textfield) | ||
textfield:setText("some other text") -- change the text | textfield:setText("some other text") -- change the text | ||
− | </ | + | </syntaxhighlight> |
'''Example 2:''' default font: | '''Example 2:''' default font: | ||
− | < | + | <syntaxhighlight lang="lua"> |
-- to use the default font, pass nil value for the font parameter | -- to use the default font, pass nil value for the font parameter | ||
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) | ||
− | </ | + | </syntaxhighlight> |
'''Example 3:''' TTFont: | '''Example 3:''' TTFont: | ||
− | < | + | <syntaxhighlight lang="lua"> |
local font = TTFont.new("fonts/Tahoma.ttf", 32, "", true, 1) -- you need to add your .ttf font | 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") | local text = TextField.new(font, "This is a text") | ||
text:setPosition(100, 100) | text:setPosition(100, 100) | ||
stage:addChild(text) | stage:addChild(text) | ||
− | </ | + | </syntaxhighlight> |
'''Example 4:''' colored text: | '''Example 4:''' colored text: | ||
− | < | + | <syntaxhighlight lang="lua"> |
local text = TextField.new(nil, "This is a \e[color=#f005]semi transparent red\e[color] text") | local text = TextField.new(nil, "This is a \e[color=#f005]semi transparent red\e[color] text") | ||
text:setPosition(32, 64) | text:setPosition(32, 64) | ||
stage:addChild(text) | stage:addChild(text) | ||
− | </ | + | </syntaxhighlight> |
+ | |||
+ | '''Example 5:''' additional text formatting (since Gideros 2024.2): | ||
+ | <syntaxhighlight lang="lua"> | ||
+ | local font = TTFont.new("DejaVuSans.ttf", 20, "", nil, nil) | ||
+ | --For l,s and u, the thickness is a fraction of the text line height. | ||
+ | local tf = TextField.new(font, "Text in \e[u=0.2]Underline\e[!u] Text in \e[i=15]Oblique 15°\e[!i] Custom \e[l=0.3:0.2]line placement and \e[color=#f00]thickness\e[color]\e[!l]") | ||
+ | tf:setLayout{w = 400, h = 100, flags = 1280|FontBase.TLF_CENTER|FontBase.TLF_VCENTER} | ||
+ | tf:setPosition(0,40) | ||
+ | stage:addChild(tf) | ||
+ | </syntaxhighlight> | ||
=== See also === | === See also === |
Revision as of 18:31, 20 February 2024
Supported platforms:
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)
Example 5: additional text formatting (since Gideros 2024.2):
local font = TTFont.new("DejaVuSans.ttf", 20, "", nil, nil)
--For l,s and u, the thickness is a fraction of the text line height.
local tf = TextField.new(font, "Text in \e[u=0.2]Underline\e[!u] Text in \e[i=15]Oblique 15°\e[!i] Custom \e[l=0.3:0.2]line placement and \e[color=#f00]thickness\e[color]\e[!l]")
tf:setLayout{w = 400, h = 100, flags = 1280|FontBase.TLF_CENTER|FontBase.TLF_VCENTER}
tf:setPosition(0,40)
stage:addChild(tf)
See also
MethodsTextField.new creates a new TextField object with the specified font and text |
EventsConstants |