com.ms.wfc.data.ui

提供实现并支持数据绑定控件的类。

类

Column

代表DataGrid控件中的单列。

ColumnEditingEve

为DataGrid控件的columnEditing事件提供数据。

ColumnEvent

为DataGrid控件的columnEdited, columnUpdated和headerClick事件提供数据。

ColumnResizeEvent

为DataGrid控件的columnSize事件提供数据。

ColumnUpdatingEvent

为DataGrid控件的columnUpdating事件提供数据。

DataBinder

管理数据源和组件集合之间的绑定集合。

DataBinding

代表数据源中一个字段与组件属性之间的单个绑定关系。

DataGrid

实现了一个数据绑定栅格，其中填充了来自ADO记录集的数据。

DataNavigator

允许用户改变ADO记录集中的当前记录。

DataSource

为组件提供数据。

EnterAction

定义DataGrid控件中ENTER按键行为的常量。

ErrorEvent

为DataGrid控件的error事件提供数据。

GridLineStyle

定义指明DataGrid控件中栅格线风格的常量。

PositionChangeEvent

为DataGrid控件的positionChange事件提供数据。

Scrollbars

定义指明DataGrid控件中显示何种滚动条的常量。

TabAction定义DataGrid控件中TAB按键行为的常量。

代理

ColumnEditingEventHandler

标明处理DataGrid控件columnEditing事件的方法。

ColumnEventHandler

标明处理DataGrid控件columnEdited, columnUpdated或headerClick事件的方法。

ColumnResizeEventHandler

标明处理DataGrid控件columnResize事件的方法。

ColumnUpdatingEventHandler

标明处理DataGrid控件columnUpdating事件的方法。

ErrorEventHandler

标明处理DataGrid控件error事件的方法。

PositionChangeEventHandler

标明处理DataGrid控件positionChange事件的方法。

Column类

代表DataGrid控件中单个的列。

Component
  |
  +-- Column
package com.ms.wfc.data.ui
public final class Column
extends Component

说明

当DataGrid控件绑定到一个记录集时，其就创建一个Column对象集合，每个都分别绑定到记录集中的字段。在栅格中，每个Column对象都显示为一列。每个列的boundFieldName属性标出该列所绑定的字段。缺省地，列的头就设置为绑定字段的名字；然而，你可以通过设置列的caption属性改变头文本。

最初，记录集中的每个字段在栅格中都有一个关联的列，列也按照其在记录集中字段的顺序排列。然而，无论在设计时很少运行时，你都能很容易地在栅格中增加、删除或重新安排列的位置。要通过编程来增加或删除一个列，调用DataGrid控件的addColumn和removeColumn方法。要重新安排列的位置，设置Column对象的index属性即可。

Column对象显示了底层字段数值的字符串表达式。要确定该字段实际的数据类型，调用getDataType方法。要规定数字、日期或布尔值数据类型列的显示格式，调用setDataFormat方法。

在栅格中，Column对象属性的设置与其他的列无关。首先，父DataGrid就提供的属性允许你定义栅格中所有列的缺省属性。然后，使用Column对象属性，你就可以按需要自己定义每个列。例如，设置DataGrid控件的font属性将定义栅格中所有文本的缺省字体；然而，通过设置Column对象的font属性为某一列指定不同的字体。对于特定的列，列属性的设置优先于栅格的设置。

有关然后访问属性窗口中列的属性，请参阅《Microsoft Visual J ++ 6.0程序员指南》第四章“访问数据”中的“访问列属性”一节。

构造器

Column.Column

创建一个Column对象。

语法

public Column ()

说明

要将列绑定到记录集中的字段，调用setBoundFieldName方法。要给DataGrid控件增加一列，调用栅格的addColumn或setColumn方法。

方法

Column.getAlignment

检取一个值，该值指明列中数据的对齐格式。

语法

public int getAlignment ()

返回值

返回com.ms.wfc.ui.ContentAlignment类中定义的一个常量。

请参阅：setAlignment

Column.getAllowSizing

检取一个boolean值，指明在运行时是否可以改变列的大小。

语法

public boolean getAllowSizing ()

返回值

如果允许改变列的大小，就返回true；否则就返回false。更详细的信息，请参阅setAllowSizing。

Column.getBackColor

检取列中单元的背景颜色。

语法

public Color getBackColor ()

返回值

