Condividi tramite


Form Control Properties

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

This topic describes the properties for form controls and provides recommendations for their use. It is mandatory to set values for some properties. For more information, see Best Practices for Form Control Properties. Please note that not all properties detailed here are present on every control.

Use the automatic property settings for controls (Auto settings) wherever possible. They save time, help to create a uniform application interface, and interact dynamically with other Auto settings. For example, the Auto settings for dimension properties, such as Top, Width, and Left, make allowances for changes to properties, such as Font and FontSize.

For bound controls (those associated with an underlying database field), set the properties on the field in the form data source. The same properties are applied if the same control is used more than once on the form.

Some properties are inherited from the data type that the control is based on (or the data type for the field that is displayed in the control).

The properties set on container controls (ButtonGroup, Group, Tab, and TabPage) can override the settings on the child controls.

The properties for form controls are listed in the following table.

A, B, C, D, E, F, G, H, I, K, L, M, N, O, P, R, S, T, U, V, W

Property

Description

New in this version of
 Microsoft Dynamics AX

A

N/A

AcquireFocus

Specify whether a button or menu button in an action pane gets focus. Use Yes to have the button temporarily get focus when clicked. Use No when the button should not get focus. The default value is Yes.

Caution

Set the property to Yes when a button or menu button control appears in an action pane.

AX 2012

ActiveBackColor

Sets the background color of the current record in a grid.

ActiveForeColor

Sets the text color of the current record in a grid.

AlignChild

Determines whether a control within a group should follow the AlignChildren property setting for the group or overall form design.

For example, if AlignChildren is set to Yes on the form Design node, you might not want a particular group to be arranged with the other groups. In that case, set AlignChild to No on that group.

AlignChildren

Aligns the child controls within a container.

AlignControl

Defines whether controls should be aligned. The top left corner of the controls are aligned according to the longest label.

Use this property to align a number of edit fields.

To align all the controls within a group, use the AlignChildren property.

Alignment

Changes the alignment of the text in the control (Left, Right, Center).

AllowEdit

Specify whether you can modify the data in the control.

When this property is set on a container control, modifications are disabled or enabled for all controls within the container.

Caution

The fields that appear in a ListView control remain editable after you set AllowEdit to No.

This property is also found on table fields and form data source fields. Settings on the control take priority over settings on the data source field. They take priority over settings on the table field.

AllowNegative

Determines whether integers displayed in IntEdit, Int64Edit, and RealEdit controls can be negative.

AllowUserSetup

Specifies whether users can move controls on a form, and whether they can change control properties.

This property is also found on the design of a form. The property has the following outcomes:

  • No – users cannot customize any controls in this container.

  • Restricted– users can change properties of individual controls, but cannot move controls.

  • Yes – no restrictions on user setup.

Yes is the default value for AllowUserSetup.

Full user setup is not allowed if any of the parent containers for the control have restrictions on the user setup level.

The AllowAdd property on form data sources determines whether a user can add a new field to a form.

AlternateRowShading

Determines whether alternate rows of a Grid control are shaded or not.

AnimateFile

Specifies the name of the .avi file to be used in an Animate control. For a list of the .avi files supplied with Microsoft Dynamics AX, see the AviFiles macro.

Note

The .avi file must not have a soundtrack.

AppendNew

Adds new text to the list of options in a ComboBox control.

This enables users to add new options to the list.

This property can be used only on unbound controls (those not linked to a table field).

ArrangeMethod

Determines how the controls within a container control should be arranged (Vertical, Horizontal flush left, Horizontal flush right).

ArrangeWhen

Determines when the controls in the container should be arranged (Startup, On demand, Never).

ArrayIndex

Specifies the array element to be displayed in the control. If ArrayIndex=0, all elements are displayed.

AssemblyName

Specifies the name of the assembly that contains a ManagedHost control.

AutoArrange

Determines whether the items in a ListView control should be arranged automatically.

AutoDeclaration

Determines whether the system should declare a variable of the same name as the control.

Set to Yes to refer to the control in X++ code on the form.

Note

Each control must have a unique name.

AutoInsSeparator

Determines whether a decimal separator is inserted automatically in a RealEdit control.

AutoPlay

Determines whether the .avi file in an Animate control should play automatically when the form is opened.

AutoRefreshData

Determines whether the .data in the datasource associated with the control is refreshed when the control is clicked.

B

N/A

BackgroundColor

