DataBinding 类

DataBinding类

代表数据源字段和组件属性之间一个单独的绑定。

package com.ms.wfc.data.ui

public class DataBinding

implements IConstructable

说明

DataBinder控件使用该类来表示数据源中的每一个绑定。

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

构造器

DataBinding.DataBinding

创建一个DataBinding对象。

语法

public DataBinding ()

public DataBinding ( IComponent target, String propertyName,String fieldName )

public DataBinding ( IComponent target, String propertyName,String fieldName, IDataFormat format )

参数

target

要绑定的组件。

propertyName

要绑定的目的地组件的属性名。

fieldName

为propertyName属性提供数据的数据源中的字段名字。

format

用于规定绑定数据格式的IDataFormat对象。

方法

DataBinding.bindTarget

使能或禁止绑定组件属性修改通知。

语法

public void bindTarget ( boolean bind )

参数

bind

设置为true，则DataBinding对象就可以检取绑定属性的修改通

知；否则，就设置为false。

DataBinding.commitChanges

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

语法

public void commitChanges()

说明

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

DataBinding.getDataFormat

检取与该绑定关联的数据格式。

语法

public IDataFormat getDataFormat ()

返回值

返回支持IDataFormat界面的对象。

说明

可以使用IDataFormat界面规定显示给用户的数据格式。

请参阅：setDataFormat

DataBinding.getDataSource

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

语法

public Recordset getDataSource ()

返回值

返回底层的Recordset对象。

请参阅：setDataSource

DataBinding.getFieldName

检取与该绑定关联的数据字段名字。

语法

public String getFieldName ()

返回值

返回绑定数据字段的名字。

请参阅：setFieldName

DataBinding.getPropertyName

检取与该绑定关联的属性名字。

语法

public String getPropertyName ()

返回值

返回绑定属性的名字。

请参阅：setPropertyName

DataBinding.getPropertyValue

检取绑定组件属性的值。

语法

public Object getPropertyValue ()

返回值

返回绑定属性当前的值。

说明

直接从属性检取值；不使用绑定字段。

请参阅：setPropertyValue

DataBinding.getTarget

检取与该绑定关联的绑定组件。

语法

public IComponent getTarget ()

返回值

返回绑定组件，其支持IComponent界面。

请参阅：setTarget

DataBinding.refreshPropertyValue

将绑定组件的属性更新为数据源中的数据。

语法

public void refreshPropertyValue ()

请参阅：setPropertyValue

DataBinding.setDataFormat

设置该绑定的数据格式。

语法

public void setDataFormat ( IDataFormat format )

参数

format

支持IDataFormat界面的对象。

说明

可以使用IDataFormat界面规定表示给用户的数据格式。

请参阅：getDataFormat

DataBinding.setDataSource

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

语法

public void setDataSource ( Recordset value )

参数

value与该绑定关联的Recordset对象。

请参阅：getDataSource

DataBinding.setFieldName

设置与该绑定关联数据字段的名字。

语法

public void setFieldName ( String name )

参数

name

要绑定的数据字段的名字。

请参阅：getFieldName

DataBinding.setPropertyName

设置与该绑定关联的属性名字。

语法

public void setPropertyName ( String name )

参数

name

要绑定的属性名字。

请参阅：getPropertyName

DataBinding.setPropertyValue

设置绑定组件的属性值。

语法

public void setPropertyValue ( Object value )

参数

value

使用该对象的内容设置属性值。

说明

直接从value 参数值设置属性值；不使用绑定字段。

请参阅：getPropertyValue

DataBinding.setTarget

设置与该绑定关联的组件。

语法

public void setTarget ( IComponent target )

参数

target

支持IComponent界面的绑定组件。

请参阅：getTarget

DataGrid类

实现一个数据绑定栅格，填充来自ADO记录集的数据。栅格中的行和列代表记录集中的记录和字段。

Component
  |
  +-- Control
     |
     + -- DataGrid

package com.ms.wfc.data.ui

public class DataGrid

extends Control

说明

要将DataGrid控件绑定到记录集，需设置它的dataSource属性（或可选的，dataMember属性）。当DataGrid控件被绑定时，其就自动填充数据。

重点：你不能将DataGrid控件与只有前向游标的记录集绑定起来。记录集必须支持书签。

如果记录集允许编辑、增加或删除，你就可以DataGrid控件的属性以便决定是否使用栅格来修改记录集。例如，allowUpdate和allowDelete属性指明记录集是否可以通过栅格来编辑或删除。如果allowAddNew和allowUpdate属性都设置为true，则用户就可以给栅格增加新的行，从而为记录集增加新的记录。通过DataGrid控件所做的修改将自动传播给记录集，反之亦然。

栅格中拥有输入焦点的单元以加重边框显示，称为当前单元。要指定当前的单元，用户可以使用鼠标点击该单元或使用键盘来指定（allowArrows, enterAction和tabAction属性确定哪个键可以移动当前单元的输入焦点）。要通过编程来指定当前的单元，可以调用setCurrentRow和setCurrentColumn方法。当前行和当前列的交点就决定了当前的单元（注意，改变栅格中的当前行也将改变底层记录集中当前的记录，反之亦然）。

当单元是当前单元时，就可以修改其内容（只要allowUpdate属性是true而且记录集允许数据修改）。要将当前单元设置为编辑模式，用户可以按下F2，点击该单元或简单地键盘输入来替换单元的内容。要退出编辑模式，用户可以再次按下F2或点击单元以外的地方。

当单元进入编辑模式时，就触发columnEditing事件。该事件指明正被编辑的列以及按下了什么键才触发了该事件。在用户完成输入工作并退出编辑模式后，就按指定的顺序触发下列事件：

* updating 在底层记录集更新为新值之前发生；不提供有关更新的信息。

* columnUpdating 在记录集更新为新值之前发生；该事件指明正被更新的列以及该单元原来的值。

* updated 在记录集更新为新值之后发生；不提供有关更新的信息。

* columnUpdated 在记录集更新为新值之后发生；该事件指明被更新过的列。

* columnEdited 指明编辑完成。该事件指明被编辑过的列。

如果单元中的实际数据值保持不变，或用户只是简单地进入并离开编辑模式而没有输入任何信息，则只触发columnEditing和columnEdited事件。

注意：如果你通过编程调用setCurrentCellValue方法来改变单元的值，则不触发任何的事件。

DataGrid控件支持选择整个的行和列，但不支持只选择单个的单元。用户点击行头或列头就可以选择一行或一列；通过按下CTRL键，就可以选择多行或多列。要通过编程选择行或列，调用setSelectedRows和setSelectedColumns方法。

DataGrid控件中的每一列都是Column对象，该对象底层记录集的字段绑定。每个列都包含与其他列对立的属性。DataGrid控件的属性可用于定义栅格中所有列的缺省值。使用Column对象属性，你就可以根据需要自己定义单个列。例如，设置DataGrid控件的font属性将定义栅格中所有文本的缺省字体；然后，通过设置某Column对象的font属性来指定该列使用不同的字体。列的属性值优先于栅格所指定的设置值。

DataGrid控件使用零基索引标识栅格中的每一列。该索引指明了栅格中列的位置。通过设置列的index属性，你就可以重新安排栅格中的列。注意，每个列都有一个索引，即使你隐藏了该列。例如，如果你将第一列的visible属性设置为false，则该列仍然具有索引值0；一行所看到的第一列是栅格中的第二列，其索引值是1。

当栅格中的列以索引值来标识时，底层记录集中的记录就使用书签来标识。例如，要通过编程改变栅格当前的行，你可以调用setCurrentRows方法并指明要修改为当前行的相应记录的书签。

对于在栅格中当前滚动位置中可视的行，你可以调用getDisplayIndex方法来确定行显示的次序。当你将书签传递给该方法，该方法就返回相应行零基显示索引值（只要该行可视）。

有关Forms Designer中如何使用DataGrid控件的信息，请参阅《Microsoft Visual J++ 6.0 程序员指南》第4章“访问数据”中的“数据和DataGrid控件的绑定”一节。

字段

DataGrid.MIN_COLUMN_WIDTH

指明栅格中列的最小宽度（以像素为单位）。

语法

public static final int MIN_COLUMN_WIDTH;

说明

栅格中列所改变的大小不能比MIN_COLUMN_WIDTH还小（缺省地，该常量定义为10）。

请参阅：Column.setWidth

DataGrid.MIN_ROW_HEIGHT

指明栅格中列的最小高度（以像素为单位）。

语法

public static final int MIN_ROW_HEIGHT;

说明

栅格中列所改变的大小不能比MIN_ROW_HEIGHT还小（缺省地，该常量定义为10）。

请参阅：setRowHeight

构造器

DataGrid.DataGrid

创建一个DataGrid对象。

语法

public DataGrid ()

说明

一旦你创建了一个DataGrid控件，就可以调用setDataSource（或可选的，setDataMember）方法将栅格绑定到记录集并填充数据。

方法

DataGrid.addColumn

给DataGrid控件增加一列。

语法

public Column addColumn ( String boundFieldName )

public Column addColumn ( Column toAdd )

参数

boundFieldName

底层记录集中要绑定到新行的字段名字。注意，多列可以绑定到同一个字段。

toAdd

代表要增加列的Column对象。

说明

新列添加在栅格的最右端。要改变列的位置，设置其index属性即可。

请参阅：removeColumn

DataGrid.addOnColumnEdited

为columnEdited事件指定一个代理。

语法

public void addOnColumnEdited ( ColumnEventHandler handler )

参数

handler

当事件发生时要通知的ColumnEventHandler 代理。

说明

当单元退出编辑模式时就触发columnEdited事件。有关更详细的信息，请参阅DataGrid概述。

请参阅：removeOnColumnEdited

DataGrid.addOnColumnEditing

为columnEditing事件指定一个代理。

语法

public void addOnColumnEditing ( ColumnEditingEventHandlerhandler )

参数

handler

当事件触发时要通知的ColumnEditingEventHandler 代理。

说明

当单元进入编辑模式时就触发columnEditing事件。有关更详细的信息，请参阅DataGrid概述。取消columnEditing事件将退出单元的编辑模式并阻止updating, columnUpdating, updated, columnU0pdated和columnEdited事件的发生。

请参阅：removeOnColumnEditing

DataGrid.addOnColumnResize

为columnResize事件指定一个代理。

语法

public void addOnColumnResize ( ColumnResizeEventHandlerhandler )

参数

handler

当事件发生时要通知的ColumnResizeEventHandler 代理。

说明

当单元改变大小（通过编程或用户）时就触发columnResize事件。要通过编程改变列的大小，调用setWidth方法。

注意：只有allowSizing属性设置为true时才能改变列的大小。取消columnResize事件将恢复列原来的宽度。

请参阅：removeOnColumnResize

DataGrid.addOnColumnUpdated

为columnUpdated事件指定一个代理。

语法

public void addOnColumnUpdated ( ColumnEventHandlerhandler )

参数

handler

当事件发生时要通知的ColumnEventHandler 代理。

说明

当用户改变了单元的值并更新底层的记录集时就触发columnUpdated事件。有关更详细的信息，请参阅DataGrid概述。

注意：只有记录集允许修改、DataGrid控件的allowUpdate属性设置为true而且单元列的readOnly属性设置为false时才能修改单元的值。