返回一个Color对象，代表列的背景颜色。

说明

当在选中单元时要检取背景颜色，调用getSelectedBackColor。

请参阅：setBackColor, shouldPersistBackColor

Column.getBoundFieldName

检取记录集中与该列绑定的字段名。

语法

public String getBoundFieldName ()

返回值

返回一个字符串，表示记录集中绑定到列的字段名。

请参阅：setBoundFieldName

Column.getCaption检取列头中显示的文本。

语法

public String getCaption()

返回值

返回列当前的标题文本。

请参阅：setCaption

Column.getDataFormat

检取列数据的格式。

语法

public IDataFormat getDataFormat ()

返回值

返回一个实现了IDataFormat界面的对象，指明列中数据的格式。更详细的信息，

请参阅：setDataFormat

Column.getDataType

检取记录集中绑定到该列的字段的数据类型。

语法

public int getDataType ()

返回值

返回一个整数，代表绑定字段的数据类型。该值是com.ms.wfc.data.Ado-Enums.DataType类中定义的一个常量。

Column.getFont

检取列中文本的字体。

语法

public Font getFont ()

返回值

返回一个Font对象，代表列文本所使用的字体。

请参阅：setFont, shouldPersistFont

Column.getForeColor检取列中文本的颜色。

语法

public Color getForeColor ()

返回值

返回一个Color对象，代表列文本的颜色。

说明

要检取在选中单位时的文本颜色，调用getSelectedForeColor方法。

请参阅：setForeColor, shouldPersistForeColor

Column.getIndex

检取栅格中列的索引。

语法

public int getIndex ()

返回值

返回一个零基索引值，指明列当前的位置。

说明

注意，每个列，不管是可见还是不可见的，都有一个索引值。如果你将第一列的visible属性设置为false，其索引值仍然是0。用户实际所看到的第一列仍然是栅格中的第二列，其索引值是1。

请参阅：setIndex

Column.getLeft

检取列的x坐标。

语法

public int getLeft ()

返回值

返回列的x坐标，该坐标位置是相对于父DataGrid控件的坐标而言的。

说明

你可以使用列的left和width属性以及父DataGrid控件的rowTop方法和rowHeight属性来确定栅格中每个单元确切的位置和大小。

Column.getReadOnly

检取一个boolean值，指明列中的数据是否是只读的。

语法

public boolean getReadOnly ()

返回值

如果列标识为只读，就返回true；否则，就返回false。注意，如果父DataGrid控件的allowUpdate属性设置为false，则即使是列中的数据不能修改，getReadOnly方法仍然返回false。

请参阅：setReadOnly

Column.getSelectedBackColor

检取列中所选中单元的背景颜色。

语法

public Color getSelectedBackColor ()

返回值

返回一个Color对象，代表所选中单元的背景颜色。

说明

要确定未选中单元时的背景颜色，调用getBackColor方法。

请参阅：setSelectedBackColor, shouldPersistSelectedForeColor

Column.getSelectedForeColor

检取列中选中文本的颜色。

语法

public Color getSelectedForeColor ()

返回值

返回一个Color对象，代表选中文本的颜色。

说明

要确定未选中时文本的颜色，调用getForeColor方法。

请参阅：setSelectedForeColor, shouldPersistSelectedForeColor

Column.getValue

检取栅格当前行中单元的值。

语法

public String getValue ()

返回值

返回一个字符串，代表栅格当前行中单元的数值。

说明

Column对象的value属性和父DataGrid控件的currentCellValue属性不必引用同一单元。栅格的currentCellValue属性指的是当前行和当前列交点处单元的值。列的value属性是指向栅格当前行中的单元；然而，该列可能不是栅格中的当前列。

请参阅：setValue

Column.getVisible

检取一个boolean值，指明列是否可见（意味着是否能够滚动出现在视图中）。

语法

public boolean getVisible ()

返回值

如果该列可以通过滚动出现在视图中，就返回true；否则，就返回false。

请参阅：setVisible

Column.getWidth

检取列的宽度。

语法

public int getWidth ()

返回值

返回列当前的宽度（以像素为单位）。

请参阅：setWidth

Column.getWrapText

检取一个boolen值，指明列中的文本值是否可以在单元中换行显示。

语法

public boolean getWrapText ()

返回值

如果列中的值可以在单元中换行显示，就返回true；否则，就返回false。