Determines the color used for the background of the control. To set the background to opaque or transparent, use the BackStyle property.

BackStyle

Sets the background of the control to opaque or transparent.

Big

Specifies whether to make the control big.Large buttons should be used to represent the most frequently used tasks in a button group.

AX 2012

Bold

Displays text in another style (for example, Semi-bold, Bold, Heavy).

For more information about styles, see the Font and Underline properties later in this topic.

Border

Determines the border type of the control (None, Single line, 3D).

BottomMargin

Sets the default bottom margin in pixels of the controls within a container.

ButtonDisplay

Determines whether button controls display an image, text only, or both text and the image.

The button's text is set by using the Text property.

The image is set by using the NormalImage and DisabledImage properties.

C

N/A

CacheDataMethod

Specifies whether the DataMethod is cached during the FormDataSource init method call.

AX 2012

CanScroll

Determines whether users can scroll down the list or tree items.

Caption

Specifies the heading for grouped controls. Use a label for this property.

Center

Determines whether the .avi file in an Animate control should be centered in the control.

ChangeCase

Determines whether the system should automatically change the case of any text entered in a StringEdit control. For example, text can be changed to uppercase or sentence-case.

CheckBox

Adds a check box to a ListView or Tree control.

ClassName

Specifies the class ID of an ActiveX control or an HTML control. The class ID is also used during run time.

The ClassName property is automatically set when you create the control and cannot be changed. For HTML controls, ClassName is always HTML Document. For ActiveX controls, ClassName depends on the type of ActiveX data object you select in the ActiveX Browser dialog when you create the control.

ColorScheme

Determines the control's color palette.

To change the color palette for an entire form, set the ColorScheme property for the largest container and keep the default values for the individual controls.

Column

Determines which column is initially active in a Table control.

ColumnHeader

Determines whether the columns in a ListView control should have a heading.

This is only valid when the ViewType property is set to Details.

ColumnHeaderButton

Places a button in the header of a ListView control that allows the sort order to be defined.

The ColumnHeaderButton property is only valid when the ColumnHeader property has also been set, and the ViewType property has been set to Details.

ColumnImages

Determines whether each item in the column of a ListView control includes an image.

Use the SmallIcons property to set the name of the file that contains the icons.

Columns

Sets the number of columns that display the information.

Note

Field groups on the underlying table are never split into more than one column.

ColumnSpace

Sets the amount of space between columns in container controls.

ComboType

Sets the type of box to use in a ComboBox control (Standard or List).

Command

Defines the command to activate when the user presses a CommandButton control.

ConfigurationKey

Specifies the configuration key used to control display of this control.

If a user doesn't have access to the configuration key, the control will not be visible.

ContextFlyout

Specifies whether the context flyout is enabled.

AX 2012

CopyCallerQuery

Specifies whether to copy the query from the calling form to the target form. This enables the target form to show the same data that appeared in the original form. The following list describes the value that you can use. The default value is Auto.

  • Auto – If the value is Auto and the CopyCallerQuery property of the menu item is Auto, the caller query is not copied. If the value is Auto but the CopyCallerQuery property of the menu item is Yes or No, the menu item determines whether the query is copied.

  • No – The caller query is not copied. The menu item properties determine the query that is used.

  • Yes - The caller query is copied. In addition, the query specified by the Query property of the menu item is ignored.

AX 2012

CountryRegionCodes

Specifies the country region codes where the table is applicable or valid. The client framework and application may use this property to enable or disable country or region specific features. This is implemented as a comma-separated list of ISO country codes in a single string. The values must match data that is contained in the global address book.

AX 2012

CountryRegionContextField

Specify the field that sets the country context for the control. Populate this property with a DataAreaId or PartyId field. This property is related to the CountryRegionCodes property.

AX 2012

Custom

Opens the property sheet for an ActiveX control.

Click the button in this property field to access the ActiveX properties for control.

Note

The form must be in Design view, before you select the button. Right-click on the Design node of the form and select Edit. Not all ActiveX controls have a property sheet, and some controls do not allow you to edit it.

For more information, see How to: Add ActiveX Controls to Forms.

D

N/A

DataField

Specifies which field on the underlying table supplies data for the control.

The table is set by using the DataSource property.

Note

If you set the DataSource and DataField properties, any settings made on the DataMethod or ExtendedDataType properties will be overridden.

DataGroup

Specifies the group of fields from the underlying table that is displayed in a Grid or Group control.

DataMethod

