Version: 2022.1
LanguageEnglish
  • C#

TextField

class in UnityEngine.UIElements

/

Inherits from:UIElements.TextInputBaseField_1

/

Implemented in:UnityEngine.UIElementsModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

A textfield is a rectangular area where the user can edit a string.

Static Properties

inputUssClassName USS class name of input elements in elements of this type.
labelUssClassName USS class name of labels in elements of this type.
ussClassName USS class name of elements of this type.

Properties

multiline Set this to true to allow multiple lines in the textfield and false if otherwise.
value The string currently being exposed by the field.

Constructors

TextField Creates a new textfield.

Inherited Members

Static Properties

alignedFieldUssClassName USS class name of elements that are aligned in a inspector element
inputUssClassName USS class name of input elements in elements of this type.
labelDraggerVariantUssClassName USS class name of labels in elements of this type, when there is a dragger attached on them.
labelUssClassName USS class name of labels in elements of this type.
mixedValueLabelUssClassName USS class name of elements that show mixed values
noLabelVariantUssClassName USS class name of elements of this type, when there is no label.
ussClassName USS class name of elements of this type.
inputUssClassName USS class name of input elements in elements of this type.
labelUssClassName USS class name of labels in elements of this type.
multilineInputUssClassName USS class name of multiline input elements in elements of this type.
singleLineInputUssClassName USS class name of single line input elements in elements of this type.
textInputUssName USS class name of input elements in elements of this type.
ussClassName USS class name of elements of this type.
disabledUssClassName USS class name of local disabled elements.

Properties

label The string representing the label that will appear beside the field.
labelElement This is the Label object that appears beside the input for the field.
mixedValueLabel Read-only label used to give the appearance of editing multiple different values.
rawValue The value of the element.
showMixedValue When set to true, gives the field the appearance of editing multiple different values.
value The value associated with the field.
binding Binding object that will be updated.
bindingPath Path of the target property to be bound.
canGrabFocus Return true if the element can be focused.
delegatesFocus Whether the element should delegate the focus to its children.
focusable True if the element can be focused.
focusController Return the focus controller for this element.
tabIndex An integer used to sort focusables in the focus ring. Must be greater than or equal to zero.
cursorColor Color of the cursor.
cursorIndex This is the cursor index in the text presented.
cursorPosition This is the position of the cursor inside the TextInputBaseField_1.
doubleClickSelectsWord Controls whether double clicking selects the word under the mouse pointer or not.
isDelayed If set to true, the value property isn't updated until either the user presses Enter or the text field loses focus.
isPasswordField Returns true if the field is used to edit a password.
isReadOnly Returns true if the field is read only.
maskChar The character used for masking in a password field.
maxLength Maximum number of characters for the field.
selectAllOnFocus Controls whether the element's content is selected upon receiving focus.
selectAllOnMouseUp Controls whether the element's content is selected when you mouse up for the first time.
selectIndex This is the selection index in the text presented.
selectionColor Background color of selected text.
text The value of the input field.
textEdition Retrieves this Field's TextElement ITextEdition
textSelection Retrieves this Field's TextElement ITextSelection
tripleClickSelectsLine Controls whether triple clicking selects the entire line under the mouse pointer or not.
childCount Number of child elements in this object's contentContainer.
contentContainer child elements are added to this element, usually this
contentRect The rectangle of the content area of the element, in the local space of the element.
customStyle Returns the custom style properties accessor for this element.
enabledInHierarchy Returns true if the VisualElement is enabled in its own hierarchy.
enabledSelf Returns true if the VisualElement is enabled locally.
experimental Returns the UIElements experimental interfaces.
generateVisualContent Called when the VisualElement visual contents need to be (re)generated.
hierarchy Access to this element physical hierarchy
layout The position and size of the VisualElement relative to its parent, as computed by the layout system.
localBound AABB after applying the transform to the rect, but before applying the layout translation.
name The name of this VisualElement.
paddingRect The rectangle of the padding area of the element, in the local space of the element.
panel The panel onto which this VisualElement is attached.
parent The parent of this VisualElement.
pickingMode Determines if this element can be pick during mouseEvents or IPanel.Pick queries.
resolvedStyle Returns the VisualElement resolved style values.
schedule Retrieves this VisualElement's IVisualElementScheduler
style Reference to the style object of this element.
styleSheets Returns a VisualElementStyleSheetSet that manipulates style sheets attached to this element.
this[int] Retrieves the child element at a specific index.
tooltip Text to display inside an information box after the user hovers the element for a small amount of time.
transform Returns a transform object for this VisualElement. ITransform
usageHints A combination of hint values that specify high-level intended usage patterns for the VisualElement. This property can only be set when the VisualElement is not yet part of a Panel. Once part of a Panel, this property becomes effectively read-only, and attempts to change it will throw an exception. The specification of proper UsageHints drives the system to make better decisions on how to process or accelerate certain operations based on the anticipated usage pattern. Note that those hints do not affect behavioral or visual results, but only affect the overall performance of the panel and the elements within. It's advised to always consider specifying the proper UsageHints, but keep in mind that some UsageHints might be internally ignored under certain conditions (e.g. due to hardware limitations on the target platform).
userData This property can be used to associate application-specific user data with this VisualElement.
viewDataKey Used for view data persistence (ie. tree expanded states, scroll position, zoom level).
visible Indicates whether or not this element should be rendered.
visualTreeAssetSource Stores the asset reference, if the generated element is cloned from a VisualTreeAsset.
worldBound AABB after applying the world transform to rect.
worldTransform Returns a matrix that cumulates the following operations (in order): -Local Scaling -Local Rotation -Local Translation -Layout Translation -Parent worldTransform (recursive definition - consider identity when there is no parent)

