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 37. 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 38. 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 39. 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>
letterspacing, maxlength, maxlines, multiline, pattern, resize, selectable, text, textalign, textdecoration, textindent, xscroll, yscroll
Attributes inherited from <view>
aaactive, aadescription, aaname, aasilent, aatabindex, align, bgcolor, cachebitmap, clickable, clickregion, clip, contextmenu, cursor, fgcolor, focusable, focustrap, font, fontsize, fontstyle, frame, framesloadratio, hassetheight, hassetwidth, height, layout, loadratio, mask, opacity, pixellock, playing, proxyurl, resource, resourceheight, resourcewidth, rotation, showhandcursor, source, stretches, subviews, totalframes, unstretchedheight, unstretchedwidth, 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>
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
Methods inherited from <view>
bringToFront, containsPt, getAttributeRelative, getBounds, getColor, getColorTransform, getContextMenu, getCurrentTime, getDepthList, getID3, getMouse, getNextSelection, getPan, getPrevSelection, getProxyURL, getTotalTime, getVolume, init, 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, getAttribute, getOption, getUID, init, lookupSourceLocator, releaseConstraint, releaseConstraintMethod, searchImmediateSubnodes, searchSubnodes, setData, setDatapath, setOption, setSelected, updateData
Events inherited from <text>
onhscroll, onmaxhscroll, onmaxlength, onmaxscroll, onpattern, onscroll, ontext, ontextlink
Events inherited from <view>
onaddsubview, onblur, onclick, ondblclick, onerror, onfocus, onframe, onframesloadratio, onheight, onkeydown, onkeyup, onlastframe, onload, onloadratio, onmousedown, onmousedragin, onmousedragout, onmouseout, onmouseover, onmouseup, onmouseupoutside, onopacity, onplay, onremovesubview, onstop, ontimeout, onvisible, onwidth, onx, ony