Activates a method on the control (instead of data being displayed from an underlying field). The method may be selected from the following:

  • The table that is used as a data source for the form

  • The Methods node within the Data Sources node on the form

  • The Methods node on the form

Note

If you set the DataSource and DataField properties, any settings made on the DataMethod property will be overridden.

DataSource

Determines which table data is displayed from in the control.

To set a particular field within this table, use the DataField property.

If the control opens another form, relations between the data source specified here for the control and the data source on the other form will ensure that records in the second form are dynamically selected.

For example, if a customer is selected in one form, and the control opens up a form showing customer transactions, a range of customer transactions applying to the current customer would be displayed in the second form.

Note

If you set the DataSource and DataField properties, this will override any settings made on the DataMethod or ExtendedDataType properties.

DateDay

Determines how the day (within the date) should be displayed in a DateEdit control. You can also choose not to display the day.

DateFormat

Determines the layout of a date (the order in which day, month, and year are displayed).

If this property is set to Auto, settings are inherited from the extended data type. If this property is also set to Auto on the extended data type, system settings are used.

DateMonth

Determine how the month should be displayed in a DateEdit control (text, digits, or not shown).

If this property is set to Auto, settings are inherited from the extended data type. If this property is also set to Auto on the extended data type, system settings are used.

DateSeparator

Determines the separator between year, month, and day in a DateEdit control.

If this property is set to Auto, settings are inherited from the extended data type. If this property is also set to Auto on the extended data type, system settings are used.

DateTimeValue

Specifies the initial value in a UtcDateTimeEdit control.

AX 2012

DateValue

Enables you to specify a specific date for a DateEdit control instead of using a data source.

Note

This property is not used if the DataSource and DataField properties are set.

DateYear

Determines how the year should be displayed in a DateEdit control (two or four digits, or not shown).

If this property is set to Auto, settings are inherited from the extended data type. If this property is also set to Auto on the extended data type, system settings are used.

DecimalSeparator

Specifies the decimal separator for a RealEdit control ("," or ".").

If this property is set to Auto, settings are inherited from the extended data type. If this property is also set to Auto on the extended data type, system settings are used.

DefaultAction

Determines the default action that is executed when a row in a Grid control is double-clicked or the ENTER key is pressed. Select the name of the action pane button that represents the action to perform.

DefaultActionLabel

Determines the name that displays in the context menu for the default action on a row in a Grid. The action is specified in the DefaultAction property.

DefaultButton

Specifies whether a button control should be the default button.

If this property is set to Yes, the button is selected when the user presses ENTER when the form is open.

Note

The Frame property on the form design must be set to Dialog for this property to have an effect.

Direction

Specifies whether the progress bar should be drawn horizontally or vertically in a Progress control.

Note

Do not use a Progress control in a form. Use the Progress Indicators framework instead. For more information, see How to: Create Progress Indicators.

DisabledImage

Specifies the image to use when the button is disabled. If this property is not set, the system generates a disabled image based on the setting for the NormalImage property.

DisabledImageLocation

Specifies the location of the image to use for a disabled control. You can use images found in a file, the Resources node of the AOT, or an EmbeddedResource.

The selection made in this property determines what values are used to populate the DisabledImage property. If the property is not set, the system generates a disabled image based on the setting of the ImageLocation property.

AX 2012

DisplaceNegative

Indents a negative number to the right.

DisplayHeight

Limits the height of the control.

Use this property in conjunction with the MultiLine property to define a data entry field that can span several lines.

DisplayLength

Limits the number of characters displayed in the control.

This property determines the width of the control in number of characters. The Width property is specified in pixels.

The LimitText property determines how many characters can be entered in the control.

DisplayOption

Specifies whether the DateTimeEdit control should display the date and time, or just the date without the time.

The following list shows the valid values for this property, in the sequence that they are listed in the AOT Property window's drop-down list. The corresponding integer value for each label matches its position in the list, starting from 0:

  • 0 – Auto

  • 1 – Date and Time

  • 2 – Date

Auto defaults to Date and Time. Auto is overridden if the parent (or another parent in the sequence) is specifically set to a value other than Auto.

DragDrop

Enables the field to be moved with a drag-and-drop operation.

Note

Drag-and-drop fields require code to support them. For examples, see the tutorial_FormListControl and tutorial_FormTreeControl forms.

E

N/A

EditLabels

Determines whether the user can change the name of a node in a Tree or ListView control.