请参阅：removeOnColumnUpdated

DataGrid.addOnColumnUpdating

为columnUpdating事件指定一个代理。

语法

public void addOnColumnUpdating( ColumnUpdatingEventHandler handler )

参数

handler

当事件发生时要通知的ColumnUpdatingEventHandler 代理。

说明

当用户改变了单元的值并更新底层的记录集之前触发

columnUpdated事件。有关更详细的信息，请参阅DataGrid概述。

注意：只有记录集允许修改、DataGrid控件的allowUpdate属性设置为true而且单元列的readOnly属性设置为false时才能修改单元的值。

取消columnUpdating事件将恢复单元原来的值并阻止updated和columnUpdated事件的发生。

请参阅：removeOnColumnUpdating

DataGrid.addOnDeleted

为deleted事件指定一个代理。

语法

public void addOnDeleted ( EventHandler handler )

参数

handler

当事件发生时要通知的EventHandler 代理。

说明

当用户选择了一行或多行并按下DELETE键时就触发deleting事件。然后从底层的记录集中删除记录并触发deleted事件。

请参阅：removeOnDeleted

DataGrid.addOnDeleting

为deleting事件指定一个代理。

语法

public void addOnDeleting ( ColumnEventHandler handler )

参数

handler

当事件发生时要通知的ColumnEventHandler 代理。

说明

当用户选择了一行或多行并按下DELETE键时就触发deleting事件。然后从底层的记录集中删除记录并触发deleted事件。

要确定选择了哪些行要删除，调用getSelectRows。

注意：只有记录集允许删除而且DataGrid控件的allowDelete属性设置为true时用户才能从栅格中删除一行。

取消deleting事件将恢复所删除的行并阻止deleted事件的发生。

请参阅：removeOnDeleting

DataGrid.addOnError

为error事件指定一个代理。

语法

public void addOnError ( ErrorEventHandler handler )

参数

handler

当事件发生时要通知的ErrorEventHandler 代理。

说明

ADO异常的结果就是触发error事件。

请参阅：removeOnError

DataGrid.addOnHeaderClick

为headerClick事件指定一个代理。

语法

public void addOnHeaderClick ( ColumnEventHandler handler )

参数

handler

当事件发生时要通知的ColumnEventHandler 代理。

说明

当用户点击列头时就触发headerClick事件。如果columnHeaders属性设置为true时就显示列头信息。

点击列头也同时选中该列。在headerClick事件发生后，就触发selChange事件。

请参阅：removeOnHeaderClick

DataGrid.addOnInserted

为inserted事件指定一个代理。

语法

public void addOnInserted ( EventHandler handler )

参数

handler

当事件发生时要通知的EventHandler 代理。

说明

当用户第一次点击栅格中的空白行时就触发inserting事件。然后底层的记录集就增加了一个空记录，并触发inserted事件。

在inserted事件之后就触发columnEditing事件以便处理对单元数据的编辑。

请参阅：removeOnInserted

DataGrid.addOnInserting

为inserting事件指定一个代理。

语法

public void addOnInserting ( CancelEventHandler handler )

参数

handler

当事件发生时要通知的CancelEventHandler 代理。

说明

当用户第一次点击栅格中的空白行时就触发inserting事件。然后底层的记录集就增加了一个空记录，并触发inserted事件。

注意：只有记录集允许增加而且DataGrid控件的allowAddNew和allowUpdate属性都设置为true时用户才能给栅格增加新行。

取消inserting事件将阻止添加新行并阻止触发inserted事件。

请参阅：removeOnInserting

DataGrid.addOnPositionChange

为positionChange事件指定一个代理。

语法

public void addOnPositionChange ( PositionChangeEventHandlerhandler )

参数

handler

当事件发生时要通知的PositionChangeEventHandler 代理。

说明

当通过编程或用户在栅格中移动当前位置时就触发positionChange事件。要通过编程改变当前的位置，就调用setCurrentColumn或setCurrentRow方法。用户可以使用鼠标选择另外的单元或使用键盘移动到另外的单元而改变当前的位置（allowArrows, enterAction和tabAction属性决定栅格中如何使用键盘）。

请参阅：removeOnPositionChange

DataGrid.addOnRowResize

为rowResize事件指定一个代理。

语法

public void addOnRowResize ( CancelEventHandler handler )

参数

handler

当事件发生时要通知的CancelEventHandler 代理。

说明

当通过编程或用户改变了行的大小时就触发rowResize事件。要通过编程改变行的大小，就调用setRowHeight。

注意：只有allowRowSizing属性设置为true时才能改变行的大小。

取消rowResize事件将恢复行原来的高度。

请参阅：removeOnRowResize

DataGrid.addOnScroll

为scroll事件指定一个代理。

语法

public void addOnScroll ( CancelEventHandler handler )

参数

handler

当事件发生时要通知的CancelEventHandler 代理。

说明

当通过变化或用户滚动栅格时就触发scroll事件。要通过编程滚动栅格，调用scroll, makeCurrentCellVisible, setFirstRow或setLeftColumn。用户可以使用滚动条或键盘滚动栅格（allowArrows, enterAction和tabAction属性确定栅格中如何使用键盘）。在拖动滚动条时，当是否滚动按钮时就触发scroll事件。

取消scroll事件将恢复行栅格原来的滚动位置。

请参阅：removeOnScroll

DataGrid.addOnSelChange

为selChange事件指定一个代理。

语法

public void addOnSelChange ( CancelEventHandler handler )

参数

handler

当事件发生时要通知的CancelEventHandler 代理。

说明

当通过编程或用户选择栅格中的行或列时就触发selChange事件。要通过编程选择行或列，调用setSelectedRows或setSelectedColumns方法。用户可以通过分别点击行选择器或列头来选择行或列。如果rowSelectors和columnHeaders属性设置为true时显示行选择器和列头。

注意：当用户点击列头时，在setChange事件之前触发headerClick事件。取消selChange事件将恢复栅格原来的选择。

请参阅：removeOnSelChange

DataGrid.addOnUpdated

为updated事件指定一个代理。

语法

public void addOnUpdated ( EventHandler handler )

参数

handler

当事件发生时要通知的EventHandler 代理。

说明

当用户改变单元的值并更新底层的记录集时就触发updated事件。有关更详细的信息，请参阅DataGrid概述。

注意：只有记录集允许修改、DataGrid控件的allowUpdate属性设置为true以及单元列的readOnly属性设置为false时用户才能修改单元的值。

请参阅：removeOnUpdated

DataGrid.addOnUpdating

为updating事件指定一个代理。

语法

public void addOnUpdating ( CancelEventHandler handler )

参数

handler

当事件发生时要通知的CancelEventHandler 代理。

说明

当用户改变了单元的值但在更新底层的记录集之前触发updating事件。有关更详细的信息，请参阅DataGrid概述。

注意：只有记录集允许修改、DataGrid控件的allowUpdate属性设置为true以及单元列的readOnly属性设置为false时用户才

能修改单元的值。取消updating事件将恢复单元原来的值并阻止updated和columnUpdated事件的发生。

请参阅：removeOnUpdating

DataGrid.clearColumns

删除栅格中所有的列。

语法

public void clearColumns ()

说明

要重新填充栅格中的数据，你可以：

?调用rebind方法，从记录集中增加缺省的列集合。

?调用addColumn方法增加单独的行。

?调用setColumns方法，如果你已经保存了以前构造的Column对象矩阵。

要从栅格中栅格单独的行，可以调用removeColumn。

DataGrid.clearSelection

删除栅格中的选择内容。

语法

public void clearSelection ()

请参阅：setSelectedColumns, SetSelectedRows

DataGrid.getAllowAddNew

检取一个boolean值，指明栅格中是否允许增加新的行（前提是底层的记录集允许增加新的记录）。

语法

public boolean getAllowAddNew ()

返回值

如果用户可以给栅格增加新的行就返回true；否则，就返回false。更多的信息，请参阅setAllowAddNew。

DataGrid.getAllowArrows

检取一个boolean值，指明是否可以使用方向键在栅格中移动。

语法

public boolean getAllowArrows ()

返回值

如果允许使用方向键在栅格中移动输入焦点就返回true；否则，就返回false。

请参阅：setAllowArrows

DataGrid.getAllowDelete

检取一个boolean值，指明用户是否可以从栅格中删除行（前提是底层的记录集允许删除记录）。

语法

public boolean getAllowDelete ()

返回值

如果用户可以从栅格中删除行，就返回true；否则，就返回false。更多的信息，请参阅setAllowDelete。

DataGrid.getAllowRowSizing

检取一个boolean值，指明在运行时是否允许改变栅格中行的大小。

语法

public boolean getAllowRowSizing ()

返回值

如果可以改变栅格中行的高度就返回true；否则，就返回false。

请参阅：setAllowRowSizing

DataGrid.getAllowUpdate

检取一个boolean值，指明是否可以修改栅格中的数据（前提是底

层的记录集允许修改）。

语法

public boolean getAllowUpdate ( )

返回值

如果可以修改栅格中的数据就返回true；否则，就返回false。更多的信息，请参阅setAllowUpdate。

DataGrid.getApproxRowCount

检取DataGrid控件中大约的行数。

语法

public int getApproxRowCount ()

返回值

返回栅格中大约的行数。

异常

如果DataGrid控件没有绑定就引发WFCInvalidArgumentException异常。

说明

getApproxRowCount返回的值用于调整垂直滚动条。

DataGrid.getBorderStyle

检取DataGrid控件边框当前的风格。

语法

public int getBorderStyle ()

返回值

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

请参阅：setBorderStyle

DataGrid.getCaption

检取栅格顶部标题栏中显示的文本。

语法

public String getCaption ()

返回值

返回一个字符串，代表当前标题栏中的文本。如果栅格没有标题栏，就返回空字符串。

请参阅：setCaption

DataGrid.getColumn检取指定索引位置上的列。

语法

public Column getColumn ( int index )

参数

index

要检取列的零基索引值。列的索引值指明了列在栅格中的位置。最后一列的索引值是getColumnCount的

返回值

减1。更多的信息，请参阅Column对象的index属性。

返回值

返回一个Column对象，代表指定索引位置处的列。

异常

如果index不是有效的列索引值，就引发WFCInvalidArgumentException异常。

说明

要检取栅格中所有的列，调用getColumns方法。

DataGrid.getColumnCount

检取栅格中列的数目，不管是可视的还是隐藏的。

语法

public int getColumnCount ()

返回值

返回栅格中列的数目。

说明

getColumnCount方法返回的值包括栅格中所有的列，即使该列的visible属性设置为false。

要检取栅格中当前滚动位置上可视的列数目，调用getVisibleColumns。

DataGrid.getColumnHeaders

检取一个boolean值，指明是否显示列头信息。

语法

public boolean getColumnHeaders ()

返回值

如果显示列头信息，就返回true；否则，就返回false。

请参阅：setColumnHeaders

DataGrid.getColumns

检取栅格中所有列构成的集合。

语法

public Column[] getColumns ()

返回值

返回代表栅格中所有列的Column对象矩阵。矩阵中元素的排列次序与栅格中所显示的次序相对应。如果栅格不包含任何列，就返回空矩阵。

说明

