Before any text has been entered, the TextField can display some placeholder text.
An alternative placeholder can be displayed when the TextField has keyboard focus.
-For example a TextField used to enter a username could initially show "Unknown Name", and then show "Enter Name." when the cursor is shown.
+For example a TextField used to enter a user name could initially show "Unknown Name", and then show "Enter Name." when the cursor is shown.
+
+Note *CR+LF* new line characters are replaced by a *LF* one.
~~~{.cpp}
// C++
### Font Selection
-TextField will automatically select a suitable fonts, in the same was as TextLabel.
-The preferred font can also be selected from a JSON stylesheet:
-
-~~~{.json}
-{
- "styles":
- {
- "textfield":
- {
- "font-family":"Arial",
- "font-style":"Regular",
- "point-size":8
- }
- }
-}
-~~~
+By default TextField will automatically select a suitable font from the platform. However, a different font could be selected. See the [Font Selection](@ref font-selection) section for more details.
+
+### Mark-up Style
+
+Mark-up tags can be used to change the style of the text. See the [Mark-up Style](@ref markup-style) section for more details.
+
+### Input Style
+
+The input style can be changed through the control properties. See the [Input Style](@ref input-style) section for more details.
### Text Alignment
field.HorizontalAlignment = "BEGIN"; // "CENTER" or "END"
~~~
+### Copy and Paste (Selection)
+
+Text can be selected by a long press or double tapping it. See the [Copy and Paste](@ref copy-n-paste) section for more details.
+
### TextField Decorations
#### Color
horizontalAlignment | HORIZONTAL_ALIGNMENT | STRING | O | X
verticalAlignment | VERTICAL_ALIGNMENT | STRING | O | X
textColor | TEXT_COLOR | VECTOR4 | O | X
- shadowOffset | SHADOW_OFFSET | VECTOR2 | O | X
- shadowColor | SHADOW_COLOR | VECTOR4 | O | X
+ placeholderTextColor | PLACEHOLDER_TEXT_COLOR | VECTOR4 | O | X
primaryCursorColor | PRIMARY_CURSOR_COLOR | VECTOR4 | O | X
secondaryCursorColor | SECONDARY_CURSOR_COLOR | VECTOR4 | O | X
enableCursorBlink | ENABLE_CURSOR_BLINK | BOOLEAN | O | X
cursorBlinkInterval | CURSOR_BLINK_INTERVAL | FLOAT | O | X
cursorBlinkDuration | CURSOR_BLINK_DURATION | FLOAT | O | X
+ cursorWidth | CURSOR_WIDTH | INTEGER | O | X
grabHandleImage | GRAB_HANDLE_IMAGE | STRING | O | X
grabHandlePressedImage | GRAB_HANDLE_PRESSED_IMAGE | STRING | O | X
scrollThreshold | SCROLL_THRESHOLD | FLOAT | O | X
- scrollSpreed | SCROLL_SPEED | FLOAT | O | X
+ scrollSpeed | SCROLL_SPEED | FLOAT | O | X
selectionHandleImageLeft | SELECTION_HANDLE_IMAGE_LEFT | STRING | O | X
selectionHandleImageRight | SELECTION_HANDLE_IMAGE_RIGHT | STRING | O | X
selectionHandlePressedImageLeft | SELECTION_HANDLE_PRESSED_IMAGE_LEFT | STRING | O | X
selectionHandlePressedImageRight | SELECTION_HANDLE_PRESSED_IMAGE_RIGHT | STRING | O | X
+ selectionHandleMarkerImageLeft | SELECTION_HANDLE_MARKER_IMAGE_LEFT | MAP | O | X
+ selectionHandleMarkerImageRight | SELECTION_HANDLE_MARKER_IMAGE_RIGHT | MAP | O | X
selectionHighlightColor | SELECTION_HIGHLIGHT_COLOR | VECTOR4 | O | X
decorationBoundingBox | DECORATION_BOUNDING_BOX | RECTANGLE | O | X
inputMethodSettings | INPUT_METHOD_SETTINGS | MAP | O | X
+ inputColor | INPUT_COLOR | VECTOR4 | O | X
+ enableMarkup | ENABLE_MARKUP | BOOLEAN | O | X
+ inputFontFamily | INPUT_FONT_FAMILY | STRING | O | X
+ inputFontStyle | INPUT_FONT_STYLE | STRING | O | X
+ inputPointSize | INPUT_POINT_SIZE | FLOAT | O | X
+ underline | UNDERLINE | STRING | O | X
+ inputUnderline | INPUT_UNDERLINE | STRING | O | X
+ shadow | SHADOW | STRING | O | X
+ inputShadow | INPUT_SHADOW | STRING | O | X
+ emboss | EMBOSS | STRING | O | X
+ inputEmboss | INPUT_EMBOSS | STRING | O | X
+ outline | OUTLINE | STRING | O | X
+ inputOutline | INPUT_OUTLINE | STRING | O | X
@class TextField