Enabled

Disables the control when the property is set to No.

To allow the control to be disabled (depending on licensing rights and system configuration), use the ConfigurationKey property instead.

To allow access control for different user groups, use the NeededAccessLevel property.

EnumType

Gives a control access to the values in an enumerated type. For example, a control listing possible currencies.

ExtendedDataType

Bases the control on an extended data type.

Note

If you set the DataSource and DataField properties, or the DataMethod property, this will override any settings made on the ExtendedDataType property.

F

N/A

FastTabSummary

Specifies whether the value of the control appears in the Fast Tab header as a summary field. Options are Yes, No, Auto. Default is Auto.

AX 2012

Font

Enables you to select another font for the control by opening a font selection dialog.

The FontSize, Bold, Underline, and Italic properties can be set individually or by using the font selection dialog.

FontSize

Changes the size of the text in a control.

ForcedToOverflow

Specifies whether the control will always be forced to overflow.

If you have a rarely used button that has to be available but not visible, add that button to the button group overflow menu. The overflow menu provides access to any buttons that are not displayed on the action pane. To access the button, click the overflow menu indicator on the right side of the button group.

AX 2012

ForegroundColor

Determines the color used for the foreground of the control.

FormatMST

Determines whether the value in a RealEdit control is formatted according to the national currency. Following are the possible values:

  • Auto – The national currency formatting depends on the data type.

  • No – The value is not formatted according to the national currency.

  • Yes – The value is formatted according to the national currency.

FormViewOption

Specifies the form mode to use. Options are Auto, Grid or Details. Default value is Auto.

AX 2012

FrameOptionButton

Allows you to add a button above a Group control. Following are the possible values:

  • None – No button is added.

  • Check – Adds a check box that enables the user to disable all the fields in the group.

  • Radio – Adds radio buttons to a group of Groups. The Group controls must be nested inside another Group control. The user can then select one of the radio buttons, and the other groups of controls are disabled.

  • Hide – Adds a collapse button that enables the user to hide the fields in the group.

FramePosition

Changes the position of the frame for a ButtonGroup, Group, or Window control.

Changes to this property are not visible if the FrameType property is set to Auto or None.

FrameType

Changes the default frame type, which is None.

G

N/A

GridLines

Determines whether grid lines should be displayed in Grid, ListView, or Table controls.

For ListView controls, this property is only valid when the ViewType property is set to Details.

By default, this property is set to Yes.

GridLinesStyle

Determines which grid lines should be drawn in Grid, ListView, or Table controls. Options are Auto, None, Vertical, All

By default, this property is set to Auto.

AX 2012

H

N/A

HasButtons

Determines whether expand/collapse buttons are displayed in a Tree control.

To display an expand/collapse button at the root of the tree, use the LinesAtRoot property.

HasLines

Determines whether connector lines are displayed in a Tree control.

Headerdragdrop

Makes it possible to rearrange the columns in a ListView control.

This property is valid only when the ViewType property is set to Details.

Height

Changes the height of the control. The height is specified in pixels.

Tip

For more information about the Height and Width properties, see the tutorial_arrange form.

HelpText

Determines the Help string for the control. The Help string is shown in the status bar when a user points to the control with a mouse pointer.

If you don't enter a value for this property, it will be inherited from the field or the extended data type that the control is based on.

Note

You must use a label to specify the content for this property.

HideFirstEntry

Emulates the behavior of an enum database field with the Mandatory property set to Yes—the user cannot select an empty value.

HideIfEmpty

Enables you to hide a container control if it is empty.

This property has no affect if the container control has its Width and Height properties set to Auto because the size of the control is then zero.

HierarchyParent

Specifies the parent of the element in the Model.

AX 2012

HighlightActive

Enables you to display the current record in a different color in a grid.

I

N/A

ImageLocation

Specifies the location of the image to use, You can use images found in a file, the Resources node of the AOT, or an EmbeddedResource. The selection made in this property determines what values are used to populate the NormalImage property.

AX 2012

ImageMode

Defines how the bitmap specified by the ImageName property will be displayed in a Window control (Normal, Size to fit, Side by side, Center).

ImageName

Determines which image is displayed for a Window control. You can select only .bmp files.

ImageResource

Specifies the resource ID for the image displayed for a Window control.

AX 2012

IMEMode

Enables you to disable the Input Method Editor (IME) input mode for edit controls.

The IME mode enables the user to input data from non-Latin languages, such as Japanese.