getColumns返回的列矩阵包括栅格中所有的列。即使该列的visible属性设置为false。矩阵中列的数量就是getColumnCount所返回的值。

要检取栅格中单个的列，调用getColumn方法。

请参阅：setColumns

DataGrid.getCurrentCellValue

检取当前单元的值。

语法

public String getCurrentCellValue ()

返回值

返回一个字符串，代表当前单元格式化数据的值。

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

请参阅：setCurrentCellValue

DataGrid.getCurrentCellVisible

检取一个boolean值，指明当前单元是否完全可见。

语法

public boolean getCurrentCellVisible ()

返回值

如果单元在栅格当前的滚动位置完全可见，就返回true；否则，就返回false。

说明

如果getCurrentCellVisible返回false，你可以调用makeCurrentCellVisible方法滚动栅格从而将完整的单元滚动进入视图。

DataGrid.getCurrentColumn

检取栅格当前的列。

语法

public Column getCurrentColumn ()

返回值

返回一个Column对象，代表栅格当前的列。如果当前没有列，就返回null。

请参阅：setCurrentColumn

DataGrid.getCurrentRow

检取栅格当前的行。

语法

public Column getCurrentRow ()

返回值

返回当前行的书签。

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

请参阅：setCurrentRow

DataGrid.getCurrentRowModified

检取一个boolean值，指明当前行中的数据是否已经被修改了。

语法

public boolean getCurrentRowModified ()

返回值

如果当前行中的数据是否已经被修改但还没有更新底层的记录集，就返回true；否则就返回false。

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

说明

如果当前行中的任一值通过编程或被用户改变，currentRowModified属性就自动设置为true。当另外的行变成当前行时，该属性又重新设置为false。要通过编程改变当前单元中的值，调用setCurrentCellValue方法。重点：为了改变当前单元的值，allowUpdate属性必须设置为true，单元所在列的readOnly属性必须设置为false，而且记录集也必须允许进行数据修改。DataGrid.getDataMember检取DataGrid控件底层数据源的绑定成员。

语法

public String getDataMember ()

返回值

返回一个字符串，指明底层数据源的绑定成员。该字符串要么是绑定记录集的名字，要么是空字符串。更多的信息，请参阅setDataMember。

说明

要检取底层的数据源对象，调用getDataSource方法。

DataGrid.getDataSource

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

语法

public IDataSource getDataSource ()

返回值

返回实现了IDataSource界面的对象，该对象输出当前绑定到DataGrid控件上的记录集。更多的信息，请参阅setDataSource。

说明

要检取底层数据源的绑定成员，调用getDataMember方法。

DataGrid.getDefaultColumnWidth

检取栅格所有列的缺省宽度。

语法

public int getDefaultColumnWidth ()

返回值

返回所有列当前缺省宽度（以像素为单位）。

请参阅：setDefaultColumnWidth

DataGrid.getDisplayIndex

检取与指定书签关联行的显示索引。

语法

public int getDisplayIndex ( Object bookmark )

参数

bookmark

与行关联的书签。

返回值

返回该行零基显示索引。如果指定的行当前不可视，就返回-1。

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

说明

行的显示索引指明了在栅格当前滚动位置上行所显示的次序。最上面的可视行显示索引为0。

DataGrid.getDynamicColumns

检取一个boolean值，指明栅格中的列是否是动态确定的。

语法

public boolean getDynamicColumns ()

返回值

如果列是动态确定的就返回true；否则，就返回false。更多的信息，请参阅setDynamicColumns。

DataGrid.getEnterAction

检取一个值，指明栅格中按下ENTER键所代表的行为。

语法

public int getEnterAction ()

返回值

返回EnterAction类中定义的一个常量。

请参阅：setEnterAction

DataGrid.getFirstRow

检取与栅格最上面可视行关联的书签。

语法

public Object getFirstRow ()

返回值

返回最上面可视行的书签。

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

说明

在用户滚动栅格时，firstRow属性的值处于未定义状态。

请参阅：setFirstRow, getLeftColumn

DataGrid.getGridLineStyle

检取控件栅格线当前的风格。

语法

public int getGridLineStyle ()

返回值

返回GridLineStyle类中定义的一个常量。

请参阅：setGridLineStyle

DataGrid.getHeaderFont

确定栅格列头的字体。

语法

public Font getHeaderFont ()

返回值

返回一个Font对象，代表列头当前使用的字体。headerFont属性的缺省值是null，这意味着列头使用栅格单元的字体。

请参阅：setHeaderFont

DataGrid.getHeaderLineCount

检取栅格列头中可以显示的文本行数量。

语法

public int getHeaderLineCount ()

返回值

返回栅格列头中可以显示的文本行数量。

请参阅：setHeaderLineCount

DataGrid.getLeftColumn

检取栅格最左边可视列的索引。

语法

public int getLeftColumn ()

返回值

返回最左边可视列的零基索引。

说明

当用户滚动栅格时，leftColumn属性的值处于未定义状态。

请参阅：setLeftColumn, getFirstRow

DataGrid.getRowHeight

检取栅格中行的高度。

语法

public int getRowHeight ()

返回值

返回行当前的高度（以像素为单位）。

请参阅：setRowHeight

DataGrid.getRowSelectors

检取一个boolean值，指明栅格中是否显示行选择器。

语法

public boolean getRowSelectors ()

返回值

如果显示行选择器就返回true；否则，就返回false。

请参阅：setRowSelectors

DataGrid.getScrollbars

检取一个值，指明栅格中显示了哪种滚动条。

语法

public int getScrollbars()

返回值

返回在Scrollbars类中定义的一个常量。

请参阅：setScrollbars

DataGrid.getSelectedBackColor

检取栅格中所选择单元的背景颜色。

语法

public color getSelectedBackColor()

返回值

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

说明

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

DataGrid.getSelectedColumns

检取栅格中选中的列。

语法

public column[] getSelectedColumns ()

返回值

返回代表当前选中列的Column对象矩阵。如果没有选中的列，就返回空矩阵。

说明

你可以调用getSelectedColumn方法来确定用户选择了多少列。用户点击列头就表示选中了该列。可以使用CTRL键一次选择多列。

注意：如果DataGrid控件的columnHeaders属性设置为false，则就不显示列头，用户就不能选择列。DataGrid控件不允许同时选择行和列。如果选择了行，调用getSelectedRows来确定所选中的行。

请参阅：setSelectedColumns, clearSelectionDataGrid.getSelectedForeColor检取栅格中所选中文本的颜色。

语法

public Color getSelectedForeColor ()

返回值

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

说明

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

请参阅：setSelectedForeColor

DataGrid.getSelectedRows

检取与栅格所选中行关联的书签。

语法

public Object[] getSelectedRows ()

返回值

返回与当前选中行关联的书签矩阵。如果没有选中的行，就返回空矩阵。

说明

调用getSelectedRows方法来确定用户所选中的行。用户点击行选择器就表示选中该行。可以使用CTRL键一次选中多行。

注意：如果DataGrid控件的rowSelectors属性设置为false，则就不显示行选择器，用户就不能选择行。

DataGrid控件不允许同时选择行和列。如果选择了列，调用getSelectedColumns来确定所选中的列。

请参阅：setSelectedRows, clearColumns

DataGrid.getTabAction

检取一个值，指明栅格中按下TAB键所代表的含义。

语法

public int getTabAction()

返回值

返回TabAction类中定义的一个常量。

请参阅：setTabAction

DataGrid.getVisibleColumns

检取栅格当前滚动位置上可视列的数量。

语法

public int getVisibleColumns ()

返回值

返回栅格当前滚动位置上至少是部分显示的列数量。

说明

要检取栅格中列的总数，调用getColumnCount方法。

请参阅：getVisibleRows

DataGrid.getVisibleRows检取栅格当前滚动位置上可视行的数量。

语法

public int getVisibleRows ()

返回值

返回栅格当前滚动位置上至少是部分显示的行数量。

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

说明

要检取栅格中行数量的估计值，调用getApproxRowCount方法。

请参阅：getVisibleColumns

DataGrid.getWrapCellPointer

检取一个boolean值，指明是否可以使用TAB、ENTER和方向键在行和列中循环移动输入焦点。

语法

public boolean getWrapCellPointer ()

返回值

如果当前的单元允许在行或列中循环移动输入焦点，就返回true；否则，就返回false。更多的信息，请参阅setWrapCellPointer方法。

DataGrid.makeCurrentCellVisible

滚动栅格，将当前的单元滚动进入视图中。

语法

public void makeCurrentCellVisible ()

返回值

要确定当前的单元是否可视，可以调用getCurrentCellVisible方法。

DataGrid.onColumnEdited

触发columnEdited事件。

语法

protected void onColumnEdited ( ColumnEvent event )

参数

event

提供事件数据的ColumnEvent对象。

说明

当单元退出编辑模式时就触发columnEdited事件。更多的信息，请参阅DataGrid概述。

当覆盖onColumnEdited方法时，务必调用super.onColumnEdited方法。

请参阅：addOnColumnEdited, removeOnColumnEdited

DataGrid.onColumnEditing

触发columnEditing事件。

语法

protected void onColumnEditing ( ColumnEditingEvent event )

参数

event

提供事件数据的ColumnEditingEvent对象。

说明

当单元进入编辑模式时就触发columnEditing事件。更详细的信息，请参阅DataGrid概述。

当覆盖onColumnEditing时，务必调用super.onColumnEditing。

请参阅：addOnColumnEditing, removeOnColumnEditing

DataGrid.onColumnResize

触发columnResize事件。

语法

protected void onColumnResize ( ColumnResizeEvent event )

参数

event

提供事件数据的ColumnResizeEvent对象。

说明

当通过编程或用户改变列的大小时，就触发columnResize事件。当覆盖onColumnResize，务必调用super.onColumnResize。

请参阅：addOnColumnResize, removeOnColumnResize

DataGrid.onColumnUpdated

触发columnUpdated事件。

语法

protected void onColumnUpdated ( ColumnEvent event )

参数

event

提供事件数据的ColumnEvent对象。

说明

当用户改变了单元的值而且底层的记录集也被更新后就触发columnUpdated事件。

更多的信息，请参阅DataGrid概述。

当覆盖onColumnUpdated方法时，务必调用super.onColumnUpdated方法。

请参阅：addOnColumnUpdated, removeOnColumnUpdated

DataGrid.onColumnUpdating

触发columnUpdating事件。

语法

protected void onColumnUpdating ( ColumnUpdatingEvent event )

参数

event

提供事件数据的ColumnUpdatingEvent对象。

说明

当用户改变了单元的值而在底层的记录集更新之前就触发columnUpdating事件。

更多的信息，请参阅DataGrid概述。

当覆盖onColumnUpdating方法时，务必调用super.onColumnUpdating方法。

请参阅：addOnColumnUpdating, removeOnColumnUpdating

DataGrid.onDeleted

触发deleted事件。

语法

protected void onDeleted ( Event event )

参数

event

Event对象。

说明

当用户选中要删除的行并按下DELETE键时，就触发deleting事件。然后就从底层的记录集中删除该记录，并触发deleted事件。

当覆盖onDeleted方法时，务必调用super.onDeleted方法。

请参阅：addOnDeleted, removeOnDeleted

DataGrid.onDeleting触发deleting事件。

语法