更详细的信息，请参阅setWrapText。

Column.getWriteAllowed

检取一个boolean值，指明底层的字段是否支持写操作。

语法

public boolean getWriteAllowed ()

返回值

如果底层的字段可以写入，就返回true；否则就返回false。如果不能确定该字段是否可以写入，就返回true。

请参阅：getReadOnly

Column.setAlignment

设置列中数据的对齐格式。

语法

public void setAlignment ( int align)

参数

align

com.ms.wfc.ui.ContentAlignment类中定义的一个常量。alignment属性的缺省值是ContentAlignment.MIDDLELEFT。

异常

如果align不是有效的对齐格式，就产生WFCInvalidArgumentException异常。

请参阅：getAlignment

Column.setAllowSizing

设置一个boolean值，指明在运行时是否可以改变列的大小。

语法

public void setAllowSizing (boolean allow)

参数

allow

如果允许改变列的大小，就设置为true；否则就设置为false。allowSizing属性的缺省值是true。

说明

当allowSizing属性设置为true时，当鼠标停留在列头分割栏上时，鼠标指针将呈现为双向箭头，用户通过拖动就可以改变列的大小。

注意：如果父DataGrid控件的columnHeader属性设置为

false，则不显示列头，用户就不能改变列的大小。

要通过编程改变列的大小，调用setWidth方法。注意，如果allowSizing属性设置为false，则设置列的宽度将不起作用。

请参阅：getAllowSizing

Column.setBackColor

设置列中单元的背景颜色。

语法

public void setBackColor (Color color)

参数

color

一个Color对象，代表列的背景颜色。

说明

调用setBackColor来覆盖由父DataGrid控件设置的缺省背景颜色。要在以后重新设置为缺省值，在调用setBackColor时将null做为参数即可。

要设置选中单元的背景颜色，调用setSelectedBackColor方法。

请参阅：getBackColor, shouldPersistBackColor

Column.setBoundFieldName

设置记录集中与该列绑定的字段名。

语法

public void setBoundFieldName ( String name)

参数

name一个字符串，表示记录集中绑定到列的字段名。

说明

当你调用setBoundFieldName方法时，父DataGrid控件将自动将列重新绑定到所指定的字段。列的标题也被更新，以便反映出新的绑定字段。

注意：多行可以绑定到同一字段。

请参阅：getBoundFieldName

Column.setCaption

设置列头中显示的文本。

语法

public void setCaption(String caption)

参数

caption要显示的标题文本。

说明

缺省地，列标题就设置为该列所绑定的字段的名字。将标题设置为null或空字符串将清除标题文本，但不隐藏列头。要隐藏栅格中所有的列头，将父DataGrid控件的columnHeanders属性设置为false。

请参阅：getCaption

Column.setDataFormat

设置列数据的格式。

语法

public void setDataFormat (IDataFormat value)

参数

vlaue

一个实现了IDataFormat界面的对象，指明列中数据的格式。

说明

dataFormat属性影响到栅格列中如何显示数据；其不影响底层的记录集中如何存储数据。你可以为下列的数据类型指定格式：

有关在属性窗口中设置dataFormat属性的信息，请参阅《Microsoft Vis J++ 6.0程序员指南》第四章“访问数据”中的“规定数据格式”一节。

请参阅：getDataFormat

Column.setFont

设置列中文本的字体。

语法

public void setFont (Font font)

参数

font

一个Font对象，代表列文本所使用的字体。

说明

调用setFont方法覆盖由父DataGrid控件所设置的缺省字体。要在以后重新设置为缺省值，将null当作参数传递给setFont方法。

请参阅：getFont, shouldPersistFont

Column.setForeColor

设置列中文本的颜色。

语法

public void setForeColor ( Color color )

参数

color

一个Color对象，代表列文本的颜色。

说明

调用setForeColor方法覆盖由父DataGrid控件设置的缺省文本颜色。要在以后重新设置为缺省值，将null做为参数传递给setForeColor方法。

要设置选中单位的文本颜色，调用setSelectedForeColor方法。

请参阅：getForeColor, shouldPersistForeColor

Column.setIndex

设置栅格中列的索引。

语法

public void setIndex (int index)

参数

index

零基索引值，指明新的列位置。

说明