This property is enabled by default.

Italic

Displays the text in italics.

For more information, see the Font property in this topic.

Item

Enables you to specify the label for each item in a ComboBox, ListBox, or RadioButton control.

Type the number of the item in the Item property box, and then set the Text property for that item. Repeat this for the next item(s).

The total number of items in the control must be set in the Items property.

ItemAlign

Aligns the items in a ListView control.

Items

Determines how many items are in a ComboBox, ListBox, or RadioControl control.

To specify the label for each item, type the number of the item in the Item property, and then set the Text property. Repeat this for the next item(s).

K

N/A

KeyTip

Defines the character used for the key tip.

Key tips enable you to click action pane tabs, button groups, and buttons using the keyboard. When you press ALT the action pane displays a letter next to each tab, button group, or button that you can access. To click a button, press the key that represents the button that you want to use.

AX 2012

L

N/A

Label

Sets the text supplied as a label for the control.

If you don't enter a Label, it will be inherited from the field or the extended data type that the control is based on.

To specify the labels for each item in a ComboBox, ListBox or RadioButton control, use the Item and Text properties.

LabelAlignment

Determines the alignment of the label (Left, Right, Center). If there is more than one control in a group, the longest label defines the point of alignment.

LabelBold

Displays the label defined by the Label property in another style (for example, Semi-bold, Bold, Heavy).

For more information, see the LabelFont property in this topic.

LabelFont

Changes the font for the text supplied in the Label property.

LabelFontSize

Changes the size of the text supplied in the Label property.

For more information, see the LabelFont property in this topic.

LabelForegroundColor

Changes the color used for the label foreground.

LabelHeight

Not used.

LabelItalic

Italicizes the text supplied in the Label property.

For more information, see the LabelFont property in this topic.

LabelPosition

Determines whether the label appears to the left of the control or above it.

LabelUnderline

Underlines the text supplied in the Label property.

For more information, see the LabelFont property in this topic.

LabelWidth

Not used.

Left

Changes the position of the uppermost left corner of the control.

There are a number of predefined settings (for example, Auto (left) and Auto (right)). You can also specify an exact position in pixels.

LeftMargin

Changes the default left margin of the controls in a container control. The margin is specified in pixels.

LimitText

Limits the number of characters that can be entered in a control.

The DisplayLength property limits the number of characters displayed in the control.

LinesAtRoot

Determines whether there is an expand/collapse button at the root of the tree.

To display expand/collapse buttons for the remainder of the tree, use the HasButtons property.

LookupButton

Displays a button to look up a value in the database for the control.

The Lookup is set up by using a relation on the database table used as a data source for the field.

Loops

Defines the number of times the .avi file should be played for an Animate control.

If you set Loops to 0 (zero), the .avi file will play indefinitely.

M

N/A

Mandatory

Determines whether users must enter data in the control.

If Mandatory is set to Yes, a red wavy line is displayed on empty fields, and a warning is displayed if the user tries to navigate away from the field without completing it.

MaxDateLabel

Specifies the text to be displayed when the value is the maximum date value.

AX 2012

MenuItemName

Determines which menu item is run for a MenuItemButton control.

You must also set the MenuItemType property.

MenuItemType

Determines which type of menu item is run for a MenuItemButton control (Display, Output, or Action).

MinNoOfDecimals

Determines whether trailing zeros are removed when the data is displayed for a RealEdit control.

For example, if you set the MinNoOfDecimals to 6, a value of 2.1234500000 would be truncated to 2.12450.

If you set MinNoOfDecimals, it must be less than the value given for the NoOfDecimals property.

Model

Specifies the model that includes the control.

A model is a logical grouping of elements in a layer. An element can be located in exactly one model in a layer. Examples of elements are a table or class. The same element can be located in a customized version in a model in a higher layer.

AX 2012

MoreRowsIndicator

Specifies whether an ellipsis indicator row should be displayed in a Grid control when more rows are available but not shown.

MultiLine

Enables text to span several lines in a StringEdit control. If the property is set to Yes, vertical scroll bars are automatically added.

MultiSelect

Determines whether a button is active when the user makes multiple selections, or, on a Grid control, the property determines whether it is possible to make multiple selections.

N

N/A

Name

Determines the name of the control.

Note

Each control name must be unique—it allows the automatic declaration of controls as variables.

NeededPermission

Specifies the minimum permission level needed to allow access to the control.