protected void onDeleting ( CancelEvent event )

参数

event

提供事件数据的CancelEvent对象。

说明

当用户选中要删除的行并按下DELETE键时，就触发deleting事件。然后就从底层的记录集中删除该记录，并触发deleted事件。

当覆盖onDeleting方法时，务必调用super.onDeleting方法。

请参阅：addOnDeleting, removeOn

DeletingDataGrid.onError

触发error事件。

语法

protected void onError ( ErrorEvent event )

参数

event

提供事件数据的ErrorEvent对象。

说明

ADO异常的结果就是触发error事件。

当覆盖onError方法时，务必调用super.onError方法。

请参阅：addOnError, removeOnError

DataGrid.onHeaderClick

触发headerClick事件。

语法

protected void onHeaderClick ( ColumnEvent event )

参数

event

提供事件数据的ColumnEvent对象。

说明

当用户点击列头时就触发headerClick事件。如果columnHeaders属性设置为true就显示列头信息。

当覆盖onHeaderClick方法时，务必调用super.onHeaderClick方法。

请参阅：addOnHeaderClick, removeOnHeaderClick

DataGrid.onInserted

触发inserted事件。

语法

protected void onInserted ( Event event )

参数

event

Event对象。

说明

当用户第一次点击栅格中的空白行时就触发inserting事件。然后给

底层的记录集增加一新行，并触发inserted事件。

当覆盖onInserted方法时，务必调用super.onInserted方法。

请参阅：addOnInserted, removeOnInserted

DataGrid.onInserting

触发inserting事件。

语法

protected void onInserting ( CancelEvent event )

参数

event

提供事件数据的CancelEvent对象。

说明

当用户第一次点击栅格中的空白行时就触发inserting事件。然后给底层的记录集增加一新行，并触发inserted事件。

当覆盖onInserting方法时，务必调用super.onInserting方法。

请参阅：addOnInserting, removeOnInserting

DataGrid.onPositionChange

触发positionChange事件。

语法

protected void onPositionChange ( PositionChangeEvent event )

参数

event

提供事件数据的PositionChangeEvent对象。

说明

栅格中当前的位置通过编程或用户移动时就触发positionChange事件。

当覆盖onPositionChange方法时，务必调用super.onPositionChange方法。

请参阅：addOnPositionChange, removeOnPositionChange

DataGrid.onRowResize

触发rowResize事件。

语法

protected void onRowResize ( CancelEvent event )

参数

event

提供事件数据的CancelEvent对象。

说明

当通过编程或用户改变了行的大小时就触发rowResize事件。当覆盖onRowResize方法时，务必调用super.onRowResize方法。

请参阅：addOnRowResize, removeOnRowResize

DataGrid.onScroll

触发scroll事件。

语法

protected void onScroll ( CancelEvent event )

参数

event

提供事件数据的CancelEvent对象。

说明

当通过编程或用户滚动栅格时就触发scroll事件。

当覆盖onScroll方法时，务必调用super.onScroll方法。

请参阅：addOnScroll, removeOnScroll

DataGrid.onSelChange

触发selChange事件。

语法

protected void onSelChange ( CancelEvent event )

参数

event

提供事件数据的CancelEvent对象。

说明

当通过编程或用户选中栅格中行或列时就触发selChange事件。当覆盖onSelChange方法时，务必调用super.onSelChange方法。

请参阅：addOnSelChange, removeOnSelChange

DataGrid.onUpdated触发updated事件。

语法

protected void onUpdated ( Event event )

参数

event

Event对象。

说明

当用户改变栅格的值并且底层的记录集也更新后就触发updated事件。

更多的信息，请参阅DataGrid概述。

当覆盖onUpdated方法时，务必调用super.onUpdated方法。

请参阅：addOnUpdated, removeOnUpdated

DataGrid.onUpdating

触发updating事件。

语法

protected void onUpdating ( CancelEvent event )

参数

event

提供事件数据的CancelEvent对象。

说明

当用户改变栅格的值并且底层的记录集也更新后就触发updated事件。

更多的信息，请参阅DataGrid概述。

当覆盖onUpdating方法时，务必调用super.onUpdating方法。

请参阅：addOnUpdating, removeOnUpdating

DataGrid.rebind

重新初始化DataGrid控件和底层记录集之间的绑定。

语法

public void rebind ()

说明

该方法导致DataGrid控件执行在你第一次设置dataSource属性（或可选的，dataMember属性）时所执行的同样的操作。DataGrid控件根据当前所绑定的记录集重新设置列的内容。

请参阅：setDynamicColumns

DataGrid.removeColumn

从栅格中删除一列。

语法

public void removeColumn ( int index )

参数

index

要删除列的零基索引。列的索引指明其在栅格中的位置。最后一列的索引是getColumnCount返回的值减1。更多的信息，请参阅Column对象的index属性。

异常

如果index不是有效的索引值，就产生WFCInvalidArgumentException异常。

说明

要从栅格中删除所有的列，调用clearColumns方法。

请参阅：addColumn

DataGrid.removeOnColumnEdited

删除为columnEdited事件指定的代理。

语法

public void removeOnColumnEdited ( ColumnEventHandlerhandler )

参数

handler

要删除的ColumnEventHandler 代理。

请参阅：addOnColumnEdited

DataGrid.removeOnColumnEditing

删除为columnEditing事件指定的代理。

语法

public void removeOnColumnEditing( ColumnEditingEventHandler handler )

参数

handler要删除的ColumnEditingEventHandler 代理。

请参阅：addOnColumnEditing

DataGrid.removeOnColumnResize

删除为columnResize事件指定的代理。

语法

public void removeOnColumnResize ( ColumnResizeEventHandlerhandler )

参数

handler

要删除的ColumnResizeEventHandler代理。

请参阅：addOnColumnResize

DataGrid.removeOnColumnUpdated

删除为columnUpdated事件指定的代理。

语法

public void removeOnColumnUpdated ( ColumnEventHandlerhandler )

参数

handler

要删除的ColumnEventHandler代理。

请参阅：addOnColumnUpdated

DataGrid.removeOnColumnUpdating

删除为columnUpdating事件指定的代理。

语法

public void removeOnColumnUpdating( ColumnUpdatingEventHandler handler)

参数

handler

要删除的ColumnUpdatingEventHandler 代理。

请参阅：addOnColumnUpdating

DataGrid.removeOnDeleted

删除为deleted事件指定的代理。

语法

public void removeOnDeleted ( EventHandler handler )

参数

handler

要删除的EventHandler 代理。

请参阅：addOnDeleted

DataGrid.removeOnDeleting

删除为deleting事件指定的代理。

语法

public void removeOnDeleting ( ColumnEventHandler handler )

参数

handler

要删除的ColumnEventHandler 代理。

请参阅：addOnDeleting

DataGrid.removeOnError

删除为error事件指定的代理。

语法

public void removeOnError ( ErrorEventHandler handler )

参数

handler

要删除的ErrorEventHandler 代理。

请参阅：addOnError

DataGrid.removeOnHeaderClick

删除为headerClick事件指定的代理。

语法

public void removeOnHeaderClick ( ColumnEventHandler handler )

参数

handler

要删除的ColumnEventHandler 代理。

请参阅：addOnHeaderClick

DataGrid.removeOnInserted

删除为inserted事件指定的代理。

语法

public void removeOnInserted ( EventHandler handler )

参数

handler

要删除的EventHandler 代理。

请参阅：addOnInserted

DataGrid.removeOnInserting

删除为inserting事件指定的代理。

语法

public void removeOnInserting ( CancelEventHandler handler )

参数

handler

要删除的CancelEventHandler 代理。

请参阅：addOnInserting

DataGrid.removeOnPositionChange

删除为positionChange事件指定的代理。

语法

public void removeOnPositionChange( PositionChangeEventHandler handler )

参数

handler

要删除的PositionChangeEventHandler 代理。

请参阅：addOnPositionChange

DataGrid.removeOnRowResize

删除为rowResize事件指定的代理。

语法

public void removeOnRowResize ( CancelEventHandler handler )

参数

handler

要删除的CancelEventHandler 代理。

请参阅：addOnRowResize

DataGrid.removeOnScroll

删除为scroll事件指定的代理。

语法

public void removeOnScroll ( CancelEventHandler handler )

参数

handler

要删除的CancelEventHandler 代理。

请参阅：addOnScroll

DataGrid.removeOnSelChange

为selChange事件指定的代理。

语法

public void removeOnSelChange ( CancelEventHandler handler )

参数

handler

要删除的CancelEventHandler 代理。

请参阅：addOnSelChange

DataGrid.removeOnUpdated

删除为updated事件指定的代理。

语法

public void removeOnUpdated ( EventHandler handler )

参数

handler

要删除的EventHandler 代理。

请参阅：addOnUpdated

DataGrid.removeOnUpdating

删除为updating事件指定的代理。

语法

public void removeOnUpdating ( CancelEventHandler handler )

参数

handler

要删除的CancelEventHandler 代理。

请参阅：addOnUpdating

DataGrid.rowBookmark

检取与最上面可视行偏移量为指定行数的行所关联的书签。

语法

public Object rowBookmark ( int displayRow )

参数

displayRow

与最上面可视行的偏移量（以行数为单位）。正值代表后续行；负数代表以前的行。0表示最上面的可视行自己。

异常

如果DataGrid控件没有绑定或displayRow不是引用的有效行，就产生WFCInvalidArgumentException异常。

返回值

返回指定偏移量位置上行所关联的书签。

DataGrid.rowTop

检取指定行顶部的y坐标。

语法

public int rowTop ( Object row )

参数

row

与栅格中的行关联的书签。

返回值

返回行顶部的y坐标，该坐标是相对于DataGrid控件的坐标而言的。

异常

如果Row不是引用的有效行，就产生WFCInvalidArgumentException异常。

说明

rowTop方法能返回栅格中任何行的坐标，不管该行在栅格当前的滚动位置上是否可视。如果该行位于当前可视行的前面，就返回负数坐标。

你可以使用rowTop方法和rowHeight属性以及列的left和width属性来确定栅格中任一单元确切的位置和大小。

DataGrid.scroll

水平和垂直滚动栅格。

语法

public void scroll ( int cols, int rows )

参数

cols

水平方向上要滚动的列数。正数表示向右滚动；负数表示向左滚动。注意，滚动0列就使得当前最左边的列完全可视。

rows

垂直方向上要滚动的行数。正数表示向下滚动；负数表示向上滚动。

异常

如果DataGrid控件没有绑定，就产生WFCInvalidArgumentException异常。

说明

如果你所指定的cols和rows都超出了范围，则栅格只是简单地在相应的方向上滚动到最大值。

你也可以调用setFirstRow和setLeftColumn方法滚动栅格。

DataGrid.setAllowAddNew设

置一个boolean值，指明栅格中是否允许增加新的行（前提是底层的记录集允许增加新的记录）。

语法

public void setAllowAddNew ( boolean allowAddNew)

参数

allowAddNew

如果用户可以给栅格增加新的行就设置为true；否则，就设置为false。allowAddNew属性的缺省值是true。

说明

如果底层的记录集允许增加新的记录，则将allowAddNew和allowUpdate属性都设置为true将导致DataGrid控件在栅格的最后一行后面增加一空白行。用户就可以输入新行的数据，进而就给记录集增加了新的记录。如果allowAddNew属性或allowUpdate属性设置为false，就不显示空白行，也就不能增加新的记录。