调用setIndex方法重新设置栅格中的列。当你设置列的index属性时，列就定位到所指定的索引位置处。原来在给位置上的列以及后续的所有列都向右移（意味着它们的索引值都加1）。

注意，每个列，不管是可见还是不可见的，都有一个索引值。如果你将第一列的visible属性设置为false，其索引值仍然是0。用户实际所看到的第一列仍然是栅格中的第二列，其索引值是1。

如果你所指定的索引值超出了栅格列集合的边界范围，则该列就定位到第一个位置或最后的位置上。例如，将列的索引设置为负数就定位到第一个位置。将索引设置为父DataGrid控件的columnCount属性或更大的数，就将列定位到最后的位置上。

请参阅：getIndex

Column.setReadOnly

设置一个boolean值，指明列中的数据是否是只读的。

语法

public void setReadOnly ( boolean readonly)

参数

readonly

如果将列标识为只读从而不允许修改列的值，就设置为true；则，就设置为false。

readOnly属性的缺省值是false。

说明

当列是只读的时候，不能修改列中的数据。如果列的readOnly属性是true，则调用Column.setValue和DataGrid.setCurrentCellValue方法更新记录集都将失败。

当父DataGrid控件的allowUpdate属性是true时，你可以将列的readOnly属性设置为true以便阻止用户修改列中的数据。当allowUpdate属性是false时，列中的数据就是只读的，不管列的readOnly属性设置为何值。

请参阅：getReadOnly

Column.setSelectedBackColor

设置列中所选中单元的背景颜色。

语法

public void setSelectedBackColor (Color color)

参数

color

一个Color对象，代表所选中单元的背景颜色。

说明

调用setSelectedBackColor方法覆盖由父DataGrid控件设置的缺省背景颜色。要在以后重新设置为缺省值，可以将null做为参数传递给setSelectedBackColor方法。

请参阅：getSelectedBackColor, shouldPersistSelectedBackColor

Column.setSelectedForeColor

设置列中选中文本的颜色。

语法

public void setSelectedForeColor (Color color)

参数

color

一个Color对象，代表列中文本的颜色。

说明

调用setSelectedForeColor方法覆盖由父DataGrid控件设置选中文本的缺省颜色。要在以后重新设置为缺省值，可以将null做为参数传递给setSelectedForeColor方法。要设置未选中文本的颜色，调用setForeColor方法。

请参阅：getSelectedForeColor, shouldPersistSelectedForeColor

Column.setValue

设置栅格当前行中单元的值。

语法

public void setValue (String value)

参数

value

一个字符串，代表栅格当前行中单元的格式化数值。

说明

Column对象的value属性和父DataGrid控件的currentCellValue属性不必引用同一单元。栅格的currentCellValue属性指的是当前行和当前列交点处单元的值。列的value属性是指向栅格当前行中的单元；然而，该列可能不是栅格中的当前列。

重点：为了设置value属性，栅格的allowUpdate属性必须设置为true，列的readOnly属性必须设置为false，而且底层的字段也必须是允许修改数据。

传递给setValue的字符串将自动转换为正确的数据类型。列的dataType属性标出底层字段的类型。

请参阅：getValue

Column.setVisible

设置一个boolean值，指明列是否可见（意味着是否能够滚动出现在视图中）。

语法

public void setVisible ( boolean visible)

参数

visible

如果想让该列通过滚动出现在视图中，就设置为true；要隐藏该列，就设置为false。visible属性的缺省值是true。

说明

将visible属性设置为false将简单地隐藏栅格中的列。列仍然拥有自己的索引值，而且仍包括在父DataGrid控件的columnCount属性中。

要真正从栅格中删除一个列，调用DataGrid控件的removeColumn方法。

请参阅：getVisible

Column.setWidth

设置列的宽度。

语法

public void setWidth (int width)

参数

width

新的列宽度（以像素为单位）。

异常

如果width小于DataGrid.MIN_COLUMN_WIDTH就产生WFCInvalidArgument-Exception异常。

说明

如果allowSizing属性设置为true。则在运行时、通过编程或用户就可以改变列的宽度。width属性将自动设置为新的宽度值。之一，如果allowSizing属性设置为false，则不能改变列的宽度。

使用父DataGrid控件的defaultColumnWidth属性设置栅格中所有列的缺省宽度。

请参阅：getWidth

Column.setWrapText

设置一个boolen值，指明列中的文本值是否可以在单元中换行显示。