NeedsRecord

Specifies whether the control will be enabled when no records are present.

AX 2012

NoOfDecimals

Determines the number of decimals shown when a value is displayed in a RealEdit control.

To remove trailing zeros at the end of the value set, the MinNoOfDecimals property.

NormalImage

Specifies the button image to be used when the button is enabled.

To set the image for the button when it is disabled, use the DisabledImage property.

O

N/A

OneClickActivate

Determines whether the items in a ListView control can be activated with a single click.

This property is valid only when the ViewType property is set to Details.

For more information, see TwoClickActivate in this topic.

OpenMode

Specifies the view mode of the target form. The possible values include the following:

  • Auto

  • View

  • Edit

  • New

The default value is Auto.

You use this property to specify whether the target form opens in edit or read-only mode.

AX 2012

OptionalRecordControl

Specifies whether the checkbox state controls the optional record associated with the Datasource property. Default is No.

AX 2012

OptionValue

Enables you to select a button that was added by using the FrameOptionButton property. For example, if the FrameOptionButton property is set to Check, setting the OptionValue property to 1 selects the check box when the form is opened.

P

N/A

Parameters

Specifies one or more values passed to an object. These resemble the parameters passed to method. A parameter supplies a value that is then used to perform the task. There is no default value.

AX 2012

PasswordStyle

Enables you to display asterisks (*) instead of the characters that a user enters when they type data in a StringEdit control.

Because of security considerations, it is not advisable to store credentials in the database. When you want to protect functionality with a password, prompt users to enter it each time, and use the PasswordStyle property to obscure the password as the user types it in.

Pos

Enables you to set a non-default initial value for a Progress control. If you don't set this property, the initial value will be the value specified by the RangeLo property. The maximum value of Pos is determined by the RangeHi property.

Note

Do not use a Progress control in a form. Use the Progress Indicators framework instead. For more information, see How to: Create Progress Indicators.

PresenceDataField

Specifies the field containing a lookup value to supply to get PresenceFileData.

AX 2012

PresenceDataSource

Specifies the data source containing the getPresenceFieldData for the control.

AX 2012

PresenceIndicatorAllowed

Specifies whether or not to display a presence indicator.

AX 2012

PreviewPartRef

Specifies the Info Part or Form Part to be used in the enhanced preview.

An info part shows a collection of data fields from a specified query. An info part uses metadata to describe how the data appears. A form part represents a pointer to a form.

AX 2012

Primary

Specifies whether a control is primary or secondary in display priority.

A primary is a control that overrides the position rules that the control group uses to add controls to the overflow menu. Specify a control as primary when you want that control to be the last added to control group overflow menu.

AX 2012

ProgressType

Determines how progression is shown in a Progress control (Normal or Smooth).

Note

Do not use a Progress control in a form. Use the Progress Indicators framework instead. For more information, see How to: Create Progress Indicators.

R

N/A

RangeHi

Sets the maximum range of the progress bar for a Progress control.

Note

Do not use a Progress control in a form. Use the Progress Indicators framework instead. For more information, see How to: Create Progress Indicators.

RangeLo

Sets the minimum range of the progress bar for a Progress control.

RealValue

Determines the initial value for a RealEdit control. This is typically used for an unbound control (a control not bound to a data field).

ReferenceField

Specifies a reference field on the bound data source to use as the physical binding.

AX 2012

ReplacementFieldGroup

Specifies the field group that appears in the form when you add a surrogate foreign key field to that form.

AX 2012

ReplaceOnLookup

Determines whether look-up text replaces the current content of the field or adds to the current content.

If ReplaceOnLookup is set to Yes, the content of the field is replaced by text selected in a look-up. If ReplaceOnLookup is set to No, the text selected in a look up is added to the existing content of the field at the cursor position.

RightMargin

Changes the default right margin of the controls within a container control. The margin is specified in pixels.

RotateSign

Negates the number in an IntEdit, Int64Edit, or RealEdit control (changes - to + and vice versa).

Row

Determines which row in a Table control is active when the form or tab is opened.

Rows

Changes the number of rows used to display information.

RowSelect

Determines whether an entire row is selected when it is clicked in a ListView control (rather than a single element).

This property is valid only when the ViewType property is set to Details.

RTLCapable

Determines whether an ActiveX, HTML, or ManagedHost control supports RTL languages.

S

N/A

SaveRecord

Determines whether changes to the current record are saved when a Button, CommandButton, MenuButton, or MenuItemButton control is selected.

