# Multi-Line Control

Multi-Line Properties |

When creating or editing a Multi-Line control, the Multi Line Properties dialogue (pictured below using the Folder Style version of the NOMADS designer) is displayed:

Dynamic Control Properties

PxPlus 2018 introduces the capability to create dynamic control properties for Multi-Line controls when combined with Data Classes. Dynamic data classes are created by selecting the Dynamic check box in Data Class Definitions maintenance. At run time, dynamic control properties are evaluated and automatically populated with values based on what is defined in the data class.

When a data class is entered for the Multi-Line control, information from the data class is loaded into the Multi-Line properties. If the data class is dynamic, the dynamic control properties are automatically set to Dynamic initially and assigned a %NOMADS'class' variable that corresponds to a data class field (i.e. %NOMADS'class'length).

Multi-Line control properties designated as dynamic can be manually switched to dynamic or non-dynamic. A Multi-Line control can have a combination of dynamic and non-dynamic control properties only when a data class is entered.

See Dynamic Control Properties for information and examples.

#### Note:
Dynamic control properties are supported in NOMADS and iNomads environments.

Multi-Line Properties

This dialogue is divided into the following tabbed panels for viewing and/or changing Multi-Line properties: Display, Font/Color, Attributes, Logic, User Aids, Validation and Query.