语法

public void setWrapText (boolean wrap)

参数

wrap

如果列中的值可以在单元中换行显示，就设置为true（为了在单元中输入多行文本，需要设置父DataGrid控件的rowHeight属性）。如果只允许输入文本多到单元边界，就设置false。wrapText属性的缺省值是false。

更详细的信息，请参阅getWrapText。

Column.shouldPersistBackColor

指明列背景颜色是否应该永久性保存。

语法

public boolean shouldPersistBackColor ()

返回值

如果要永久性保存列背景颜色，就返回true；否则，就返回false。

说明

通常在Forms Designer内部使用该方法。

Column.shouldPersistFont

指明列的字体是否应该永久性保存。

语法

public boolean shouldPersistFont ()

返回值

如果要永久性保存列的字体，就返回true；否则，就返回false。

说明

通常在Forms Designer内部使用该方法。

Column.shouldPersistForeColor

指明列前景颜色是否应该永久性保存。

语法

public boolean shouldPersistForeColor ()

返回值

如果要永久性保存列前景颜色，就返回true；否则，就返回false。

说明

通常在Forms Designer内部使用该方法。

Column.shouldPersistSelectedBackColor

指明列中所选中单元的背景颜色是否应该永久性保存。

语法

public boolean shouldPersistSelectedBackColor ()

返回值

如果要永久性保存列中所选中单元的背景颜色，就返回true；否则，就返回false。

说明

通常在Forms Designer内部使用该方法。

Column.shouldPersistSelectedForeColor

指明列中所选中单元的前景颜色是否应该永久性保存。

语法

public boolean shouldPersistSelectedForeColor ()

返回值

如果要永久性保存列中所选中单元的前景颜色，就返回true；否则，就返回false。

说明

通常在Forms Designer内部使用该方法。

Column.toString

检取列的描述信息。

语法

public String toString ()

返回值

返回列的描述信息字符串。

说明

toString所返回的字符串提供了下列有关列的信息：

* 类名。

* 绑定字段的名字。

* 记录集中字段的索引。

* 列的索引。

ColumnEditingEvent类

为DataGrid控件的columnEditing事件提供数据。

Event
  |
  + -- ColumnEditingEvent

package com.ms.wfc.data.ui

public final class ColumnEditingEvent

extends Event

说明

当单元进入编辑状态时就触发columnEditing事件。ColumnEditingEvent对象指明要被编辑的列以及触发该事件所按下的键，并提供取消该事件的标记。

有关WFC事件模型的信息，请参阅《Microsoft Visual J++ 6.0 程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

字段

ColumnEditingEvent.cancel

指明是否取消该事件。

语法

public boolean cancel ;

说明

将该字段设置为true将取消columnEditing事件并退出单元的编辑模式。

ColumnEditingEvent.column

指明正在被编辑列的零基索引值。

语法

public final int column ;

ColumnEditingEvent.keyAscii

指明触发该事件所按下的键的ASCII码。

语法

public final int keyAscii;

说明

如果用户按下的是F2或使用鼠标进入编辑模式，该字段的值就是0。

构造器

ColumnEditingEvent.ColumnEditingEvent

创建一个ColumnEditingEvent对象。

语法

public ColumnEditingEvent ( int column, int keyAscii, booleancancel )

参数

column

正被编辑列的零基索引值。

keyAscii

触发该事件所按下的键的ASCII码。如果用户按下的是F2或使用鼠标进入编辑模式，该值就是0。

cancel

取消标记的缺省值。设置为true将取消该事件；否则，就设置为false。

ColumnEditingEventHandler代理

标明处理DataGrid控件的columnEditing事件的方法。

package com.ms.wfc.data.ui

public multicast delegate

void ColumnEditingEventHandler (Object sender,ColumnEditingEvent e ) ;

说明

该ColumnEditingEventHandler 代理的语法指明了事件处理器的结构，其中sender是事件源，e是提供事件数据的ColumnEditingEvent对象。

当你创建ColumnEditingEventHandler 代理时，你就指明了处理事件的方法。一旦该代理指定给事件，则当该事件发生时将自动激活处理器方法。

有关代理的更详细的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

ColumnEvent类

为DataGrid控件的columnEdited, columnUpdated和headerClick事件提供数据。

Event
  |
  + -- ColumnEvent