Scrollbars

Determines whether scroll bars are enabled on a TabPage control.

SearchMode

Sets the search mode in grids for edit controls.

By default, this property is set to None. If you set SearchMode to SearchAfterInput, text typed into the control is applied as a filter when the user presses ENTER. If you set it to SearchOnTyping, the grid scrolls to the first record that matches the text that the user typed.

The SearchMode property is most relevant for controls that can't be edited. Use this property with caution—the grid will load all the records that are available to do the text-matching.

SelectControl

Determines whether the first control is selected when a user opens a tabbed page.

Selection

Sets the initial value for a ComboBox, ListBox, or RadioButton control.

SendExternalContext

Specifies whether or not the external record context of this form should be sent as the menu item’s external record context. Default value is No.

AX 2012

ShowColLabels

Determines whether the label defined by the Label property is shown as a column heading for controls on Grids or Tables.

ShowLabel

Determines whether the label defined by the Label property is displayed for the control.

ShowRowLabels

Displays a column where the current record in a grid or table is indicated by an arrow, and new records are indicated by an asterisk.

ShowSelAlways

Determines whether an item in a Tree or ListView control should remain selected when the user moves focus away from the item.

ShowShortCut

Determines whether access keys should be displayed.

An access key is a keyboard shortcut (letter+ALT) for opening a menu item or button. The letter is underlined in the name of the menu item.

Access keys are generated automatically.

This property is typically set to No when a form has so many buttons that no more letters are available.

For more information about access keys, see Access Keys on Forms.

ShowTabs

Determines whether tabbed pages should be displayed on a Tab control. If set to No, information on only the first tabbed page is shown.

You can reference the other tabbed pages from your X++ code.

ShowZero

Determines whether the value zero is displayed in an IntEdit, Int64Edit, or RealEdit control, or whether an empty field is shown instead.

SignDisplay

Displays the sign of a number if the value is negative. Also determines whether the sign is displayed before or after the number. The default value is Auto.

Note

If you set the property to None, the sign might not be hidden when the control appears on a form.

SingleSelection

Determines whether the user can select several objects at a time in a ListView or Tree control, or whether the selections should be mutually exclusive.

SizeHeight

Sets all buttons in a ButtonGroup control to the same height.

SizeWidth

Sets all buttons in a ButtonGroup control to the same width.

Sizing

Determines the size of a ManagedHost control. Set to SizeToContent if you want resizing to be governed by the control (up to the limits of the form size). Set to SizeToHost if you want the size to be set by the host.

Skip

Determines whether the control is skipped when the TAB key is used to navigate through the form.

Sort

Enables you to sort the data in a ListView control.

Step

Defines the integer value that the progress bar increases in one step.

Note

Do not use a Progress control in a form. Use the Progress Indicators framework instead. For more information, see How to: Create Progress Indicators.

Style

Specifies the style of the control. The default is Auto.

T

N/A

Tab

Determines which tabbed page should be active when the form is opened.

If you do not set this property, the first tabbed page (Overview tab) opens by default.

TabAppearance

Enables you to display tabbed pages as buttons instead of tabs.

TabAutoChange

Changes the result of a user pressing the TAB key on the form. This action would normally result in a jump to the next field. If you set the TabAutoChange property, pressing the tab key instead results in a jump to the next tabbed page.

TabLayout

Defines how the tabs should be arranged if there are too many to fit in the default form width. You can arrange tabs on more than one line or add a scroll bar (Tunnel option).

TabPlacement

Defines the position of the tabbed pages in a Tab control (Top, Left, Right, Bottom).

Text

Specifies a static text for the control. You must use a label to set this property.

For ComboBox, Listbox, and RadioButton controls, the Text property enables you to specify the label for each item in the control. Type the number of the item in the Item property, and then set the Text property for that item. (You must first set the total number of items by using the Lines property.) The Text property is typically set for controls that are not associated with an underlying data source. If the control is bound, the list or button text comes from the underlying data source.

ThousandSeparator

Sets the thousands separator for a RealEdit control—None, Comma, Dot, Space, or Apostrophe.

TimeFormat

Changes the default time format (24 hour or AM/PM).

If this property is set to Auto, settings are inherited from the extended data type. If this property is also set to Auto on the extended data type, system settings are used.

TimeHours

Determines whether hours should be shown in a TimeEdit control.

TimeMinute

