# Text Box

Capture a text input from a user and pass it through to a script using the click event on a button or link.

You can use a textbox as a single-line input field or as a multi-line field. Use a script to capture the values from this field.

***

{% embed url="<https://www.youtube.com/embed/tmlXJR_DogQ?autoplay=1&rel=0&vq=1080>" %}
*Add a TextBox*
{% endembed %}

***

### Properties

1. **Text**

   This text will be shown in the TextBox when the field loads.
2. **Hint**

   Some placeholder text that will show when the TextBox is empty.
3. **Is Password**

   If you check this checkbox the contents of the TextBox will be masked and not visible to the user, but the value can still be captured in a script.
4. **Read-Only**

   Set to True if you want the control to display as read-only (value can't be changed) on the page.
5. **Validations**

   Validations you can apply to the TextBox.
6. **Visible**

   Set to False if you don't want this control to render on the page and be visible to the user.
7. **Visible Lines**

   Set the height of the TextBox in lines. Password will always be 1, no matter what is set here.

***

### Assigning data to a TextBox

Example:

To display a TextBox containing a specific value retrieved by a SQL query:

1. Use an appropriate [Event](https://docs.stadium.software/features/events), e.g. *Load* (page) or *Click* (button) to which a [*SetValue* ](https://docs.stadium.software/actions/set-value)action can be added.
2. Add a [SetValue](https://docs.stadium.software/actions/set-value) action to assign the field value from the query to the TextBox's *Text* property.

***

### Retrieving data from a TextBox

Properties that can contain data:

* Text

Use an action to capture the values from the control. Go here for more details on how to collect data from controls.