BPC-Components

Home > Products > BPC PowerForms - Silverlight > Knowledge Base > Controls > The TextBox control

The TextBox control

The TextBox control is commonly used to display column data of single-line-of-text or multi-line (Plain Text) columns.
If the TextBox control type is selected inside the control properties window, the "MultiLine" property is available allowing users to display multiple lines of text column data (the control automatically displays a vertical scrollbar and accepts the Enter key during data input)

Value Tab

Any of the available options can be used.
Specifically for the List Query and the Web Service value binding options, the first of the attributes/fields retrieved from either the ListQuery or the WebService is used to provide control data.

More details can be found HERE.

Lookup Details

The TextBox does not provide any Lookup options since it cannot contain lookup data.

 

Extra Configuration

 

ValueChangeMode

Values : TextChange (default) or LostFocus
This option defines if the ValueChanged event will be raised at TextChange or LostFocus

Align

Values : Left (default), Right, Center
Indicates the text alignment of the text inside the TextBox control

EnterRaisesValueChange

Values : Yes, No (default)
This option defines if the 'ENTER' key will raise the ValueChange event.
It can be used to add filter controls for ListDataGrids or WebServiceDataGrids.
For example,

We have an unbound TextBox on the form named c_Filter.
We add a ListDataGrid on the form and we bind the value of the ListDataGrid to a ListQuery.
In the ListQuery properties, we setup the criteria as follows :

Title Contains {c_Filter} , IgnoreBlank = Yes

Inside the properties of our filter TextBox, we set the ValueChangeMode to LostFocus and the EnterRaisesValueChange to Yes.

 

This will have the following effect :

The list query will be executed during form initialization and retrieve the results.

Typing in the filter TextBox and pressing the ENTER key or loosing focus, wil force the ListQuery to execute the query again taking into account the filter text and retrieve the relevant records from the corresponding list.