package com.ms.wfc.data.ui

public final class ColumnEvent

extends Event

说明

ColumnEvent对象指明栅格中哪个列是事件的目的地。有关WFC事件模型的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

字段

ColumnEvent.column

指明该事件所作用列的零基索引。

语法

public int column;

构造器

ColumnEvent.ColumnEvent

创建一个ColumnEvent对象。

语法

public ColumnEvent ( int column )

参数

column

该事件所作用列的零基索引值。

ColumnEventHandler代理

标明处理DataGrid控件的columnEdited, columnUpdated或headerClick事件的方法。

package com.ms.wfc.data.ui

public multicast delegate

void ColumnEventHandler (Object sender, ColumnEvent e ) ;

说明

该ColumnEventHandler 代理的语法指明了事件处理器的结构，其中sender是事件源，e是提供事件数据的ColumnEvent对象。

当你创建ColumnEventHandler 代理时，你就指明了处理事件的方法。一旦该代理指定给事件，则当该事件发生时将自动激活处理器方法。

有关代理的更详细的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

ColumnResizeEvent类

为DataGrid控件的columnResize事件提供数据。

Event
  |
  + --

ColumnResizeEvent

package com.ms.wfc.data.ui

public class ColumnResizeEvent

extends Event

说明

当栅格中某列改变了大小时（无论是通过编程还是用户）就触发columnResize事件。ColumnResizeEvent对象指明了正被改变大小的列和列新的宽度，并提供一个取消事件的标记。

有关WFC事件模型的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

字段

ColumnResizeEvent.cancel

指明该事件是否被取消。

语法

public boolean cancel;

说明

将该字段设置为true将取消ColumnResizeEvent事件并恢复该列原来的宽度。

ColumnResizeEvent.column

指明正被改变大小的列的零基索引。

语法

public int column;

ColumnResizeEvent.newWidth

指明列新的宽度值。

语法

public int newWidth;

构造器

ColumnResizeEvent.ColumnResizeEvent

创建一个ColumnResizeEvent对象。

语法

public ColumnResizeEvent ( int column, int newWidth, booleancancel )

参数

column

正被改变大小的列的零基索引。

newWidth

列的新宽度。

cancel

取消标记的缺省值。设置为true将取消该事件；否则，就设置为false。

ColumnResizeEventHandler代理

标明处理DataGrid控件的columnResize事件的方法。

package com.ms.wfc.data.ui

public multicast delegate

void ColumnResizeEventHandler (Object sender,ColumnResizeEvent e ) ;

说明

该ColumnResizeEventHandler 代理的语法指明了事件处理器的结构，其中sender是事件源，e是提供事件数据的ColumnResizeEvent对象。

当你创建ColumnResizeEventHandler 代理时，你就指明了处理事件的方法。一旦该代理指定给事件，则当该事件发生时将自动激活处理器方法。

有关代理更详细的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

ColumnUpdatingEvent类

为DataGrid控件的columnUpdating事件提供数据。

Event

 |

 + -- ColumnUpdatingEvent

package com.ms.wfc.data.ui

public final class ColumnUpdatingEvent

extends Event

说明

当用户改变了栅格中单元的值但在新值写入底层的记录集之前触发columnUpdating事件。ColumnUpdatingEvent对象指明了要更新的列以及该列以前的值，并提供一个取消事件的标记。

有关WFC事件模型的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

字段

ColumnUpdatingEvent.cancel

指明该事件是否被取消。

语法

public boolean cancel;

说明

将该字段设置为true将取消ColumnUpdatingEvent事件并恢复该单元原来的值。

ColumnUpdatingEvent.column

指明要更新列的零基索引。

语法

public int column;

ColumnUpdatingEvent.oldValue

指明列中原来使用的值（该值改变之前的值）。

语法

public int oldValue;

构造器

ColumnUpdatingEvent.ColumnUpdatingEvent

创建一个ColumnUpdatingEvent对象。

语法

public ColumnUpdatingEvent ( int column, String oldvalue, booleancancel )

参数

column

要更新列的零基索引。

oldValue

列原来的值（修改之前的值）。

cancel

取消标记的缺省值。设置为true将取消该事件；否则，就设置为false。

ColumnUpdatingEventHandler代理

标明处理DataGrid控件的columnUpdating事件的方法。

package com.ms.wfc.data.ui