Name | Unique name of the Multi-Line control (NOMADS provides a default). Naming conventions for variables apply. Click the Browse Library button to copy parameters from an existing object (via the Library Browse dialogue). #### Note: When a new control name is entered, it will be checked against the Reserved Words list to determine if it is restricted for use as a NOMADS control name. If it is found, a warning message will display. (User Reserved Words Maintenance was added in PxPlus 2020.) If using Property Sheets, click the Control Name button to launch the Multi-Line Browse Options dialogue. With the Library Browse option already selected, click OK. (The Multi-Line Browse Options dialogue was added to Property Sheets in PxPlus 2019.) Extended Class Validation If creating a display-only Multi-Line control for an Extended Class Validation data element, the Multi-Line Name must have the following format: SHOW.name.element Where:
| SHOW | Syntax used with Extended Class Validation when naming Multi-Line controls created from data elements during panel design
| name | Name of the Multi-Line control defined with an Extended Validation data class (on the current panel)
| element | Name of the data element in the table (applies only if the Extended Validation Populate All Fields check box is On)
Example: SHOW.SALES.DEPARTMENT (where DEPARTMENT is the name of the element in the data dictionary) #### Note: When Multi-Line controls for Extended Class Validation are created, the following attributes (on Attributes tab) are set to On: Locked, Borderless and Transparent. The Tab Stop attribute is set to Off. The Numeric attribute is set according to the data dictionary, and if Numeric is On, the Input Format (on Display tab) is set according to the data dictionary. (Extended Validation was added in PxPlus 2019.)
(Browse Extended Class Variables) | (Available when Data Class is blank) Click this button to launch Extended Class Browse if creating a display-only Multi-Line control for an Extended Class Validation data element. If using Property Sheets, click the Control Name button to launch the Multi-Line Browse Options dialogue and select the Browse Extended Class Validation Variables option. If a Data Class is entered, this button is not available. (The Multi-Line Browse Options dialogue was added to Property Sheets in PxPlus 2019.) #### Note: To use Extended Class Browse, a Multi-Line control with an Extended Validation data class must exist on the current panel; otherwise, a message will display and Extended Class Browse will not be available. At any time, a panel can have multiple Multi-Line controls with an Extended Validation data class entered. (The Browse Extended Class Variables button was added in PxPlus 2019.)
Class | #### Note: The Class field is disabled when the Multi-Line Name starts with SHOW.xxxxxx (which indicates a display-only control for Extended Class Validation). (Disabling the Class field for SHOW.xxxxxx Multi-Lines was added in PxPlus 2020.) Enter a Data Class to load the information from the data class definition into the control's properties. If using Property Sheets, click the Data Class button and enter a data class in the Data Class Options dialogue. (The Data Class Options dialogue was added in PxPlus 2018.) To enter a data class, use any of the following methods: Click the Query button (binoculars) to select from a list of predefined data classes (if any) for the current control type. Type the name of an existing data class. Only data classes for the current control type are allowed. Create a data class on the fly. Enter a new Class name and respond Yes to the displayed message, which launches Data Class Definitions. If the data class is changed, a message will display prior to overwriting any information. This works similar to using the Reapply Data Class button. If the data class assigned to the control has been deleted in Data Class Definitions, the text ** Class not on File ** will display (will be a message box if using Property Sheets). (Dynamic data classes and properties were added in PxPlus 2018.)
(Data Class Maintenance) | Click this button to launch Data Class Definitions for creating or editing a data class. If using Property Sheets, click the Data Class button, then click the Data Class Maintenance button in the Data Class Options dialogue. (The Data Class Options dialogue was added in PxPlus 2018.) (The Data Class Maintenance button was added in PxPlus 2018.)
(Reapply Data Class) | (Available when a data Class is entered) Click this button to update control properties with current information from the selected data class. A message displays before any control properties are overwritten. If using Property Sheets, click the Data Class button and select the Reapply Class check box in the Data Class Options dialogue. (The Data Class Options dialogue was added in PxPlus 2018.) #### Important Note: Care should be taken when using the Reapply Data Class button or changing the data Class entered for the control, as this will overwrite any existing values. If the Dynamic (from Data Class) check box was manually changed on the User Aids, Validation and/or Query tabs, clicking the Reapply Data Class button will reselect this check box if the data class entered for the control is dynamic or deselect it if not dynamic. (The Reapply Data Class button was added in PxPlus 2018.)
Dynamic Class | (Display Only) Indicates whether the selected data Class is Dynamic. See Dynamic Control Properties. If using Property Sheets, click the Data Class button to display the Dynamic Class check box in the Data Class Options dialogue. (The Data Class Options dialogue was added in PxPlus 2018.) (The Dynamic Class check box was added in PxPlus 2018.)
Preview | Displays how the visible properties of the control will appear at run time.
Display ( * indicates a Dynamic property)
*Initial Value | Value to be loaded when the Multi-Line is drawn. Can be a Fixed value, string Expression, Message Library Reference or Dynamic. (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.)
*Input Length | Maximum input characters. Can be a Fixed value, numeric Expression or Dynamic. (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.)
*Empty Value | Text to display if null input (Fixed, Expression or Dynamic). (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.) (Support for Empty Value to be an expression was added in PxPlus 2018.)
Implied Decimal Point | Determines implied decimal support for numeric Multi-Lines. Click the drop-down arrow for a list of selections:
Default | NOMADS will use the PxPlus setting of the '+I' or '-I' mnemonic.
Never | Disable implied decimals.
Always | Enable implied decimals.
*Input Format | Format mask for Multi-Line. Can be Fixed, string Expression or Dynamic. (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties.
Separator | Delimiter character. (Default is <Std>.)
#### Note: When defining a Multi-Line with a Height greater than 1, it is strongly advised to use a different Separator character, rather than the <Std> default, as the <Std> default can also be translated as a field separator when the user presses Enter to add another line during data entry. (Dynamic data classes and properties were added in PxPlus 2018.)
Position |
Column | Starting column for the top left corner of the control - numeric expression. Format mask is ##0.00. Valid entries are 0 to 620.
Line | Starting line for the top left corner of the control - numeric expression. Format mask is ##0.00. Valid entries are 0 to 255.
(Support for increased Column and Line maximums was added in PxPlus 2021.)
Size |
Width | Width of the control in number of columns - numeric expression. Format mask is ##0.00. Valid entries are 0 to 620.
Height | Height of the control in number of lines - numeric expression. Format mask is ##0.00. Valid entries are 0 to 255. If a query is associated with the Multi-Line (on Query tab), the Multi-Line Height must be set to 1 so that the query button will be drawn. If the Height is greater than 1, NOMADS will not draw the query button and will display a message when you save the Multi-Line. (If using Property Sheets, this message will only display in the Assign Query window (Query property) when a query is assigned and the OK button is selected.) If responding Yes, NOMADS will first change the Multi-Line Height to 1 and then save the Multi-Line. If responding No, NOMADS will not change the Multi-Line Height prior to saving the Multi-Line. (The message for the Multi-Line height was added in PxPlus 2020.)
For Multi-Line sizing, see the 'MF' parameter and the MULTI_LINE directive. #### Note: If a data class is entered and the Multi-Line Width/Height values in the data class are subsequently changed, the size of the Multi-Line will not change when the Reapply Data Class button is selected. (This functionality was added in PxPlus 2021.) (Support for increased Width and Height maximums was added in PxPlus 2021.)
Attributes | Optional attributes for Tab Stop, Numeric, Initially Disabled and Initially Hidden. See Attributes.
Font/Color ( * indicates a Dynamic property)
Font Specification |
Font Size | Click the drop-down arrow for a list of selections.
Color |
Foreground Background | Click the Query button to access Color Selections. Valid formats for color selections include predefined system colors (e.g. Light Red), Custom (RGB codes), HTML Hex Color Codes, User Defined colors (e.g. Color17) and string Expressions.
(The Color Selections Query button and dialog were added in PxPlus 2020.)
Attributes | Optional attributes. See Attributes.
*Visual Class | Assign a visual class to the control. Can be Fixed, Expression or Dynamic. (Dynamic is available only when a data Class is entered.) Click the Visual Class Maintenance button to launch the Visual Classes Maintenance utility for creating or editing visual classes. To assign visual classes to controls at the library level, see Visual Class Assignment. If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. #### Note: Visual class names that begin with an "*" (asterisk) are pre-defined visual classes used by PVX Plus and may be subject to change without notice. (Dynamic data classes and properties were added in PxPlus 2018.) (The Visual Class Maintenance button was added in PxPlus 2019.)
*iNomads Class | Assign an iNomads class to the control. Can be Fixed, Expression or Dynamic. (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. The iNomads class contains class attribute references used when defining the control in the HTML code generated in iNomads. An iNomads class reference must start with an alpha character (A-Z or a-z), followed by any combination of A-Z, a-z, 0-9, underscore or dash. Multiple references may be entered, separated by a space. For a list of pre-defined iNomads classes, see iNomads Classes. (Dynamic data classes and properties were added in PxPlus 2018.)
Attributes ( * indicates a Dynamic property)
Attributes |
Tab Stop | Adds the control to the tab order list. Allows use of the Tab key for moving to the control.
Auto Tab Skip | Control is skipped when tabbing forward but is still accessible via Shift - Tab or the mouse.
Initially Disabled | Control region is grayed out and is not accessible to the user for input. The control is accessible programmatically.
Initially Hidden | Control is not displayed but is accessible programmatically.
Locked | User can set focus but cannot change the Multi-Line input region. Associated query button is disabled.
PermaLock/Query Input | Multi-Line is permanently locked. Associated query button is enabled. Forces input through the query only. Can be used in conjunction with a Drop Query to emulate an enhanced drop box. If the Multi-Line has an assigned hot key, the hot key will trigger the query button provided that the query button has an image assigned to it and has no hot key of its own. (The PermaLock/Query Input property was added in PxPlus 2014 - Feature Pack 1. The hot key trigger of the query button was added in PxPlus 2019.)
Signal On Exit | A signal is generated when focus leaves the control whether the selection or value has changed or not. NOMADS will execute the On Change logic.
Signal All Chg (Auto) | A signal is returned on any changes in the control.
Signal When Full | Generates a signal upon maximum input length. NOMADS will execute the On Change logic for the control.
Signal To/From Null | Generates a signal when the Multi-Line value changes from null to non-null or vice versa. Triggers On Change logic without focus leaving the control.
Horizontally Center Text | Text is centered horizontally in the Multi-Line input field. (The renaming of "Center Text" to "Horizontally Center Text" was added in PxPlus 2026.)
Vertically Center Text | Text is centered vertically in the Multi-Line input field. (The Vertically Center Text property was added in PxPlus 2026.)
Right Justify Text | Text is right aligned in the Multi-Line input field.
Numeric | Value for the control is returned in a numeric variable.
Password | Password entry displays a $ (dollar sign) as substitute for each character entered.
Strip Trailing Spaces | Strips trailing spaces when reading/writing data for the control.
Uppercase | Converts text from lowercase to uppercase automatically.
Borderless | The control is drawn with no border or frame.
Tab Support | Supports the use of the Tab key in the Multi-Line input region.
Append Text | Edit Mode. Append to end of existing text. (Default is Insert).
Ignore Change Flag | Select this check box when you do not want the NOMADS CHANGE_FLG variable to be updated when the control value is changed. (The Ignore Change Flag property was added in PxPlus 2017.)
Enable Scrolling | Allows the control to scroll in a resizable/scrollable dialogue box. See Panel Resizing.
Reverse Input | Support for Arabic characters (right to left entry).
Auto Fill | Select this check box to set up the Auto Fill feature, which completes the entry of a Multi-Line control based on the matches available from a pre-defined query. Additional options are:
Must Match | (Available when Auto Fill check box is selected) When selected, forces the entry to match an entry from the pre-defined query.
Not Empty | (Available when Must Match check box is selected) When selected, the Auto Fill input cannot be left empty. A value must be specified.
To set up Auto Fill, first select the Auto Fill check box. (The Must Match and Not Empty check boxes are optional.) Then, select the Query tab to enter the Library and Panel to use as the predefined query for the Auto Fill. The first column of data from the query will be the column against which the matches will be made. Select the Suppress Query Button check box in the Query Button Options section.
Rich Text Input | Use Rich text control to enable RTF data and user formatting. #### Note: Rich Text Multi-Line controls are not supported in iNomads.
Transparent | Multi-Line background and border are transparent; i.e. the window contents behind the Multi-Line show through. Transparency requires that the Locked and Borderless attributes also be set. #### Note: Setting a background color is not compatible with transparency. If a background color is specified, it will be ignored.
Spell Check | Select this check box to enable spell checker for the Multi-Line. If not set, the system-wide AutoSpellCheck setting will be in effect. The spell checker uses a wavy red underline to flag words that appear misspelled or duplicated. Words that are all uppercase are not spell checked. This option is ignored for Multi-Lines that are defined as Uppercase or are used for Arabic (right to left) input when the Reverse Input check box is selected. (The Spell Check property was added in PxPlus 2019.)
Scrollbars (if req'd) | Scrollbar(s) to display when the height of the Multi-Line is greater than one line. Selection options are Vertical (default), No scrollbar, Horizontal, Both scrollbars.
Corner Radius | Sets the radius for the multi-line corners. Works only in 4D mode. Possible values are Null (blank), Round, Square or a value from 0 to 7 inclusive. See CornerRadius$ property. Example: Corner Radius set to Round: Corner Radius set to Square: Corner Radius set to a value of 7: #### Note: Corner rounding is limited based on the control type and/or the control size. (The Corner Radius property was added in PxPlus 2026.)
Load Options |
EZ Load | Select this button to set up an EZ Load Multi-Line that will self-load when an associated trigger control is populated. See EZ Load Multi-Line.
Smart Load (formerly Auto Load) | Select this button to set up a Smart control that will self-load based on a query definition. See Smart Controls.
#### Note: The EZ Load and Smart Load options are not compatible with one another. (Support for EZ Load and enhanced Smart Load capability was added in PxPlus 2018.)
Other |
Object Persistence | Sets Object Persistence. Click the drop-down arrow for a list of selections:
Default | Set via global variable
Always | On, overriding global activation
Never | Off, overriding global activation
*User-Defined Tag Field | For controls, data/tag field that can be used to pass information on such things as formatting, error messages or validation rules. Can be Fixed, Expression or Dynamic. (Dynamic is available only when a data Class is entered.) Field contents are placed in a variable using the control name with a .TAG$ extension. If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.)
Alt-Key | Hot key for the control. Click the drop-down arrow for a list of selections.
Logic
Default Program | Displays the name of the Default Program used in the Panel Header definition. (The Default Program was added for display in PxPlus 2019.)
Post Create | Logic to be processed after the control is drawn. Click the drop-down arrow for a list of selections. See Events Logic. Click the Program Logic button beside the Perform or Call action to launch the default program editor, which is typically the *IT - Integrated Toolkit. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+. (The ability to set Ed+ as the default program editor was added in PxPlus 2023.)
When Receiving Focus | Logic to execute when the control receives focus. Click the drop-down arrow for a list of selections. See Events Logic. Click the Program Logic button beside the Perform or Call action to launch the default program editor, which is typically the *IT - Integrated Toolkit. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+. (The ability to set Ed+ as the default program editor was added in PxPlus 2023.)
On Change | Logic to be executed when focus leaves the control or the state of the control has changed. Click the drop-down arrow for a list of selections. See Events Logic. Click the Program Logic button beside the Perform or Call action to launch the default program editor, which is typically the *IT - Integrated Toolkit. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+. (The ability to set Ed+ as the default program editor was added in PxPlus 2023.)
User Aids ( * indicates a Dynamic property)
Dynamic (from Data Class) | (Available when a data Class is entered) If selected, identifies which Help Reference properties are dynamic. If a dynamic data class is entered, this check box is automatically selected. If the data class is not dynamic, this check box can be manually selected. #### Note: If the Dynamic (from Data Class) check box was manually changed on the User Aids, Validation and/or Query tabs, clicking the Reapply Data Class button will reselect this check box if the data class entered for the control is dynamic or deselect it if not dynamic. (Dynamic data classes and properties were added in PxPlus 2018.)
*Help Reference | Help text to be invoked at run time by pressing Shift - F1 while focus is on a control.
Type | Select from External or Internal help types:
External | (Default) Standard Windows help system consisting of a help File Name (.html, .hlp, .doc, etc.) and an optional Keyword or Reference number (Fixed value or string Expression).
Internal | Application supplied message text (Fixed value, string Expression or Message Library Reference).
File Name | Name of the help file.
Keyword | Indicates that the text in the adjacent field is the index entry for the topic in the indicated help file.
Reference | Indicates that the adjacent field contains the reference number for a specific topic in the context sensitive help.
Popup | Select this check box to display the help topic as a popup rather than as an independent window.
Test | Tests the current help settings.
If the Dynamic (from Data Class) check box is selected, the Help Reference properties will be dynamic and locked. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.)
*Floating Tip | Mouse pointer message for the control. Can be a Fixed value, string Expression, Message Library Reference or Dynamic. (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. You can customize the floating tip by adding a tip title, descriptive tip text and a hyperlink. These features enhance the visual display and functionality of the tip by providing users with much needed information at their fingertips. You can define either a Standard tip or an HTML tip that provides a simplified HTML Editor for customizing the tip text. To do this, click the button to the right of the Floating Tip Multi-Line input to invoke the Define Info Tip dialogue. See Defining an Info Tip. #### Note: The Floating Tip drop box and Multi-Line input cannot be changed once an HTML tip has been defined. NOMADS Wiki Help The floating tip text can be used when displaying the Wiki Help. Info tips, however, are not supported and will be ignored. (Support for customizing Floating Tips was added in PxPlus 2016.) (Dynamic data classes and properties were added in PxPlus 2018.) (Support for the use of Floating Tip text in the Wiki Help was added in PxPlus 2023.)
*Message Bar | Text to be displayed in the panel's status bar when focus is on the control. Can be a Fixed value, string Expression, Message Library Reference or Dynamic). (Dynamic is available only when a data Class is entered.) If a dynamic data class is entered, this property will be automatically set to Dynamic and assigned a %NOMADS'class' variable, which is locked. #### Note: Expressions that come from a data class must be global variables. If the data class is not dynamic, this property can be manually set to Dynamic. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.)
Validation ( * indicates a Dynamic property)
Dynamic (from Data Class) | (Available when a data Class is entered) If selected, identifies which Data Validation/Display Logic properties are dynamic. If a dynamic data class is entered, this check box is automatically selected. If the data class is not dynamic, this check box can be manually selected. #### Note: If the Dynamic (from Data Class) check box was manually changed on the User Aids, Validation and/or Query tabs, clicking the Reapply Data Class button will reselect this check box if the data class entered for the control is dynamic or deselect it if not dynamic. (Dynamic data classes and properties were added in PxPlus 2018.)
*Data Validation/Display Logic | If the Dynamic (from Data Class) check box is selected, the Validator, Formatter and Rules properties will all be set to Dynamic and assigned %NOMADS'class' variables, which are locked. (All three properties must be either dynamic or non-dynamic.) See Dynamic Control Properties. #### Note: Expressions that come from a data class must be global variables.
Key Field (skips file validation) | (Available when a dynamic data Class with Extended Validation is entered) Select this check box to skip the file validation for the Multi-Line (i.e. Key field). For example, if the Multi-Line (e.g. Salesperson Code) is being created on a panel that will be used to enter new Salesperson records, selecting this check box will prevent validation from checking the data file to determine if the entry already exists.
Validator | Name of validation program with an optional entry point label. See Format and Validation Logic.
Formatter | Name of formatter program with an optional entry point label. See Format and Validation Logic.
Rules | Input validation range and/or values (comma-separated); e.g. A, C, R-T. Can be a Fixed value, string Expression or Dynamic. (Dynamic is available only when a data Class is entered.) If using Property Sheets and setting Rules to Dynamic, the Validator and Formatter properties will automatically be set to Dynamic.
(Dynamic data classes and properties were added in PxPlus 2018.) (The Key Field check box was added in PxPlus 2019.)
Size Override on Focus |
Columns | Multi-Line width will resize to specified value when focus is set to the control.
Lines | Multi-Line height will resize to specified value when focus is set to the control.
Query ( * indicates a Dynamic property)
Dynamic (from Data Class) | (Available when a data Class is entered) If selected, identifies which Query Type and its associated properties are dynamic. If a dynamic data class is entered, this check box is automatically selected. If the data class is not dynamic, this check box can be manually selected. #### Note: If the Dynamic (from Data Class) check box was manually changed on the User Aids, Validation and/or Query tabs, clicking the Reapply Data Class button will reselect this check box if the data class entered for the control is dynamic or deselect it if not dynamic. (Dynamic data classes and properties were added in PxPlus 2018.)
*Query Type | Type of query to associate to the control: Panel, Query Program, Non-Query Logic, Spinner Controls, Calendar. Valid formats include a NOMADS query object or query list, a custom query panel, or user-supplied query program. Depending on the Query Type selected, different information is entered. See Query Type. For information on assigning a query to a control, see Assigning a Query. For information on using the query to launch a service program, see Service Queries for Web, Email, Map and Open File. To view a video presentation on how to add a Google map query, go to How to Add a Google Map. To view a video presentation on how to use the embedded query feature, which includes the %NOMAD_Qry_Attr$ property, go to How to Use Embedded Query. If setting up the Multi-Line as a Smart control (see Smart Load attribute above), you can define a query for the Smart control. See Defining Smart Controls. If the Dynamic (from Data Class) check box is selected, the Query Type and its associated properties will be dynamic and locked. See Dynamic Control Properties. #### Important Note: Query buttons are only drawn if the associated Multi-Line is one line high. (Dynamic data classes and properties were added in PxPlus 2018.)
Auto Complete | (Available if Query Type is Panel, Query Program or Non-Query Logic) Assign a specific auto complete definition to the Multi-Line. Click the drop-down arrow for a list of existing entries (if defined using Auto Complete Definition).
Query Button Options | (Available if Query Type is Panel, Query Program or Non-Query Logic) Options for setting the appearance of the query button for the Multi-Line. See Query Button Options. If the Dynamic (from Data Class) check box is selected, the query button properties will be dynamic and locked. See Dynamic Control Properties. (Dynamic data classes and properties were added in PxPlus 2018.)
Security | Security restrictions. See Restricting Access for information on Object Security Definition.
Groups | Assign the control to a group. See Group Assignment.
Popup Menu | Associate a popup menu that will appear when you right-click the mouse over the selected control. See Popup Menu.
Notes | Add notes/comments for the control. Maximum 1024 characters. These notes also display in the Wiki Help documentation for the panel. See NOMADS Wiki Help. (The Notes button was added in PxPlus 2023.)

## See Also

MULTI_LINE Properties
MULTI_LINE Directive