This tag creates an area of the canvas that the user can use to
edit text. It is equivalent to the HTML <input
type="text">, <input type="password">,
and textarea tags.
See the documentation for the <text>
tag for a description of the width and height attributes,
and of scrolling.
Single-line input text
With the multiline and
password attributes set to false
(the default), this tag is similar to the HTML <input
type="text"> tag. In this use, long lines of text are
clipped according to the width attribute.
Example 27. Simple inputtext
<canvas height="50">
<inputtext width="150">This text is editable.</inputtext>
</canvas>
Multi-line input text
With the multiline attribute set to
true, this tag is similar to the HTML
<textarea> tag. In this use, text is wrapped to
the length of the width attribute, and the user
can press Enter to create multiple lines of input.
Example 28. Simple inputtext
<canvas height="50">
<inputtext width="150" multiline="true">This text is editable.</inputtext>
</canvas>
Passwords
With password set to true, this
tag is similar to the HTML <input type="password">
tag. Input characters are displayed as the asterisk
('*') character.
Example 29. Password inputtext
<canvas height="20">
<inputtext width="100" password="true">password.</inputtext>
</canvas>
| Name | Type (tag) | Type (js) | Default | Category |
|---|---|---|---|---|
enabled
|
booleanLiteral | Boolean | read/write | |
| If true, the inputtext will be enabled | ||||
password
|
booleanLiteral | Boolean | read/write | |
| If true, the inputtext contents will be obscured | ||||
Attributes inherited from <text>
antiAliasType, gridFit, hscroll, letterspacing, lineheight, maxhscroll, maxlength, maxlines, maxscroll, multiline, pattern, resize, scroll, scrollevents, scrollheight, scrollwidth, selectable, sharpness, text, textalign, textdecoration, textindent, thickness, xscroll, yscroll
Attributes inherited from <view>
aaactive, aadescription, aaname, aasilent, aatabindex, align, backgroundrepeat, bgcolor, cachebitmap, capabilities, clickable, clickregion, clip, context, contextmenu, cornerradius, cursor, fgcolor, focusable, focustrap, font, fontsize, fontstyle, frame, framesloadratio, hassetheight, hassetwidth, height, layout, loadratio, mask, opacity, pixellock, playing, proxyurl, resource, resourceheight, resourcewidth, rotation, shadowangle, shadowblurradius, shadowcolor, shadowdistance, showhandcursor, source, stretches, subviews, tintcolor, totalframes, unstretchedheight, unstretchedwidth, usegetbounds, valign, visibility, visible, width, x, xoffset, y, yoffset
Attributes inherited from <node>
classroot, cloneManager, datapath, defaultplacement, id, ignoreplacement, immediateparent, inited, initstage, name, nodeLevel, options, parent, placement, subnodes
Methods
-
LzInputText() -
-
setEnabled() -
![[Caution]](images/caution.png)
This method is deprecated Use setAttribute('enabled', ...) instead.
-
setHTML() -
Parameter Name Type Description htmlp Boolean If true, the text content is treated as HTML when displayed.
-
updateData() -
Retrieves the contents of the text field for use by a datapath. See
LzDatapath.updateData()for more on this.
Methods inherited from <text>
$lzc$set_clip, addFormat, addText, clearText, escapeText, format, getAntiAliasType, getGridFit, getSelectionPosition, getSelectionSize, getSharpness, getText, getTextHeight, getTextWidth, getThickness, makeTextLink, setAntiAliasType, setGridFit, setHScroll, setMultiline, setResize, setScroll, setSelectable, setSelection, setSharpness, setText, setThickness, setXScroll, setYScroll, updateLineAttribute
Methods inherited from <view>
bringToFront, containsPt, getAttributeRelative, getBounds, getColor, getColorTransform, getContextMenu, getCurrentTime, getDepthList, getDisplayObject, getID3, getMouse, getNextSelection, getPan, getPrevSelection, getProxyURL, getTotalTime, getVolume, init, isBehind, isInFrontOf, isMouseOver, measureHeight, measureWidth, play, proxyurl, releaseLayouts, searchSubviews, seek, sendAAEvent, sendBehind, sendInFrontOf, sendToBack, setAAActive, setAADescription, setAAName, setAASilent, setAATabIndex, setAccessible, setAlign, setAttributeRelative, setBGColor, setClickable, setColor, setColorTransform, setContextMenu, setCursor, setHeight, setLayout, setOpacity, setPan, setPlay, setProxyPolicy, setProxyURL, setResource, setResourceNumber, setRotation, setShowHandCursor, setSource, setValign, setVisibility, setVisible, setVolume, setWidth, setX, setXOffset, setY, setYOffset, shouldYieldFocus, stop, stretchResource, unload, updateResourceSize
Methods inherited from <node>
animate, applyConstraint, applyConstraintMethod, applyData, childOf, completeInstantiation, construct, createChildren, dataBindAttribute, destroy, determinePlacement, getOption, getUID, init, lookupSourceLocator, releaseConstraint, releaseConstraintMethod, searchImmediateSubnodes, searchSubnodes, setData, setDatapath, setOption, setSelected, updateData
Events inherited from <text>
onhscroll, onlineheight, onmaxhscroll, onmaxlength, onmaxscroll, onpattern, onscroll, onscrollevents, onscrollheight, onscrollwidth, onselectable, ontext, ontextlink, onxscroll, onyscroll
Events inherited from <view>
onaddsubview, onbackgroundrepeat, onblur, onclick, onclickable, onclip, oncontext, oncornerradius, ondblclick, onerror, onfocus, onfont, onfontsize, onfontstyle, onframe, onframesloadratio, onheight, onkeydown, onkeyup, onlastframe, onload, onloadratio, onmousedown, onmousedragin, onmousedragout, onmouseout, onmouseover, onmousetrackout, onmousetrackover, onmousetrackup, onmouseup, onmouseupoutside, onopacity, onplay, onremovesubview, onresource, onresourceheight, onresourcewidth, onrotation, onshadowangle, onshadowblurradius, onshadowcolor, onshadowdistance, onstop, ontimeout, ontintcolor, ontotalframes, onunstretchedheight, onunstretchedwidth, onvisibility, onvisible, onwidth, onx, onxoffset, ony, onyoffset