Determines whether minutes should be shown in a TimeEdit control.

TimeSeconds

Determines whether seconds should be shown in a TimeEdit control.

TimeSeparator

Determines the separator between hours, minutes, and seconds in a TimeEdit control (Colon, Dot, Space, Comma, Slash).

TimeZone

The TimeZone property on the UTCDateTime control is a runtime only property (cannot be set in the AOT). Use this property to specify the time zone value to be displayed in the DateTimeEdit control when TimeZoneIndicator resolves to Always and TimezonePreference resolves to No Conversion.

This property has no effect on the date/time value displayed in the DateTimeEdit control.

TimeZoneIndicator

Specifies whether the small icon for displaying the time zone used for conversion from UTC should be visible on the DateTimeEdit control. This property setting is ignored if the TimezonePreference property setting resolves to No Conversion.

The following list shows the valid values for this property, in the sequence that they are listed in the AOT Property window's drop-down list. The corresponding integer value for each label matches its position in the list, starting from 0:

  • 0 – Auto

  • 1 – Never

  • 2 – Always

If the TimezonePreference property resolves to User, the setting of Auto defaults to Always for TimeZoneIndicator. However, if TimezonePreference resolves to No Conversion, the setting of Auto defaults to Never for TimeZoneIndicator.

Auto is overridden if the parent (or another parent in the sequence) is specifically set to a value other than Auto.

If TimeZoneIndicator is explicitly set to Always, and TimezonePreference is explicitly set to No Conversion, the time zone displayed by the icon is UTC.

TimezonePreference

Specifies the time zone that the DateTimeEdit control should use to convert to and from UTC.

The following list shows the valid values for this property, in the sequence that they are listed in the AOT Property window's drop-down list. The corresponding integer value for each label matches its position in the list, starting from 0:

  • 0 – Auto

  • 1 – User

  • 2 – No Conversion

Auto defaults to User. Auto is overridden if the parent (or another parent in the sequence) is specifically set to a value other than Auto.

The User value means the time zone preference configured for the current user.

ToggleButton

Specifies the type of the toggle button. Options are Auto, None, Check, and Radio. The default value is Auto.

AX 2012

ToggleValue

Specifies the type of the toggle button. The default value is Off.

AX 2012

Top

Changes the position of the top of the control.

There are a number of predefined settings or you can specify in pixels an exact position.

TopMargin

Sets in pixels the default top margin of the controls within a container.

TrackSelect

Highlights each element within a ListView control when the user moves the mouse pointer across it.

Transparent

Determines whether the background should be transparent for an Animate control.

TwoClickActivate

Determines whether the items in a ListView control are activated with a double-click.

This property is valid only when the ViewType property is set to Details.

For more information, see OneClickActivate in this topic.

Type

Specifies the type of control. Read-only.

TypeName

Sets the name of the type for a Managed control. Use the fully qualified name of the type.

U

N/A

Underline

Underlines the text for the control.

For more information, see the Font property in this topic.

V

N/A

Value

Sets the initial value for a CheckBox, GuidEdit, IntEdit, Int64Edit, or TimeEdit control.

VerticalSpacing

Changes the amount of space in pixels above and below the control.

ViewEditMode

Specifies whether the control is in read-only mode or enables you to change values.

  • View - Opens as read-only

  • Edit - Opens in edit mode

  • Auto - Opens in appropriate mode

The default is Auto.

AX 2012

ViewType

Defines the appearance of items in a ListView control (for example, with large or small icons).

Visible

Enables you to hide the control.

Tip

You cannot use the Visible property to enforce access restrictions. The user can change the visibility for the controls in the Form Setup dialog. Use the Enabled and NeededAccessLevel Properties instead.

VisibleCols

Limits the number of columns to be displayed for a Grid control. A scroll bar is automatically added to enable scrolling to the remaining columns.

When set to Auto, all columns are displayed.

VisibleRows

Limits the number of rows to be displayed for a Grid control. A scroll bar is automatically added to enable scrolling to the remaining rows.

When set to Auto, all rows are displayed.

W

N/A

Width

Changes the width in pixels of the control.

Tip

For more information about using the Height and Width properties, see the tutorial_arrange form.

See also

Form Controls Overview

Overview of Form Control Types

Best Practices for Form Control Properties

Form Data Source Properties

Form Design Properties

Announcements: New book: "Inside Microsoft Dynamics AX 2012 R3" now available. Get your copy at the MS Press Store.