---
description: >-
  This Gebra Suite control is similar to textbox control. Thedifference is that
  it is resize able multiline text box.
---

# MultilineTextBox

It does not provides any formatting features. In Gebra Suite, if you need formatting then you should use [WysiwygText](wysiwygtext)(What you see is what you get).

## Documentation

In Gebra Suite, app configuration allows you to add different controls in your app. It also provides four types of properties which manages how control should behave or look in app. Those four property types are:

1. General Properties
2. Size
3. Style
4. Translation

There is an additional property type for multilinetextbox. They are related to maximum and minimum height a multilinetextbox can adapt to.

1. Multiple Line Text Input Properties

## General Properties

***

These are the main properties of any control. These properties define how control behaves in Gebra Suite App.

* Control Type

\- For using grid control, click on "Add Control" and select "mulitLineTextBox" control type from drop down list.

* Control Id

\- For each Gebra Suite app, this id should be unique. For Example: "\_abcdef". Gebra Suite allows you to change its value only once. You can change this id to any value but it should be meaningful. Recommended way is to start with mandatory prefix(set in app). It can contain numbers, underscores, uppercase and lowercase letters.

* Label

\- It is the display value for control. It should be meaningful.

* Data

\- This property specifies from where this control gets data. To set it, specify the controlId of data source. By default "Not in Database" option is selected.

* Refers to Config

\- You need to set this option if this is a field, that other fields refer to, to get data from another config.

* Default value

\- This value is set when an application is opened or a new record is created.

## Multiple Line Text Input Properties

***

* Minimum height

\- It is a drop down list. It is selected in the form of lines. Its value ranges from 2 to 15 lines or no minimum height.

* Maximum height.

\- It is a drop down list. It is selected in the form of lines. Its value ranges from 2 to 15 lines or no maximum height.

* Initially adjust height to content

\- If its value is checked then whatever the height of initial data present will also become the height of Multi line text input.

## Tutorial

In this tutorial, we will see how to use multilineTextBox control. For this tutorial, we will be using item app. Our app has 5 controls: [item id(numbox)](numbox), [| item name(text box)](textbox), [sale price(numbox)](numbox), [quantity(numbox)](numbox), and [quantity unit type(combobox)](combobox). These five controls are placed in three different groupbox controls: item details, Quantity Details, and Sales Details. If you want to dig deeper in this app. Please go through [group box documentation](groupbox). Our app at start looks like this:

Now we want to add item description in our app. This description can be very long so we do not want to use text box. For this purpose, we will use multilinetextinput. In the above snapshot, user can also notice that all other controls are in groupbox containers so lets also add a new groupbox control named "Item Description" and add a new multilinetextinput control and place it inside item description groupbox control.

Here you can see multi line text input control. Interesting thing is you can change size of this control both in editor mode and in app mode. If you check "Initially adjust height to content" property then whenever this app gets initialized and data is being loaded from a data source, it will take the height of the text present in it.
