Apr 15, 2016

Form Control Properties [AX 2012]

Form Control Properties [AX 2012]

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 TimeAuto 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 YesNoAuto. Default is Auto.
AX 2012
Font
Enables you to select another font for the control by opening a font selection dialog.
The FontSizeBoldUnderline, 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.

No comments:

Post a Comment