Public Methods

SetValueWithoutNotify Allow to set a value without being notified of the change, if any.
HasBubbleUpHandlers Return true if event handlers for the event propagation BubbleUp phase have been attached on this object.
HasTrickleDownHandlers Returns true if event handlers, for the event propagation TrickleDown phase, are attached to this object.
RegisterCallback Adds an event handler to the instance. If the event handler has already been registered for the same phase (either TrickleDown or BubbleUp) then this method has no effect.
SendEvent Sends an event to the event handler.
UnregisterCallback Remove callback from the instance.
Blur Tell the element to release the focus.
Focus Attempt to give the focus to this element.
MeasureTextSize Computes the size needed to display a text string based on element style values such as font, font-size, and word-wrap.
SelectAll Selects all the text.
SelectNone Remove selection
SelectRange Selects text in the textfield between cursorIndex and selectionIndex.
SetVerticalScrollerVisibility Options for controlling the visibility of the vertical scroll bar in the TextInputBaseField_1.
Add Add an element to this element's contentContainer
AddToClassList Adds a class to the class list of the element in order to assign styles from USS.
BringToFront Brings this element to the end of its parent children list. The element will be visually in front of any overlapping sibling elements.
Children Returns the elements from its contentContainer.
ClassListContains Searches for a class in the class list of this element.
Clear Remove all child elements from this element's contentContainer
ClearClassList Removes all classes from the class list of this element. AddToClassList
Contains Checks if this element is an ancestor of the specified child element.
ContainsPoint Checks if the specified point intersects with this VisualElement's layout.
ElementAt Retrieves the child element at a specific index.
EnableInClassList Enables or disables the class with the given name.
FindAncestorUserData Searches up the hierarchy of this VisualElement and retrieves stored userData, if any is found.
FindCommonAncestor Finds the lowest common ancestor between two VisualElements inside the VisualTree hierarchy.
GetClasses Retrieve the classes for this element.
GetFirstAncestorOfType Walks up the hierarchy, starting from this element's parent, and returns the first VisualElement of this type
GetFirstOfType Walks up the hierarchy, starting from this element, and returns the first VisualElement of this type
IndexOf Retrieves the child index of the specified VisualElement.
Insert Insert an element into this element's contentContainer
MarkDirtyRepaint Triggers a repaint of the VisualElement on the next frame.
PlaceBehind Places this element right before the sibling element in their parent children list. If the element and the sibling position overlap, the element will be visually behind of its sibling.
PlaceInFront Places this element right after the sibling element in their parent children list. If the element and the sibling position overlap, the element will be visually in front of its sibling.
Remove Removes this child from the hierarchy
RemoveAt Remove the child element located at this position from this element's contentContainer
RemoveFromClassList Removes a class from the class list of the element.
RemoveFromHierarchy Removes this element from its parent hierarchy.
SendEvent Sends an event to the event handler.
SendToBack Sends this element to the beginning of its parent children list. The element will be visually behind any overlapping sibling elements.
SetEnabled Changes the VisualElement enabled state. A disabled VisualElement does not receive most events.
Sort Reorders child elements from this VisualElement contentContainer.
ToggleInClassList Toggles between adding and removing the given class name from the class list.

Protected Methods

UpdateMixedValueContent Update the field's visual content depending on showMixedValue.
ExecuteDefaultAction Executes logic after the callbacks registered on the event target have executed, unless the event has been marked to prevent its default behaviour. EventBase{T}.PreventDefault.
ExecuteDefaultActionAtTarget Executes logic after the callbacks registered on the event target have executed, unless the event is marked to prevent its default behaviour. EventBase{T}.PreventDefault.
StringToValue Converts a string to the value of the specified generic type from the subclass.
ValueToString Converts a value of the specified generic type from the subclass to a string representation.

Events

onIsReadOnlyChanged Calls the methods in its invocation list when isReadOnly changes.