重点：如果记录集不允许增加新的记录，则即使allowAddNew属性和allowUpdate属性设置为true，栅格也不会显示空白行。

请参阅：getAllowAddNew

DataGrid.setAllowArrows

设置一个boolean值，指明是否可以使用方向键在栅格中移动。

语法

public void setAllowArrows (boolean allowArrows)

参数

allowArrows

如果允许使用方向键在栅格中移动输入焦点就设置为true；否则，就设置为false。allowArrows属性的缺省值是true。

说明

如果allowArrows和wrapCellPointer属性都设置为true，则当前的单元就可以在行和列中循环移动输入焦点。例如，如果当前的单元是该行最后一个单元，则按下右方向键将使得下一行的第一个单元成为当前单元。

你可以调用setEnterAction和setTabAction方法进一步定义栅格中键盘的导航作用。

请参阅：getAllowArrows

DataGrid.setAllowDelete

设置一个boolean值，指明用户是否可以从栅格中删除行（前提是底层的记录集允许删除记录）。

语法

public void setAllowDelete (boolean allowDelete)

参数

allowDelete

如果用户可以从栅格中删除行，就设置为true；否则，就设置为false。allowDelete属性的缺省值是true。

说明

如果底层的记录集允许删除记录，则将allowDelete属性设置为true将使得按下DELETE键从栅格中删除一行，并进而从记录集中删除记录。如果该属性是false，则DataGrid控件将忽略任何想删除栅格行的企图。

重点：如果底层的记录集不允许删除，则即使allowDelete属性设置为true，栅格也不允许删除操作。

请参阅：getAllowDelete

DataGrid.setAllowRowSizing

设置一个boolean值，指明在运行时是否允许改变栅格中行的大小。

语法

public void setAllowRowSizing ( boolean rowSizing)

参数

rowSizing

如果可以改变栅格中行的高度就设置为true；否则，就设置为false。rowSizing属性的缺省值是true。

说明

当allowRowSizing属性设置为true时，如果鼠标指针位于任何两个行选择器之间的行分隔符上时，鼠标指针就变成双箭头，用户就可以拖动鼠标来改变行的大小。DataGrid控件中的所有行的高度都相同；改变一行的高度将改变所有行的高度。

注意：如果rowSelector属性是false，就不显示行选择器，一行不能改变行的大小。

要通过编程改变行的大小，调用setRowHeight方法。注意，如果allowRowSizing属性是false，则设置行的高度将不起什么作用。

请参阅：getAllowRowSizing

DataGrid.setAllowUpdate

设置一个boolean值，指明是否可以修改栅格中的数据（前提是底层的记录集允许修改）。

语法

public void setAllowUpdate (boolean allowUpdate)

参数

allowUpdate

如果可以修改栅格中的数据就设置为true；否则，就设置为false。allowUpdate属性的缺省值是true。

说明

只有底层的记录集允许修改记录、allowUpdate属性设置为true以及单元列的readOnly属性设置为false的情况下才可以改变当前单元的值。

可以通过编程或用户改变当前单元的值。要通过编程改变单元的值，调用setCurrentCellValue方法。

如果allowUpdate属性设置为false，就不能修改栅格中的数据，调用setCurrentCellValue方法将失败。用户仍然可以滚动栅格并选择数据，但栅格不允许修改数据。

重点：如果底层的记录集不允许修改记录，则栅格就不允许修改数据，即使allowUpdate属性设置为true。

请参阅：getAllowUpdate

DataGrid.setBorderStyle

设置DataGrid控件边框当前的风格。

语法

public void setBorderStyle ( int borderStyle)

参数

borderStyle

com.ms.wfc.ui.BorderStyle类中定义的一个常量。borderStyle属性的缺省值是BorderStyle.FIXED_3D。

异常

如果borderStyle是无效的风格，就产生WFCInvalidArgumentException异常。

请参阅：getBorderStyle

DataGrid.setCaption

设置栅格顶部标题栏中显示的文本。

语法

public void setCaption (String caption)

参数

caption

一个字符串，代表当前标题栏中的文本。caption属性的缺省值是空字符串。

说明

标题显示在列头上方。如果caption属性设置为空字符串，就不显示标题栏。

请参阅：getCaption

DataGrid.setColumnHeaders

设置一个boolean值，指明是否显示列头信息。

语法

public void setColumnHeaders ( boolean columnHeader )

参数

columnHeader

如果显示列头信息，就设置为true；否则，就设置为false。columnHeaders属性的缺省值是true。

说明

缺省地，列头中显示的文本是根据底层记录集的字段名字生成的。

要改变列头文本信息，可以设置Column对象的caption属性。

请参阅：getColumnHeaders

DataGrid.setColumns

设置栅格中所有列构成的集合。

语法

public void setColumns ( Column[] columns )

参数

columns

代表栅格中所有列的Column对象矩阵。

说明

该方法将设置columns属性，从栅格中删除目前的所有列，取而代之为新的列。要简单地给栅格列集合追加一新列，调用addColumn方法。

有关在属性窗口中设置columns属性的信息，请参阅《MicrosoftVisual J++ 6.0 程序员指南》第四章“访问数据”中的“增加、删除和重新安排列”一节。

请参阅：getColumns

DataGrid.setCurrentCellValue

设置当前单元的值。

语法

public void setCurrentCellValue ( String val )

参数

val

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

异常

如果DataGrid没有绑定，就产生WFCInvalidArgumentException异常。

如果allowUpdate属性设置为false、底层记录集不允许修改或者单元列的readOnly属性设置为true就触发WFCException异常。

说明

传递给setCurrentCellValue的字符串将自动转换为正确的数据类型。当前列的dataType属性决定了记录集底层字段的数据类型。

请参阅：getCurrentCellValue

DataGrid.setCurrentColumn

设置栅格当前的列。

语法

public void setCurrentColumn ( Column column )

public void setCurrentColumn ( int index )

参数

column

一个Column对象，代表要设置为栅格当前的列。

index

要设置为当前列的零基索引。列的索引指明列在栅格中的位置。最后一列的索引值是getColumnCount减1。更多的信息，请参阅Column对象的index属性。

异常

如果column是null或index不是有效的列索引值，就产生WFCInvalidArgument-Exception异常。

说明

当调用setCurrentColumn方法时，如果该列当前不可视，栅格就自动滚动。注意，设置当前的列并不改变当前的行。要设置当前的行，调用setCurrentRow方法。

请参阅：getCurrentColumn

DataGrid.setCurrentRow

设置栅格当前的行。

语法

public void setCurrentRow(Object bookmark )

参数

bookmark

与要设置为当前行关联的书签。

异常

如果DataGrid没有绑定或bookmark引用了无效的行，就产生WFCInvalid-ArgumentException异常。

说明

如果要设置为当前行的行不可视，调用setCurrentRow方法时栅格将自动滚动。注意，设置当前的行并不改变当前的列。要设置当前的列，调用setCurrentColumn方法。

请参阅：getCurrentRow

DataGrid.setDataMember

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

语法

public void setDataMember ( String dataMember )

参数

dataMeber

绑定到DataGrid控件的底层数据源成员的名字。

说明

要将DataGrid控件绑定到记录集，首先设置dataSource属性以标明与控件关联的数据源。数据源就是实现了IDataSource界面并输出一个或多个记录集的对象。要指定绑定哪个记录集，设置dataMember属性。例如：

/* Bind a DataGrid control to the recordset named

"Products? which is exposed by the data source, ds. */

dataGrid1.setDataSource ( ds ) ;