public multicast delegate

void ColumnUpdatingEventHandler (Object sender,ColumnUpdatingEvent e ) ;

说明

该ColumnUpdatingEventHandler 代理的语法指明了事件处理器的结构，其中sender是事件源，e是提供事件数据的ColumnUpdatingEvent对象。

当你创建ColumnUpdatingEventHandler 代理时，你就指明了处理事件的方法。一旦该代理指定给事件，则当该事件发生时将自动激活处理器方法。

有关代理更详细的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。

DataBinder类

管理数据源和组件集合之间的绑定集合。

Component
   |
   +-- DataBinder

package com.ms.wfc.data.ui

public class DataBinder

extends Component

implements IDataSourceListener

说明

通常，组件指可视的控件，数据源指记录集。绑定控件可以在属性和数据源的字段之间交换数据。复杂的控件如DataGrid控件，可以直接绑定到数据源。简单的控件如编辑框或复选框，需要一个DataBinder控件来协助绑定。

每个绑定都由一个DataBinding对象来表示。

请参阅：《Microsoft Visual J++ 6.0 程序员指南》第18章“WFC中的数据绑定”。

构造器

DataBinder.DataBinder

创建一个DataBinder对象。

语法

public DataBinder ()

public DataBinder ( Recordset dataSource )

public DataBinder ( Recordset dataSource, DataBinding[] bindings )

参数

dataSource

绑定到DataBinder控件的Recordset对象。

bindings

DataBinding对象矩阵，将组件属性绑定到dataSource对象。

说明

第一种语法创建一个没有绑定的DataBinder控件。第二种语法将DataBinder与指定的记录集绑定但没有缺省绑定。第三种语法将DataBinder控件绑定到指定的记录集，并指明绑定矩阵。

方法

DataBinder.addBinding

给绑定集合增加一个新的绑定。

语法

public void addBinding ( DataBinding newBinding )

public void addBinding ( IComponent target, String propertyName,String fieldName )

参数

newBinding

代表要增加绑定的DataBinding对象。

target

要绑定的组件。

propertyName

要绑定的目的地对象的属性名字。

fieldName

要绑定的底层记录集字段名字。

说明

该绑定将以只读的方式工作除非target参数支持属性修改通知。更详细的信息，请参阅“简单数据绑定”。

请参阅：removeBinding

DataBinder.clearBindings

删除所有当前的绑定。

语法

public void clearBindings ()

请参阅：addBinding, removeBinding

DataBinder.commitChanges

将控件中的修改内容提交给数据源。

语法

public void commitChanges ()

说明

如果底层的数据源是可以更新的，则对绑定组件的修改信息将传播给数据源。

DataBinder.getBindings

检取当前所有绑定的矩阵。

语法

public DataBinding[] getBindings ()

返回值

返回一个DataBinding对象矩阵。

请参阅：setBindings

DataBinder.getDataMember

检取DataBinder控件底层数据源的绑定成员。

语法

public String getDataMember ()

返回值

返回一个字符串，包含了绑定数据成员的名字。如果没有明确地设置数据成员，就返回缺省的成员。

请参阅：setDataMember, setDataSource

DataBinder.getDataSource

检取DataBinder控件底层的数据源。

语法

public IDataSource getDataSource ()

返回值

返回一个支持IDataSource界面的对象。

请参阅：setDataSource

DataBinder.removeBinding

删除指定的绑定。

语法

public void removeBinding ( DataBinding removeBinding )

public void removeBinding ( Object target, String propertyName)

参数

removeBinding

一个DataBinding对象，代表要删除的绑定。

target

要从中删除绑定的对象。

propertyName

要从中删除绑定的属性名字。

请参阅：addBinding, clearBindings

DataBinder.setBindings

设置DataBinder控件当前的绑定。

语法

public void setBindings ( DataBinding[] bindings )

参数

bindings

DataBinding对象矩阵。

请参阅：getBindings

DataBinder.setDataMember

设置DataBinder控件底层数据源的绑定成员。

语法

public void setDataMember ( String m_dataMember )

参数

m_dataMember

绑定数据成员的名字。

请参阅：getDataMember, getDataSource

DataBinder.setDataSource

设置DataBinder控件底层的数据源。

语法

public void setDataSource ( IDataSource value )

参数

value

支持IDataSource界面的对象。

请参阅：getDataSource