Overview of Form Control Types [AX 2012]

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.

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.

Animate

该控件用于播放.avi
file.

使用 AnimateFile
属性来设置.avi 文件.

使用该控件来显示动画图片.该.avi文件一定不能有音轨.

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.

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.