dataGrid1.setDataMember ("Products) ;

如果你没有调用setDataMember方法，则就绑定数据源缺省的记录集（你可以将dataMember属性设置为空字符串来明确指明使用缺省的记录集）。

/* Bind the control to the default recordset

exposed by the data source, ds. */

dataGrid1.setDataSource ( ds ) ;

dataGrid1.setDataMember ("") ; /*This line is optional. */

注意，ADO的Recordset和DataSource组件已经实现了IDataSource界面。因此，你可以直接将dataSource属性设置为这些组件之一。在这种情况下，你就不必设置dataMember属性：

/* Pass the Recordset component, rs. directly to

setDataSource without calling setDataMember . */

dataGrid1.setDataSource ( rs ) ;

请参阅：getDataMember, get

DataSourceDataGrid.setDataSource

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

语法

public void setDataSource (IDataSource dataSource)

参数

dataSource

实现了IDataSource界面的对象，该对象输出当前绑定到DataGrid控件上的记录集。

说明

数据源就是实现了IDataSource界面并输出一个或多个记录集的对象，其所输出的记录集，其中的一个就绑定到DataGrid控件上。要指定绑定哪个记录集，调用setDataMember方法。

注意：ADO的Recordset和DataSource组件已经实现了IDataSource界面。因此，你可以直接将dataSource属性设置为这些组件之一。在这种情况下，你就不必设置dataMember属性。

请参阅：getDataSource, get

DataMemberDataGrid.setDefaultColumnWidth

设置栅格所有列的缺省宽度。

语法

public void setDefaultColumnWidth ( int width )

参数

width

栅格中所有列新的缺省宽度（以像素为单位）。defaultColumnWidth属性的缺省值是75。

说明

要将列的宽度设置为初始值，使用column对象的width属性。

请参阅：getDefaultColumnWidth

DataGrid.setDynamicColumns

设置一个boolean值，指明栅格中的列是否是动态确定的。

语法

public void setDynamicColumns ( boolean value )

参数

value

如果列是动态确定的就设置为true；否则，就设置为false。dynamicColumns属性的缺省值是true。

说明

当dynamicColumns属性设置为true时，栅格中的列总是由绑定数据源来确定。然而，如果你改变了任何列的属性，dynamicColumns属性都将自动设置为false，指明列是静态的。

当dynamicColumns属性设置为true时，要重新设置列，调用rebind方法。

当该属性设置为false时，要重新设置列，调用setColumns方法。

请参阅：getDynamicColumns

DataGrid.setEnterAction

设置一个值，指明栅格中按下ENTER键所代表的行为。

语法

public void setEnterAction (int action)

参数

action

EnterAction类中定义的一个常量。enterAction属性的缺省值是EnterAction.NONE。

异常

如果action是无效的ENTER键动作，就产生WFCInvalidEnumException异常。

说明

如果enterAction属性设置为EnterAction.COLUMNNAVIGATION或者EnterAction. ROWNAVIGATION，而且wrapCellPointer属性也设置为true，则当前调用的输入焦点可以在行或列中循环。例如，如果enterAction属性设置为COLUMN-NAVIGATION而且当前的单元输入焦点是该行的最后一列，则按下ENTER键将输入焦点移到下一行的第一列。

你可以通过设置allowArrows和tabAction属性的值来进一步定义键盘导航功能。

请参阅：getEnterAction

DataGrid.setFirstRow

设置栅格最上面可视行。

语法

public void setFirstRow (Object row)

参数

row

与显示为最上面可视行所关联的书签。

异常

如果DataGrid没有绑定或者row没有指向有效的行，就产生WFCInvalidArgument- Exception异常。

说明

调用setFirstRow方法将导致栅格进行滚动，这样所指定的行就变成最上面的可视行。注意，当前行保持不变。要改变当前行，调用setCurrentRow方法。

请参阅：getFirstRow

DataGrid.setGridLineStyle

设置控件栅格线当前的风格。

语法

public void setGridLineStyle ( int gridLineStyle )

参数

gridLineStyle

GridLineStyle类中定义的一个常量。gridLineStyle属性的缺省值是GridLineStyle.SINGLELINE。

异常

如果gridLineStyle不是有效风格，就产生WFCInvalidArgumentException异常。

请参阅：getGridLineStyle

DataGrid.setHeaderFont

确定栅格列头的字体。

语法

public void setHeaderFont (Font headerFont )

参数

headerFont

Font对象，指明列头使用的新字体。

说明

缺省地，列头使用单元中的文本字体，该字体由DataGrid控件的font属性定义。调用setHeaderFont方法可以使用不同的字体绘制列头。如果有必要的话，将自动调整列的大小以便与新字体匹配。

要重新设置为缺省字体，将headerFont属性设置为null。

请参阅：getHeaderFont

DataGrid.setHeaderLineCount

设置栅格列头中可以显示的文本行数量。

语法

public void setHeaderLineCount ( int lines )

参数

lines

栅格列头中可以显示的文本行数量。缺省值是1。

异常

如果lines比1小，就产生WFCInvalidArgumentException异常。

说明

列的高度是由headerLineCount和headerFont属性值决定的。

要隐藏列头，将columnHeaders属性设置为false。要改变列头中显示的文本信息，需要设置每个Column对象的caption属性。

请参阅：getHeaderLineCount

DataGrid.setLeftColumn

设置栅格最左边可视列的索引。

语法

public void setLeftColumn ( int index )

参数

index

显示在最左边可视列的零基索引。一个列的索引指明该列在栅格中的位置。最后一列的索引值是getColumnCount返回的值减1。更多的信息，请参阅Column对象的index属性。

异常

如果index不是有效的列索引，就产生WFCInvalidArgumentException异常。

说明

调用setLeftColumn将导致栅格滚动这样所指定的列就成了最左边的列。注意，当前的列保持不变。要改变当前列，调用setCurrentColumn方法。

DataGrid.setRowHeight

设置栅格中行的高度。

语法

public void setRowHeight ( int rowHeight )

参数

rowHeight

栅格中行的新高度（以像素为单位）。rowHeight属性的缺省值是30。

异常

如果rowHeight比MIN_ROW_HEIGHT小，就产生WFCInvalidArgumentException异常。

说明

栅格中所有的行都有相同的高度。如果allowRowSizing属性设置为true，在运行时，就可以通过编程或用户改变行的大小。rowHeight属性将自动设置为新的高度值。注意，如果allowRowSizing属性是false，则不能改变行的高度。

请参阅：getRowHeight

DataGrid.setRowSelectors

设置一个boolean值，指明栅格中是否显示行选择器。

语法

public void setRowSelectors ( boolean selectors )

参数

selectors

如果显示行选择器就设置为true；否则，就设置为false。rowSelectors属性的缺省值是true。

说明

行选择器出现在行的最左边。用户点击行选择器就选中了该行。

请参阅：getRowSelectors

DataGrid.setScrollbars

设置一个值，指明是否显示滚动条。

语法

public void setScrollbars ( int scroll )

参数

scroll

Scrollbars类中定义的一个常量。scrollbars属性的缺省值是Scrollbars.BOTH。

异常

如果scroll不是有效的滚动条设置，就产生WFCInvalidArgumentException异常。

说明

当scrollbars属性设置为Scrollbars.VERTICAL,Scrollbars.HORIZONTAL或者Scrollbars.BOTH时，则总是显示所指定的滚动条，即使栅格中所有的行和列都可视。

如果scrollbars属性设置为Scrollbars.NONE，只要正确地设置了allowArrows，enterAction和tabAction属性的值，仍然可以使用键盘来滚动栅格。

请参阅：getScrollbars

DataGrid.setSelectedBackColor

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

语法

public void setSelectedBackColor (Color color)

参数

color

一个Color对象，指明栅格中所选中单元的背景颜色。

说明

使用DataGrid控件的selectedBackColor属性来设置栅格中所有选中单元的缺省背景颜色。然后设置Column对象的selectedBackColor属性值来定义每个特定列的背景颜色。列的selectedBackColor属性设置优先于栅格为该列设置的缺省值。

栅格selectedBackColor属性缺省值是Color.HIGHLIGHT。要返回该缺省值，将null做为参数传递给setSelectedBackColor方法。

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

请参阅：getSelectedBackColor

DataGrid.setSelectedColumns

设置所指定的列。

语法

public void setSelectedRows ( Column[] columns )

参数

columns

标明所选中列的Column对象矩阵。

说明

调用setSelectedColumns方法将清除栅格中以前的选择。注意，你不能同时选择行和列。要通过编程选择行，调用setSelectedRows方法。

DataGrid控件不支持选择单个的单元。

请参阅：getSelectedColumns, clearSelection

DataGrid.setSelectedForColor

设置栅格中所选中文本的颜色。

语法

public void setSelectedForeColor ( Color color)

参数

color

一个Color对象，代表栅格中所选中文本的颜色。

说明

使用DataGrid控件的selectedForeColor属性来设置栅格所有列中选中文本的缺省颜色。然后设置Column对象的selectedForeColor属性值来定义每个特定列的文本颜色。列的selectedForeColor属性设置优先于栅格为该列设置的缺省值。

栅格selectedForeColor属性缺省值是Color.HIGHLIGHTTEXT。要返回该缺省值，将null做为参数传递给setSelectedForeColor方法。

要设置没有选中文本的颜色，调用setForeColor方法。

请参阅：getSelectedForeColor

DataGrid.setSelectedRows

设置与指定书签关联的行。

语法

public void setSelectedRows ( Object[] bookmarks)

参数

bookmarks

与要选中行关联的书签矩阵。

说明

调用setSelectedRows方法将清除栅格中以前的选择。注意，你不能同时选择行和列。要通过编程选择列，调用setSelectedColumns方法。

DataGrid控件不支持选择单个的单元。

请参阅：getSelectedRows, clearSelection

DataGrid.setTabAction

设置一个值，指明栅格中按下TAB键所代表的含义。

语法

public void setTabAction( int action )

参数

action

TabAction类中定义的一个常量。tabAction属性的缺省值是TabAction.CONTROLNAVIGATION。

异常如果action不代表有效的TAB动作，就产生WFCInvalidArgumentException异常。

说明

如果tabAction属性设置为TabAction.COLUMNNAVIGATION或者TabAction. ROWNAVIGATION，而且wrapCellPointer属性也设置为了true，则当前调用的输入焦点可以在行或列中循环。例如，如果tabAction属性设置为COLUMN-NAVIGATION而且当前的单元输入焦点是该行的最后一列，则按下TAB键将输入焦点移到下一行的第一列。

你可以通过设置allowArrows和enterAction属性的值来进一步定义栅格中的键盘导航功能。

请参阅：getTabAction

DataGrid.setWrapCellPointer

设置一个boolean值，指明是否可以使用TAB、ENTER和方向键在行和列中循环移动输入焦点。

语法

public void setWrapCellPointer ( boolean wrapCellPointer )

参数

wrapCellPointer

如果当前的单元允许在行或列中循环移动输入焦点，就设置为true；否则，就设置为false。wrapCellPointer属性的缺省值是false。

说明

tabAction,enterAction和allowArrows属性决定了是否可以使用TAB、ENTER和方向键在栅格的行和列中进行导航（切换输入焦点）。当wrapCellPointer属性设置为true时，可以使用这些键在行和列中移动输入焦点。例如，如果用户在一行中移动输入焦点，则当前的单元焦点会从该行最后一列移到下一行的第一列（或从该行第一列移到上一行最后一列）。

请参阅：getWrapCellPointer

DataNavigator类

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

component
  |
  +-- Control
     |
     + -- DataNavigator

package com.ms.wfc.data.ui

public class DataNavigator

extends Control

说明

要将DataNavigator控件绑定到记录集，需要设置它的dataSource属性（或可选的，dataMember属性）。通常，把DataNavigator控件与DataBinder控件联合起来使用。DataBinder控件将另一个控件的属性绑定到记录集中的字段。该属性从记录集当前的记录即最初的第一个记录中获取数据。要让用户移到另外的记录，需要使用绑定到同一记录集上的DataNavigator控件。

DataNavigator控件提供了4个按钮允许用户在记录集中导航：

有关Forms Designer中使用DataNavigator控件的信息，请参阅《Microsoft Visual J ++ 6.0程序员指南》第四章“访问数据”中的“导航记录集”一节。

构造器

DataNavigator.DataNavigator

创建一个DataNavigator对象。

语法

public DataNavigator ()

返回值

一旦你创建了DataNavigator控件，调用setDataSource（可选的，setDataMember）将该控件绑定到记录集上。

方法

DataNavigator.getDataMember

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

语法

public final String getDataMember ()

返回值

返回一个字符串，代表底层数据源的绑定成员。该字符串要么是绑定记录集的名字，要么是空字符串。更多的信息，请参阅setDataMember方法。

说明

要检取DataNavigator底层的数据源对象，调用getDataSource方法。

DataNavigator.getDataSource

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

语法

public final IDataSource getDataSource ()

返回值

返回一个实现了IDataSource界面的对象，该对象当前所输出的记录集就绑定到DataNavigator上。更多的信息，请参阅setDataSource方法。

说明

要检取底层数据源的绑定成员，调用getDataMember方法。

DataNavigator.moveFirst

将底层的记录集移到第一条记录。

语法

protected void moveFirst ( Recordset recordset )

参数

recordset

代表底层记录集的Recordset对象。

说明

当用户按下按钮移到第一条记录时激活该方法。你可以覆盖moveFirst方法，增加自己的错误处理或额外的动作。

请参阅：moveLast, moveNext, movePrevious

DataNavigator.moveLast

将底层的记录集移到最后一条记录。

语法

protected void moveLast ( Recordset recordset )

参数

recordset

代表底层记录集的Recordset对象。

说明

当用户按下按钮移到最后一条记录时激活该方法。你可以覆盖moveLast方法，增加自己的错误处理或额外的动作。

请参阅：moveFirst, moveNext, movePrevious

DataNavigator.moveNext

将底层的记录集移到下一条记录。

语法

protected void moveNext ( Recordset recordset )

参数

recordset

代表底层记录集的Recordset对象。

说明

当用户按下按钮移到下一条记录时激活该方法。你可以覆盖moveNext方法，增加自己的错误处理或额外的动作。

请参阅：moveFirst, moveLast, movePrevious

DataNavigator.movePrevious

将底层的记录集移到上一条记录。

语法

protected void movePrevious ( Recordset recordset )

参数

recordset

代表底层记录集的Recordset对象。

说明

当用户按下按钮移到上一条记录时激活该方法。你可以覆盖movePrevious方法，增加自己的错误处理或额外的动作。

请参阅：moveFirst, moveLast, moveNext

DataNavigator.setDataMember

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

语法

public void setDataMember ( String dataMember )

参数

dataMember

绑定到DataNavigator控件的底层数据源成员的名字。

说明

要将DataNavigator控件绑定到记录集，首先要设置dataSource属性以便标明与该控件关联的数据源。数据源就是实现了IDataSource界面的对象，该对象输出一个或多个记录集。要指明绑定哪个记录集，需要设置dataMember属性。例如：

/* Bind a DataNavigator control to the recordset named

"Products? which is exposed by the data source, ds. */

dataNavigator1.setDataSource ( ds ) ;

dataNavigator1.setDataMember ("Products) ;

如果你没有调用setDataMember方法，则就绑定数据源缺省的记录集（你可以将dataMember属性设置为空字符串来明确指明使用缺省的记录集）。

/* Bind the control to the default recordset

exposed by the data source, ds. */

dataNavigator1.setDataSource ( ds ) ;

dataNavigator1.setDataMember ("") ; /*This line is optional. */

注意，ADO的Recordset和DataSource组件已经实现了IDataSource界面。因此，你可以直接将dataSource属性设置为这些组件之一。在这种情况下，你就不必设置dataMember属性

/* Pass the Recordset component, rs. directly to

setDataSource without calling setDataMember . */

dataNavigator1.setDataSource ( rs ) ;

请参阅：getDataMember, getDataSource

DataNavigator.setDataSource

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

语法

public void setDataSource ( IDataSource dataSource )

参数

dataSource

实现了IDataSource界面的对象，该对象输出绑定到DataNavigator控件的记录集。

说明

数据源是实现了IDataSource界面、并输出一个或多个记录集的对象，其所输出记录集中的一个绑定到DataNavigator控件。要指明绑定哪个记录集，调用setDataMember方法。

注意：因为ADO的Recordset和DataSource组件已经实现了IDataSource界面，因此，你可以直接将dataSource属性设置为这些组件之一。在这种情况下，你就不必设置dataMember属性。

请参阅：getDataSource, getDataMember

DataSource类

为组件提供数据。

Component
   |
   +-- DataSource

package com.ms.wfc.data.ui

public class DataSource

extends Component

implements IRequireBegin, IDataSource, IDataSourceListener

说明

DataSource控件组合了ADO Connection,Command和Recordset对象的功能。

构造器

DataSource.DataSource

创建一个DataSource对象。

语法

public DataSource ()

方法

DataSource.begin

打开与数据源的连接。

语法

public void begin ()

说明

如果命令与DataSource对象关联，就指向该命令并打开结果记录集。

请参阅：close

DataSource.close

关闭与数据源的连接。

语法

public void close ()

请参阅：begin

DataSource.dispose

关闭该组件。

语法

public void dispose ()

DataSource.getAsyncConnect

检取一个boolean值，指明与数据源的连接是否是异步的。

语法

public boolean getAsynConnect ()

返回值

如果连接是异步的，就返回true；否则，就返回false。

请参阅：setAsyncConnect

DataSource.getAsyncExecute

检取一个boolean值，指明对数据源的命令是否是异步执行。

语法

public boolean getAsyncExecute ()

返回值

如果要异步执行命令，就返回true；否则就返回false。

请参阅：setAsyncExecute

DataSource.getAsyncFetch

检取一个boolean值，指明对数据源的查询结果记录集是否是异步返回。

语法

public boolean getAsyncFetch ()

返回值

如果记录集将异步返回，就返回true；否则，就返回false。

请参阅：setAsyncFetch

DataSource.getCacheSize

检取可以在内存中本地缓冲的记录集数量。

语法

public int getCacheSize ()

返回值

返回可以在内存中本地缓冲的记录集数量。

请参阅：setCacheSize, ADO CacheSize属性

DataSource.getCommand

检取与数据源关联的Command对象。

语法

public Command getCommand ()

返回值

返回关联的Command对象。

请参阅：getRecordset, getConnection

DataSource.getCommandText

检取发送给数据源的命令文本。

语法

public String getCommandText ()

返回值

返回命令字符串。

说明

命令通常是要返回记录集的查询请求。

请参阅：setCommandText, getCommandType

DataSource.getCommandTimeout

检取在终止请求之前等待命令完成的时间。

语法

public int getCommandTimeout ()

返回值

返回要等待的秒数。

请参阅：setCommandTimeout, ADO CommandTimeout属性

DataSource.getCommandType

检取发送给数据源的命令类型。

语法

public int getCommandType ()

返回值

返回AdoEnums.CommandType类中定义的一个值。

说明

正确设置commandType属性值可以增强命令文本的识别过程。

请参阅：setCommandType, getCommandText

DataSource.getConnection

检取与数据源关联的Connection对象。

语法

public Connection getConnection ()

返回值

返回关联的Connection对象。

请参阅：getRecordset, getCommand

DataSource.getConnectionString

检取用于与数据源建立连接的字符串。

语法

public String getConnectionString ()

返回值

返回连接字符串。

请参阅：setConnectionString

DataSource.getConnectionTimeout

检取在终止请求之前等待建立连接的时间。

语法

public getConnectionTimeout ()

返回值

返回要等待的秒数。

请参阅：setConnectionTimeout, ADO ConnectionTimeout属性

DataSource.getCursorLocation

检取游标引擎的位置。

语法

public int getCursorLocation ()

返回值

返回AdoEnums.CursorLocation类中定义的一个值。

说明

cursorLocation属性提供了客户端或服务器端的游标支持。

请参阅：setCursorLocation

DataSource.getCursorType

检取数据源所使用的游标类型。

语法

public int getCursorType ()

返回值

返回AdoEnums.CursorType类中定义的一个值。

请参阅：setCursorType

DataSource.getDesignTimeData

检取一个boolean值，指明在可视化设计器的窗体中是否应与数据源建立连接。

语法

public boolean getDesignTimeData ()

返回值

如果在设计模式中要建立连接，就返回true；否则就返回false。

请参阅：setDesignTime

DataDataSource.getFilter

检取包括或排除记录集的评判标准。

语法

public String getFilter ()

返回值

返回一个字符串，代表过滤器评判标准。更多的信息，请参阅setFilter。

请参阅：ADO Filter属性

DataSource.getIsolationLevel

检取该DataSource对象对其他用户对同一数据源所作事务了解的程度。

语法

public int getIsolationLevel ()

返回值

返回AdoEnums.IsolationLevel类中定义的一个值。

请参阅：setIsolationLevel

DataSource.getLockType

检取在编辑过程中记录集上所加的锁类型。

语法

public int getLockType ()

返回值

返回AdoEnums.LockType类中定义的一个值。

请参阅：setLockType

DataSource.getMaxRecords

检取从查询结果所返回的最大记录数。

语法

public int getMaxRecords ()

返回值

返回记录集中查询所返回的最大记录数。

请参阅：setMaxRecords, ADO MaxRecords属性

DataSource.getMode

检取在与数据源的连接中可使用的数据修改权限。

语法

public int getMode ()

返回值

返回AdoEnums.ConnectMode类中定义的一个值。

请参阅：setMode

DataSource.getParentDataSource

检取级联记录集中的父数据源。

语法

public DataSource getParentDataSource ()

返回值

返回父DataSource对象。

请参阅：setParentDataSource

DataSource.getParentFieldName

检取级联记录集中与父和子记录集关联的字段名字。

语法

public String getParentFieldName ()

返回值

返回父字段的名字。

请参阅：setParentFieldName

DataSource.getPassword

检取与数据源连接中所指定的口令。

语法

public String getPassword ()

返回值

返回与数据源关联的口令。

请参阅：setPassword

DataSource.getPrepared

检取一个boolean值，指明所关联的命令是否优化执行（准备好的）。

语法

public boolean getPrepared ()

返回值

如果命令已经准备好就返回true；否则，就返回false。

说明

如果命令是有准备的，则该命令执行几次后性能就会有所增强。

请参阅：setPrepared

DataSource.getRecordset

检取与数据源关联的记录集。

语法

public Recordset getRecordset ()

返回值

返回关联的Recordset对象。

说明

如果关联的记录集被关闭了，该方法就打开它。如果没有设置记录集，就创建缺省的记录集。

请参阅：getCommand, getConnection

DataSource.getSort

检取数据源的排列顺序。

语法

public String getSort ()

返回值

返回一个字符串，指明记录集所依据进行排序的一个或多个字段名字，以及每个字段是按升序还是降序排列。

请参阅：setSort, ADO Sort属性

DataSource.getStayInSync

检取一个boolean值，指明孩子记录集中行的位置是否随父记录集中行位置的改变而改变。

语法

public boolean getStayInSync ()

返回值

如果孩子和父亲行位置保持同步，就返回true；否则，就返回false。

请参阅：setStayInSync

DataSource.getUserId

检取在数据源连接中所指定的用户标识符。

语法

public String getUserId ()

返回值

返回与数据源关联的用户标识符。

请参阅：setUserId

DataSource.isChildDataSource

指明该数据源是否是级联记录集中的子记录集。

语法

public boolean isChildDataSource ()

返回值

如果数据源是子记录集，就返回true；否则，就返回false。

请参阅：getParentDataSource, setParentDataSource

DataSource.requery

重新执行创建与数据源关联的记录集的命令。

语法

public void requery ()

说明

如果记录集当前是打开的，在命令重新执行之前就关闭它。

DataSource.setAsyncConnect

设置一个boolean值，指明与数据源的连接是否是异步的。

语法

public void setAsyncConnect (boolean asyncConnect )

参数

asyncConnect

如果连接是异步的，就设置为true；否则，就设置为false。

请参阅：getAsyncConnect

DataSource.setAsyncExecute

设置一个boolean值，指明对数据源的命令是否是异步执行。

语法

public void setAsyncExecute (boolean asyncExecute )

参数

asyncExecute

如果要异步执行命令，就设置为true；否则就设置为false。

请参阅：getAsyncExecute

DataSource.setAsyncFetch

设置一个boolean值，指明对数据源的查询结果记录集是否是异步返回。

语法

public void setAsyncFetch (boolean asyncFetch )

参数

asyncFetch

如果记录集将异步返回，就设置为true；否则，就设置为false。

请参阅：getAsyncFetch

DataSource.setCacheSize

设置可以在内存中本地缓冲的记录集数量。

语法

public void setCacheSize (int cacheSize)

参数

cacheSize

可以在内存中本地缓冲的记录集数量。

请参阅：getCacheSize, ADO CacheSize属性

DataSource.setCommandText

设置发送给数据源的命令字符串。

语法

public void setCommandText (String cmdText)

参数

cmdText

命令文本。

说明

命令通常是要返回记录集的查询请求。

请参阅：getCommandText, setCommandType

DataSource.setCommandTimeout

设置在终止请求之前等待命令完成的时间。

语法

public void setCommandTimeout (int timeout)

参数

timeout

要等待的秒数。

请参阅：getCommandTimeout, ADO CommandTimeout属性

DataSource.setCommandType

设置发送给数据源的命令类型。

语法

public void setCommandType ( int commandType)

参数

commandType

AdoEnums.CommandType类中定义的一个值。

说明

正确设置commandType属性值可以增强命令文本的识别过程。

请参阅：getCommandType, setCommandText

DataSource.setConnectionString

设置用于与数据源建立连接的字符串。

语法

public void setConnectionString (String connectionString)

参数

connectionString

连接字符串。

请参阅：getConnectionString

DataSource.setConnectionTimeout

设置在终止请求之前等待建立连接的时间。

语法

public void setConnectionTimeout (int timeout)

参数

timeout

要等待的秒数。

请参阅：getConnectionTimeout, ADO ConnectionTimeout属性

DataSource.setCursorLocation

设置游标引擎的位置。

语法

public void setCursorLocation (int cursorLocation )

参数

cursorLocation

AdoEnums.CursorLocation类中定义的一个值。

说明

cursorLocation属性提供了客户端或服务器端的游标支持。

请参阅：getCursorLocation

DataSource.setCursorType

设置数据源所使用的游标类型。

语法

public int setCursorType (int cursorType)

参数

cursorType

AdoEnums.CursorType类中定义的一个值。

请参阅：getCursorType

DataSource.setDesignTimeData

设置一个boolean值，指明在可视化设计器的窗体中是否应与数据源建立连接。

语法

public void setDesignTimeData (boolean fDesign )

参数

fDesing

如果在设计模式中要建立连接，就设置为true；否则就设置为false。

请参阅：getDesignTimeData

DataSource.setFilter

设置包括或排除记录集的评判标准。

语法

public void setFilter (String filter)

参数

filter

一个字符串，代表过滤器评判标准。

说明

评判标准字符串，是由如下格式的语句组成：FieldName-Operator-Value。你可以使用AND和OR组合多个语句。

FieldName是记录集中的字段名。对于包括空格的字段名，应该使用方括号括起来。

Operator是下列之一：<,>,<=,>=,<>=,LIKE。如果Operator是LIKE，则Value就可以使用通配符。星号(*)通配符可以匹配任意多个字符，百分比(%)通配符可匹配一个字符。你可以在开头和结尾处都使用通配符，也可以只在结尾处使用通配符。

Value是要与FieldName进行比较的值。对于字符串使用单引号，对于日期使用井号(#)。对于数字，你可以使用小数点、美元符号和科学计数法。

请参阅：getFilter, ADO Filter属性

DataSource.setIsolationLevel

设置该DataSource对象对其他用户对同一数据源所作事务了解的程度。

语法

public void setIsolationLevel ( int level )

参数

level

AdoEnums.IsolationLevel类中定义的一个值。

请参阅：getIsolationLevel

DataSource.setLockType

设置在编辑过程中记录集上所加的锁类型。

语法

public void setLockType (int lockType)

参数

lockType

AdoEnums.LockType类中定义的一个值。

请参阅：getLockType

DataSource.setMaxRecords

设置从查询结果所返回的最大记录数。

语法

public void setMaxRecords ( int maxRecords)

参数

maxRecords

要返回的最大记录数。

请参阅：getMaxRecords, ADO MaxRecords属性

DataSource.setMode

设置在与数据源的连接中可使用的数据修改权限。

语法

public void setMode (int mode)

参数

mode

AdoEnums.ConnectMode类中定义的一个值。

请参阅：getMode

DataSource.setParentDataSource

设置级联记录集中的父数据源。

语法

public void setParentDataSource (DataSource source)

参数

source

父DataSource对象。

请参阅：getParent

DataSource.setParentFieldName

设置级联记录集中与父和子记录集关联的字段名字。

语法

public void setParentFieldName (String name)

参数

name

父字段的名字。

请参阅：getParentFieldName

DataSource.setPassword

设置与数据源连接中所指定的口令。

语法

public void setPassword (String password)

参数

password

与数据源关联的口令。

请参阅：getPassword

DataSource.setPrepared

设置一个boolean值，指明所关联的命令是否优化执行（准备好的）。

语法

public void setPrepared (boolean prepared)

参数

prepared

要准备命令，就设置为true；否则，就设置为false。

说明

如果命令是有准备的，则该命令执行几次后性能就会有所增强。

请参阅：getPrepared

DataSource.setSort

设置数据源的排列顺序。

语法

public void setSort (String sort)

参数

sort

一个字符串，指明记录集所依据进行排序的一个或多个字段名字，以及每个字段是按升序还是降序排列。

请参阅：getSort, ADO Sort属性

DataSource.setStayInSync

设置一个boolean值，指明孩子记录集中行的位置是否随父记录集中行位置的改变而改变。

语法

public void setStayInSync (boolean stayInSync)

参数

stayInSync

如果孩子和父亲行位置保持同步，就设置为true；否则，就设置为false。

请参阅：getStayInSync

DataSource.setUserId

设置在数据源连接中所指定的用户标识符。

语法

public void setUserId (String userId)

参数

userId

与数据源关联的用户标识符。

请参阅：getUserId

EnterAction类

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

Enum
   |
   +-- EnterAction

package com.ms.wfc.data.ui

public class EnterAction

extends Enum

说明

使用EnterAction常量设置DataGrid控件的enterAction属性。

字段

EnterAction.COLUMNNAVIGATION

指明ENTER键将单元的焦点移到同一行中的下一列。

语法

public static final int COLUMNNAVIGATION;

请参阅：DataGrid.getEnterAction, DataGrid.setEnterAction

EnterAction.NONE

指明栅格中不能使用ENTER键移动当前单元的焦点。

语法

public static final int NONE;

请参阅：DataGrid.getEnterAction, DataGrid.setEnterAction

EnterAction.ROWNAVIGATION

指明ENTER键将单元的焦点移到同一列中的下一行。

语法

public static final int ROWNAVIGATION;

请参阅：DataGrid.getEnterAction, DataGrid.setEnterAction

ErrorEvent类

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

Event
   |
   +-- ErrorEvent

package com.ms.wfc.data.ui

public class ErrorEvent

extends Event

说明

ADO异常的结果就是产生error事件。ErrorEvent对象指明所产生的ADO异常，并提供一个标志，指明是否显示一个未处理异常对话框。

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

字段

ErrorEvent.displayDialog

指明是否显示未处理异常对话框。

语法

public boolean displayDialog;

ErrorEvent.error

指明所产生的ADO异常。

语法

public final Throwable error ;

构造器

ErrorEvent.ErrorEvent

创建一个ErrorEvent对象。

语法

public ErrorEvent ( Throwable error, boolean displayDialog )

参数

error

产生的ADO异常。

displayDialog

设置为true就显示未处理异常对话框；否则，就设置为false。

ErrorEventHandler代理

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

package com.ms.wfc.data.ui

public multicast delegate

void ErrorEventHandler (Object sender, ErrorEvent e );

说明

ErrorEventHandler 代理的语法指明了事件处理器的格式，其中sender是事件源，e是提供事件数据的ErrorEvent对象。

当你创建一个ErrorEventHandler代理时，就要指明处理事件的方法。

一旦代理指定给该事件，当事件触发时将自动激活处理器方法。有关代理的信息，请参阅 《Microsoft Visual J++ 6.0 程序员指南》第12章 揥FC编程概念數摹癢FC中的事件处理”一节。

GridLineStyle类

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

Enum
   |
   +-- GridLineStyle

package com.ms.wfc.data.ui

public class GridLineStyle

extends Enum

说明

使用GridLineStyle常量设置DataGrid控件的gridLineStyle属性。

字段

GridLineStyle.NONE

指明控件中的单元之间没有栅格线。

语法

public static final int NONE;

请参阅：DataGrid.getGridLineStyle, DataGrid.setGridLineStyle

GridLineStyle.RAISED3D

指明控件具有凸起的三维栅格线。

语法

public static final int RAISED3D;

请参阅：DataGrid.getGridLineStyle, DataGrid.setGridLineStyle

GridLineStyle.SINGLELINE

指明控件的栅格线是单个的线条。

语法

public static final int SINGLELINE;

请参阅：DataGrid.getGridLineStyle, DataGrid.setGridLineStyle

GridLineStyle.SUNKEN3D

指明控件具有下沉的三维栅格线。

语法

public static final int SUNKEN3D;

请参阅：DataGrid.getGridLineStyle, DataGrid.setGridLineStyle

PositionChangeEvent类

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

Event
   |
   +-- PositionChangeEvent

package com.ms.wfc.data.ui

public class PositionChangeEvent

extends Event

说明

当栅格中移动了当前位置时就触发positionChange事件。PositionChangeEvent对象指明在位置改变之前的当前行和当前列。

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

字段

PositionChangeEvent.lastColumn

指明位置改变之前当前列的零基索引。

语法

public int lastColumn;

PositionChangeEvent.lastRow

指明位置改变之前与当前行关联的书签。

语法

public Object lastRow;

构造器

PositionChangeEvent.PositionChangeEvent

创建一个PositionChangeEvent对象。

语法

public PositionChangeEvent ( int lastColumn, Object lastRow )

参数

lastColumn

位置改变之前当前列的零基索引。

lastRow

位置改变之前与当前行关联的书签。

PositionChangeEventHandler代理

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

package com.ms.wfc.data.ui

public multicast delegate

void PositionChangeEventHandler ( Object sender,PositionChangeEvent e )

说明

PositionChangeEventHandler代理的语法指明了事件处理器的格式，其中sender是事件源，e是提供事件数据的ErrorEvent 对象。

当你创建一个PositionChangeEventHandler 代理时，就要指明处理事件的方法。一旦代理指定给该事件，当事件触发时将自动激活处理器方法。

有关代理的信息，请参阅 《Microsoft Visual J++ 6.0 程序员指南》第12章 揥FC编程概念數摹癢FC中的事件处理”一节。

Scrollbars类

定义在DataGrid控件中指明是否显示滚动条的常量。

Enum
   |
   +-- Scrollbars

package com.ms.wfc.data.ui

public class Scrollbars

extends Enum

说明

使用Scrollbars常量设置DataGrid控件的scrollbars属性。

字段

Scrollbars.BOTH

指明显示垂直和水平两种滚动条。

语法

public static final int BOTH;

请参阅：DataGrid.getScrollbars, DataGrid.setScrollbars

Scrollbars.HORIZONTAL

指明只显示水平滚动条。

语法

public static final int HORIZONTAL;

请参阅：DataGrid.getScrollbars, DataGrid.setScrollbars

Scrollbars.NONE

指明不显示滚动条。

语法

public static final int NONE;

请参阅：DataGrid.getScrollbars, DataGrid.setScrollbars

Scrollbars.VERTICAL

指明只显示垂直滚动条。

语法

public static final int VERTICAL;

请参阅：DataGrid.getScrollbars, DataGrid.setScrollbars

TabAction类

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

Enum
   |
   +-- TabAction

package com.ms.wfc.data.ui

public class TabAction

extends Enum

说明

使用TabAction常量设置DataGrid控件的tabAction属性。

字段

TabAction.COLUMNNAVIGATION

指明TAB键将单元的焦点移到同一行中的下一列。

语法

public static final int COLUMNNAVIGATION;

请参阅：DataGrid.getTabAction, DataGrid.setTabAction

TabAction.CONTROLNAVIGATION

指明TAB键将在窗体的控件之间移动输入焦点。不能在栅格中使用TAB键移动当前单元焦点。

语法

public static final int CONTROLNAVIGATION;

请参阅：DataGrid.getTabAction, DataGrid.setTabAction

TabAction.ROWNAVIGATION

指明TAB键将单元的焦点移到同一列中的下一行。

语法

public static final int ROWNAVIGATION;

请参阅：DataGrid.getTabAction, DataGrid.setTabAction