Text box¶

BrowseName: TextBox
SuperType: Element (Item)
TypeView path: Tipi > UI > Controlli base > Casella di testo

Insert and view a text at runtime.

How It Appears

Applications

Typically used to compose forms that can be filled in by the user (for example to enter his credentials), or more generally to enter texts/values useful for other project logics.

Properties¶

Name	BrowseName	DataType	Description
Text	Text	LocalizedText	Text inserted and displayed
Text horizontal alignment	TextHorizontalAlignment	TextHorizontalAlignment	Indicates where the text is positioned on the horizontal axis
Text vertical alignment	TextVerticalAlignment	TextVerticalAlignment	Indicates where the text is positioned on the vertical axis
Value change behavior	ValueChangeBehaviour	ValueChangeBehaviour	Mode of updating text when the user writes in the text box. At end of typing = update the value after the user has pressed ENTER with either physical or virtual keyboard (pressing the ESC key or clicking outside the object, the previous text is restored); When typing = in real-time when writing.
Font family	FontFamily	Font	Font family
Font weight	FontWeight	FontWeightEnum	Font weight
Font italic	FontItalic	Boolean	Enables/disables italics in the text
Font size	FontSize	Size	Font size
Text color	TextColor	Color	Color of the text to display
Border color	BorderColor	Color	Color of the polygon border
Placeholder text	PlaceholderText	LocalizedText	Text to display when the box is empty, typically an example or indication for the user
Control in read-only mode	ReadOnly	Boolean	Enables/disables the read-only mode. If enabled, it is not possible to write in the text box but, for example, it is possible to select the existing text for copy-paste.
Content Type	ContentType	InputTypeEnum	Content type. Normal = characters displayed; Password = characters hidden.
Visible	Visible	Boolean	Show/hide the window. (Inherited from Element)
Enabled	Enabled	Boolean	Enables/disables the interaction with the user (True = enabled; False = disabled). (Inherited from Element)
Opacity	Opacity	Float	Opacity level (0 = transparent) (Inherited from Element)
Left margin	LeftMargin	Size	(Only if Horizontal Alignment = Left or Center or Stretch) Distance between the left edge of the object and the left edge of its container. (Inherited from Element)
Top margin	TopMargin	Size	(Only if Vertical Alignment = Top or Center or Stretch) Distance between the top edge of the object and the top edge of its container. (Inherited from Element)
Right margin	RightMargin	Size	(Only if Horizontal Alignment = Right or Center or Stretch) Distance between the right edge of the object and the right edge of its container. (Inherited from Element)
Bottom margin	BottomMargin	Size	(Only if Vertical Alignment = Bottom or Center or Stretch) Distance between the bottom edge of the object and the bottom edge of its container. (Inherited from Element)
Width	Width	Size	Width of the window. It can assume values greater than or equal to zero. The Auto value sets the width equal to the width of the content (in this case, in the absence of content the object collapses). (Inherited from Element)
Height	Height	Size	Height of the window. It can assume values greater than or equal to zero. The Auto value sets the height equal to the height of the content (in this case, in the absence of content the object collapses). (Inherited from Element)
Horizontal alignment	HorizontalAlignment	HorizontalAlignment	Alignment of the object on the horizontal axis. Left = the left side is positioned on the left side of the container, except for the left margin; Right = the right side is positioned on the right side of the container, except for the right margin; Center = the center of the object is positioned in the center of the container, except for the left and/or right margins; Stretch = object width equals container width, except for the left and/or right margins. (Inherited from Element)
Vertical alignment	VerticalAlignment	VerticalAlignment	Alignment of the object on the vertical axis. Top = the top side is positioned on the top side of the container, except for the top margin; Bottom = the bottom side is positioned on the bottom side of the container, except for the bottom margin; Center = the center of the object is positioned in the center of the container, except for the top and/or bottom margins; Stretch = object height equals container height, except for the top and/or bottom margins. (Inherited from Element)
Rotation	Rotation	Size	Rotation of the object around its center point. Positive values indicate clockwise arc degrees. (Inherited from Element)

Events¶

Modified text¶

BrowseName: UserTextChanged