Overview of Form Control Types [AX 2012]

Overview of Form Control Types [AX 2012]

Other Versions

0 out of 1 rated this helpful - Rate this topic

Updated: October 11, 2011

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 types of controls that you can use on a form. For general information about form controls, see Form Controls Overview and How to: Add a Control to a Form.

一些窗体控件需要你在该控件的属性上指定数据源. You can add controls to a form by dragging a field or field group onto the Design node of the form. The data source property of the control is populated with name of the table for that field or field group. For more information, see How to: Add a Control to a Form.

Note

If you set the data source for a control by using the DataMethod property and the method that you want to use is on a table that is used as a data source in the form, you must also set the DataSource property. You do not have to set the DataSource property if the method is on the form or is on the Data Source node in the form.

If a control does not automatically identify a data source, use the information in the following table to populate the data source property of that control.

Control name	Description	Data source	Comments
ActionPane	该控件会添加 action pane bar 到窗体.	使用 DataSource 属性,将action pane与数据源关联起来. 默认数据源是窗体的主数据源.	使用 action pane ,为form显示action pane tab控件.
ActionPaneTab	该控件会显示一个相关控件的容器.	Not applicable.	Use an action pane tab to group actions by task or Microsoft Dynamics AX role. To display an action pane tab in the action pane, add one or more button group controls.
ActiveX	该计算机上可用的任何ActiveX 控件.	The control type is selected when you create the control, and is displayed in theClassName property.	Enables you add ActiveX controls to a form. To learn about ActiveX controls on forms, see How to: Add ActiveX Controls to Forms. Caution The ActiveX control is considered deprecated. To add a Windows Form or Windows Presentation Foundation control to a form, use the ManagedHost control.
Animate	该控件用于播放.avi file.	使用 AnimateFile 属性来设置.avi 文件.	使用该控件来显示动画图片.该.avi文件一定不能有音轨. Tip 如果你设置 AutoPlay 属性为 Yes and the Loops 属性为 0, 系统会循环播放.
Button	A rectangular button.	按钮的行为,通过重写 clicked 方法来设置. 如果按钮播放一个图片,可以通过 NormalImage 或 NormalResource 属性来设置.	使用按钮来开始一个行动.按钮一般被组织在ButtonGroup控件下. 如果你想使用命令来创建一个按钮 (for example, Open or Save) or 或打开一个系统菜单,使用 CommandButton 控件. ButtonDisplay 属性决定按钮是否播放图片. 如果窗体的Design的Style属性设为 Dialog, 你可以将按钮的 DefaultButton 属性设置为 Yes ,当你在窗体上键入ENTER时,就会选择到该按钮.
ButtonGroup	该控件有一个head,将一组按钮放到头下面.	使用 DataSource 属性,将数据源和button group关联起来. 默认的数据源,是form的主数据源.	使用 button groups 来组织和标签相关的动作. ButtonGroup 中的所有按钮显示相同的尺寸.
CheckBox	A square box that is selected or cleared to turn an option on or off. More than one check box can be selected.	通过使DataSource and DataField 属性,来设置数据源.或者通过 DataMethod 属性.	为有两个值的枚举数据类型,使用该类型控件.
ComboBox	一个文本框,有一个附加的列表. 你可以从列表中选择一个项,也可以键入一个新值.	通过使DataSource and DataField 属性,来设置数据源.或者通过 DataMethod 属性.	为有多个值的枚举数据类型,使用该类型控件. 为了防止用户添加值,可以设置ComboType 属性为 List.
CommandButton	一个按钮,可以启动一个命令. 例如,要关闭窗体,要保存全部,要打开一个系统菜单.	Not applicable.	当你想让一个按钮启动一个功能时,使用该类型的控件. 控件的功能,通过 Command 属性来设置. 你可以从多个选项中选择. 例如 , New, Open, Save,Undo, Select All, and Next Tab Page.
DateEdit	一个用于显示并编辑日期的控件.	通过使DataSource and DataField 属性,或 ExtendedDataType 属性,或者通过 DataMethod 属性, 来设置数据源.	使用该类型的控件来显示或编辑日期值.下面的属性是该控件基于所继承的控件的属性: Alignment DateFormat DateSeparator DateYear DateMonth DateDay
DropDialogButton	一个按钮,他会打开一个小窗体,让你更新指定的字段的值.	通过 DataSource 属性设置数据源.	使用 MenuItemName 属性来指定一个菜单项. 该 menu item 的 Object 属性,指定了你点击按钮时,要显示的 form.
Grid	一个 table 显示数据库表里的记录.	通过 DataSource 属性设置数据源.	Open all data entry forms to an Overview tab that displays records in a grid.
Group	A facility used to group several fields under a heading.	通过 DataSource 属性设置数据源.	Use this control to group and label related fields. 如果你将一个字段组拖至form design,会自动生成该类型的控件.
GuidEdit	一个用于显示和编辑GUIDs 的控件.	通过使DataSource and DataField 属性,或 ExtendedDataType 属性,或者通过 DataMethod 属性, 来设置数据源.	Not applicable.
HTML	一个用于显示和编辑HTML-based text的控件.	该控件的内容,通过使用 FormHTMLControl.setText 方法设置.	Not applicable.
IntEdit andInt64Edit	该控件用于显示和编辑integers.	通过使DataSource and DataField 属性,或 ExtendedDataType 属性,或者通过 DataMethod 属性, 来设置数据源.	使用该类型的控件,在窗体上显示integer值. TheIntEdit controls are for 32-bit integers and the Int64Edit controls are for 64-bit integers. Users can enter an expression in the control. The result is evaluated when they leave the control. 下面的属性是该控件基于所继承的控件的属性: Alignment DisplaceNegative ShowZero SignDisplayRotateSign
Listbox	A box that presents the user with a list of choices.	The data source is set by using theDataSource and DataField properties, or by using the ExtendedDataType property, theEnumType property, or the DataMethodproperty.	Not applicable.
ListView	一个列表,用于显示项目的集合.每个项目可以由icon和label组成.	ListView 控件的内容和行为必须通过代码定义.	使用该类型的控件,将icon和列表显示在一起. ListView 中的icons,通过使用一个图片列表来补充. For more information, see How to: Create an Image List for Controls. ListView 控件显示image list中包含的icons.通过指定 ViewType 属性的值,来组织icons: Icon Small icons List Report The ViewType property values correspond to the Large Icons, Small Icons, List, and Details settings from the Views list of the Microsoft Windows Explorer toolbar.
ManagedHost	A control that hosts a Windows Form or Windows Presentation Foundation control on a form.	The type of control is specifed by theTypeName and AssemblyName properties of the control.	Use this control to add Windows Form and Windows Presentation Foundation controls to a form. For information about how to add a .NET control to a form, see How to: Add a .NET Control to a Form.
MenuButton	A button that opens a submenu.	Not applicable.	Use this kind of control to provide access to a list of buttons. AMenuButton control can contain Button, CommandButton, andMenuItemButton controls, and Separators.
MenuItemButton	A button to open a menu item.	The MenuItemType and MenuItemNameproperties identify the menu item to be opened.	Not applicable.
Progress	A control that is used to show the percentage of completion of a lengthy operation. It consists of a bar that "fills" from left to right.	To use a progress control, you have to supply code that fills the progress bar. For example, you add a progress control for an operation that starts when a button is clicked. To update the progress control, you have to add code to the clicked method of the button control that fills the progress bar as the operation runs.	Note Use a progress indicator from the progress indicator framework instead of a progress control. For information about how to use the progress indicator framework, see How to: Create Progress Indicators.
RadioButton	A round button used to select one of a group of mutually exclusive options.	The data source is set by using theDataSource and DataField properties, or by using the ExtendedDataType property, theEnumType property, or the DataMethodproperty.	Not applicable.
RealEdit	A control that is used to display and edit real numbers.	The data source is set by using theDataSource and DataField properties, or by using the ExtendedDataType property or the DataMethod property.	Use this kind of control to show and edit numeric values. Users can enter an expression in the control. The result is evaluated when they leave the control. The following properties are inherited from the data type on which the control is based: Alignment AutoInsSeparator DecimalSeparator DisplaceNegative NoOfDecimals RotateSign ShowZero SignDisplay ThousandSeparator
ReferenceGroup	The control you use to add a surrogate foreign key field to a form.	Use the DataSource property to specify the table in the form data source that contains the field you want bound to the control. Use the DataReference property to specify the field in the DataSource table that contains the surrogate foreign key value.	Use this control to enable the lookup of related records. The control contains a control that displays the fields that replace the surrogate foreign key value. The ReplacementFieldGroupspecifies the field group that replaces the foreign key value. The control includes a lookup you can use to select or update the value that appears in the control.
SegmentedEntry	The control you use to view or enter account number and associated dimensions as segments in a single field on a form.	Use the DataSource property to specify the table in the form data source that contains the field you want bound to the control. Use the DataReference property to specify the field in the DataSource table that contains the surrogate foreign key value.	Use this kind of control to show and edit account numbrs. TheReplacementFieldGroup specifies the field group that replaces the foreign key value. The control includes a lookup you can use to select or update the value that appears in the control. Use theContextFlyout property to enable context flyout that helps identify each segment of the account number.
Separator	A control that is used to add space between buttons in a button group or a menu button.	Not applicable.	Use the separator control to organize buttons into related groups or highlight a button that represents a key task or action.
StaticText	A control that is used to display text.	The text to display in the form is specified by using the Text property.	Use a StringEdit control when you want to enable users to change text values.
StringEdit	A control that is used to display and edit text strings.	The data source is set by using theDataSource and DataField properties, or by using the ExtendedDataType property or the DataMethod property.	Use a StringEdit control to show text that can span multiple lines. This is defined by the MultiLine property. The following properties are inherited from the data type on which the control is based: Alignment Uppercase
Tab	A group control that contains TabPagecontrols.	Not applicable.	Use this kind of control to organize a group of tab pages. The Tabproperty controls which tab pages should be displayed when the user opens the form. Best practice is to leave this property set toAuto to display the first tabbed page.
Table	A spreadsheet-like table with rows and columns.	The content of a Table control must be defined by using code.	Use this kind of control to show a list of data in a grid. The Tablecontrol is not associated with the database. This control resembles a Grid control, but it can display values for different types in a single column.
TabPage	An additional page on the form.	Not applicable.	Use this kind of control to organize and label a collection of fields on a form. A TabPage control is typically used when there is too much information to display in a single dialog box. You can create a TabPage control only in a Tab control. The Caption property determines the text that is displayed on the tab.
TimeEdit	A control that is used to display and change a time.	The data source is set by using theDataSource and DataField properties, or by using the ExtendedDataType, or theDataMethod property.	Use this kind of control to show and edit time values. The following properties are inherited from the data type on which the control is based: Alignment TimeFormat TimeHours TimeMinute TimeSeconds TimeSeparator
Tree	A special list control that displays a set of objects as an indented outline based on their logical hierarchical relationship.	The content and behavior of a Tree control must be defined by using code.	Use this kind of control to show hierarchical data. The icons in aTree control are supplied by using an image list. For more information, see How to: Create an Image List for Controls.
UtcDateTimeEdit	Automatically converts Coordinated Universal Times (UTC) into local date/time for display. Also converts local date/time into UTC for storage.	The data source is set by using theDataSource and DataField properties, or by using the ExtendedDataType property, or the DataMethod property.	Use this kind of control to show and edit date and time values. For more information, see Time Zone and DateTime Display Controls.
Window	A window that displays a bitmap.	The bitmap can be specified by using theImageName property, the ImageResourceproperty, or the DataSource and DataFieldproperties, or the DataMethod property.	Use this kind of control to add images to a form. For more information about Window controls, see How to: Add an Image to a Form.

See also

How to: Add a Control to a Form

Form Control Properties

Methods on Form Controls

Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).