Salesforce

Edit Input Control Properties (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Edit Input Control Properties (Magic xpa 4.x)

Property

Description

Mobile Support

Multi-Line Edit

Specifies whether the Edit control can contain more than one line of text.
When using a Multi-line Edit control on a text-based form, the text can be enlarged to fit the entire text. This control can be enlarged to the size of a page and span multiple pages. Multi-line Edit controls that are over a page length continue on the next page with all of Magic xpa’s header and footer mechanisms.
If the control is in a table, the table cell enlarges to fit the Edit control's size. The title of the table prints on each page. Other controls appear either above or below the Edit control.

Note: When the Multi-line Edit control is not in focus, scrollbars will not be seen.

This property is not available in Web Client tasks.

Android and iOS

Horizontal Scroll

Specifies whether horizontal scrolling is allowed. The options are Yes, No, or Word Wrap (default).

Applies to controls with Multi-line Edit set to True.

If you set the Multi-line Edit property to False, this property will return to the default setting.

This property is not available in Web Client tasks.

Vertical Scroll

Specifies whether vertical scrolling is allowed between the lines of the control.

Applies to controls with Multi-line Edit set to True.

This property is not available in Web Client tasks.

Allow CR in Data

Specifies whether Magic xpa will exit the control when the Selection Table property is set to Yes, or move down one line when the end user presses Enter.

Applies to controls with Multi-line Edit set to True.

This property is not available in Web Client tasks.

Password Edit

Specifies whether the text entered in the control content should be masked by asterisks. If the Multi-line Edit property is set to True, this property is disabled. The options are:

False (default) – Access is not password-protected and, therefore, the text is displayed as entered.

True – Access is password-protected. Asterisks will replace whatever is typed in this field.

You can use an expression to evaluate True/False condition of the edit control’s password property. If the expression is evaluated to be True, you get to see the dots else you get to see the password characters that you had typed. Since version: 3.3

Android and iOS

Auto Wide

Specifies whether to open the expansion window automatically when required, in an Edit control. When you set this property to True, whenever a user is about to step outside the width of the current control or modifies the text in a way that will modify the text outside the boundaries of the control, the expansion window will automatically open. See also Auto Wide.

This property is not available in Web Client tasks.

Must Input

Specifies whether the end user must enter a value into the control.

For Web Client forms, the 'Must Input' property for all controls is renamed as 'Required'. Since version: 4.6

Android and iOS

Modifiable

Specifies whether the end user can change the value in the control during runtime.

See also How Do I Prevent the End User from Modifying the Data in Specific Fields?

For Web Client tasks, if this property is set to false, then the field controls will be displayed as labels.

Android and iOS

Select Program

A program associated with the control, so that in runtime the end user can activate it by performing Zoom. The variable attached to the control is sent automatically to that program.

This is commonly used when the called program is a selection program (defined with Selection Table = Yes), so it is very easy to update the control's variable with an option from a selection list.

When a program is called using the Select Program property of a variable or control, the Parallel Execution property will be ignored and the program will behave as a Modal window (Online – Since version: 2.0).

The Main Program cannot be used as a Select Program.

This property is not available in Web Client tasks.

Select Mode

The behavior of the select program defined in the Select Program property. The options are:

After – After closing the select program, the cursor moves to the next control.

Before (default) – After closing the select program, the cursor returns to the current control.

Prompt – The select program is automatically executed prior to entering the control. After closing the select program, the cursor returns to the current control as in ‘Before’ mode.

This property is not available in Web Client tasks.

Modify in Query

Specifies whether the user can change the value in the control even if the task is in Query mode. Since version: 1.5

If this property is set to False, the control cannot navigate through the Items list in Runtime.

This property is not available in Web Client tasks.

Android and iOS

Reference
Attachment 
Attachment