course5.htm

JAVA开发手册,查询JAVASDK的函数!

<p>public void setBackColor (Color color)</p>  
<p class="title_2">参数</p>  
<p>color</p>  
<p>一个Color对象，代表列的背景颜色。</p>  
<p class="title_2">说明</p>  
<p>调用setBackColor来覆盖由父DataGrid控件设置的缺省背景颜色。要在以后重新设置为缺省值，在调用setBackColor时将null做为参数即可。</p>  
<p>要设置选中单元的背景颜色，调用setSelectedBackColor方法。</p>  
<p>请参阅：getBackColor, shouldPersistBackColor</p>  
<p>Column.setBoundFieldName</p>  
<p>设置记录集中与该列绑定的字段名。</p>  
<p class="title_2">语法</p>  
<p>public void setBoundFieldName ( String name)</p>  
<p class="title_2">参数</p>  
<p>name一个字符串，表示记录集中绑定到列的字段名。</p>  
<p class="title_2">说明</p>  
<p>当你调用setBoundFieldName方法时，父DataGrid控件将自动将列重新绑定到所指定的字段。列的标题也被更新，以便反映出新的绑定字段。</p>  
<p>注意：多行可以绑定到同一字段。</p>  
<p>请参阅：getBoundFieldName</p>  
<p>Column.setCaption</p>  
<p>设置列头中显示的文本。</p>  
<p class="title_2">语法</p>  
<p>public void setCaption(String caption)</p>  
<p class="title_2">参数</p>  
<p>caption要显示的标题文本。</p>  
<p class="title_2">说明</p>  
<p>缺省地，列标题就设置为该列所绑定的字段的名字。将标题设置为null或空字符串将清除标题文本，但不隐藏列头。要隐藏栅格中所有的列头，将父DataGrid控件的columnHeanders属性设置为false。</p>  
<p>请参阅：getCaption</p>  
<p>Column.setDataFormat</p>  
<p>设置列数据的格式。</p>  
<p class="title_2">语法</p>  
<p>public void setDataFormat (IDataFormat value)</p>  
<p class="title_2">参数</p>  
<p>vlaue</p>  
<p>一个实现了IDataFormat界面的对象，指明列中数据的格式。</p>  
<p class="title_2">说明</p>  
<p>dataFormat属性影响到栅格列中如何显示数据；其不影响底层的记录集中如何存储数据。你可以为下列的数据类型指定格式：</p>  
<table border="1">  
  <tr>   
    <td>数据类型</td>  
    <td>IDataFormat对象</td>  
  </tr>  
  <tr>   
    <td>布尔值</td>  
    <td>BooleanDataFormat</td>  
  </tr>  
  <tr>   
    <td>日期或时间</td>  
    <td>DateDataFormat</td>  
  </tr>  
  <tr>   
    <td>数字</td>  
    <td>NumberDataFormat</td>  
  </tr>  
</table>  
<p>有关在属性窗口中设置dataFormat属性的信息，请参阅《Microsoft Vis J++ 6.0程序员指南》第四章“访问数据”中的“规定数据格式”一节。</p>  
<p>请参阅：getDataFormat </p>  
<p>Column.setFont</p>  
<p>设置列中文本的字体。</p>  
<p class="title_2">语法</p>  
<p>public void setFont (Font font)</p>  
<p class="title_2">参数</p>  
<p>font</p>  
<p>一个Font对象，代表列文本所使用的字体。</p>  
<p class="title_2">说明</p>  
<p>调用setFont方法覆盖由父DataGrid控件所设置的缺省字体。要在以后重新设置为缺省值，将null当作参数传递给setFont方法。</p>  
<p>请参阅：getFont, shouldPersistFont</p>  
<p>Column.setForeColor</p>  
<p>设置列中文本的颜色。</p>  
<p class="title_2">语法</p>  
<p>public void setForeColor ( Color color )</p>  
<p class="title_2">参数</p>  
<p>color</p>  
<p>一个Color对象，代表列文本的颜色。</p>  
<p class="title_2">说明</p>  
<p>调用setForeColor方法覆盖由父DataGrid控件设置的缺省文本颜色。要在以后重新设置为缺省值，将null做为参数传递给setForeColor方法。</p>  
<p>要设置选中单位的文本颜色，调用setSelectedForeColor方法。</p>  
<p>请参阅：getForeColor, shouldPersistForeColor</p>  
<p>Column.setIndex</p>  
<p>设置栅格中列的索引。</p>  
<p class="title_2">语法</p>  
<p>public void setIndex (int index)</p>  
<p class="title_2">参数</p>  
<p>index</p>  
<p>零基索引值，指明新的列位置。</p>  
<p class="title_2">说明</p>  
<p>调用setIndex方法重新设置栅格中的列。当你设置列的index属性时，列就定位到所指定的索引位置处。原来在给位置上的列以及后续的所有列都向右移（意味着它们的索引值都加1）。</p>  
<p>注意，每个列，不管是可见还是不可见的，都有一个索引值。如果你将第一列的visible属性设置为false，其索引值仍然是0。用户实际所看到的第一列仍然是栅格中的第二列，其索引值是1。</p>  
<p>如果你所指定的索引值超出了栅格列集合的边界范围，则该列就定位到第一个位置或最后的位置上。例如，将列的索引设置为负数就定位到第一个位置。将索引设置为父DataGrid控件的columnCount属性或更大的数，就将列定位到最后的位置上。</p>  
<p>请参阅：getIndex</p>  
<p>Column.setReadOnly</p>  
<p>设置一个boolean值，指明列中的数据是否是只读的。</p>  
<p class="title_2">语法</p>  
<p>public void setReadOnly ( boolean readonly)</p>  
<p class="title_2">参数</p>  
<p>readonly</p>  
<p>如果将列标识为只读从而不允许修改列的值，就设置为true；则，就设置为false。</p>  
<p>readOnly属性的缺省值是false。</p>  
<p class="title_2">说明</p>  
<p>当列是只读的时候，不能修改列中的数据。如果列的readOnly属性是true，则调用Column.setValue和DataGrid.setCurrentCellValue方法更新记录集都将失败。</p>  
<p>当父DataGrid控件的allowUpdate属性是true时，你可以将列的readOnly属性设置为true以便阻止用户修改列中的数据。当allowUpdate属性是false时，列中的数据就是只读的，不管列的readOnly属性设置为何值。</p>  
<p>请参阅：getReadOnly</p>  
<p>Column.setSelectedBackColor</p>  
<p>设置列中所选中单元的背景颜色。</p>  
<p class="title_2">语法</p>  
<p>public void setSelectedBackColor (Color color)</p>  
<p class="title_2">参数</p>  
<p>color</p>  
<p>一个Color对象，代表所选中单元的背景颜色。</p>  
<p class="title_2">说明</p>  
<p>调用setSelectedBackColor方法覆盖由父DataGrid控件设置的缺省背景颜色。要在以后重新设置为缺省值，可以将null做为参数传递给setSelectedBackColor方法。</p>  
<p>请参阅：getSelectedBackColor, shouldPersistSelectedBackColor</p>  
<p>Column.setSelectedForeColor</p>  
<p>设置列中选中文本的颜色。</p>  
<p class="title_2">语法</p>  
<p>public void setSelectedForeColor (Color color)</p>  
<p class="title_2">参数</p>  
<p>color</p>  
<p>一个Color对象，代表列中文本的颜色。</p>  
<p class="title_2">说明</p>  
<p>调用setSelectedForeColor方法覆盖由父DataGrid控件设置选中文本的缺省颜色。要在以后重新设置为缺省值，可以将null做为参数传递给setSelectedForeColor方法。要设置未选中文本的颜色，调用setForeColor方法。</p>  
<p>请参阅：getSelectedForeColor, shouldPersistSelectedForeColor</p>  
<p>Column.setValue</p>  
<p>设置栅格当前行中单元的值。</p>  
<p class="title_2">语法</p>  
<p>public void setValue (String value)</p>  
<p class="title_2">参数</p>  
<p>value</p>  
<p>一个字符串，代表栅格当前行中单元的格式化数值。</p>  
<p class="title_2">说明</p>  
<p>Column对象的value属性和父DataGrid控件的currentCellValue属性不必引用同一单元。栅格的currentCellValue属性指的是当前行和当前列交点处单元的值。列的value属性是指向栅格当前行中的单元；然而，该列可能不是栅格中的当前列。</p>  
<p>重点：为了设置value属性，栅格的allowUpdate属性必须设置为true，列的readOnly属性必须设置为false，而且底层的字段也必须是允许修改数据。</p>  
<p>传递给setValue的字符串将自动转换为正确的数据类型。列的dataType属性标出底层字段的类型。</p>  
<p>请参阅：getValue</p>  
<p>Column.setVisible</p>  
<p>设置一个boolean值，指明列是否可见（意味着是否能够滚动出现在视图中）。</p>  
<p class="title_2">语法</p>  
<p>public void setVisible ( boolean visible)</p>  
<p class="title_2">参数</p>  
<p>visible</p>  
<p>如果想让该列通过滚动出现在视图中，就设置为true；要隐藏该列，就设置为false。visible属性的缺省值是true。</p>  
<p class="title_2">说明</p>  
<p>将visible属性设置为false将简单地隐藏栅格中的列。列仍然拥有自己的索引值，而且仍包括在父DataGrid控件的columnCount属性中。</p>  
<p>要真正从栅格中删除一个列，调用DataGrid控件的removeColumn方法。</p>  
<p>请参阅：getVisible</p>  
<p>Column.setWidth</p>  
<p>设置列的宽度。</p>  
<p class="title_2">语法</p>  
<p>public void setWidth (int width)</p>  
<p class="title_2">参数</p>  
<p>width</p>  
<p>新的列宽度（以像素为单位）。</p>  
<p>异常</p>  
<p>如果width小于DataGrid.MIN_COLUMN_WIDTH就产生WFCInvalidArgument-Exception异常。</p>  
<p class="title_2">说明</p>  
<p>如果allowSizing属性设置为true。则在运行时、通过编程或用户就可以改变列的宽度。width属性将自动设置为新的宽度值。之一，如果allowSizing属性设置为false，则不能改变列的宽度。</p>  
<p>使用父DataGrid控件的defaultColumnWidth属性设置栅格中所有列的缺省宽度。</p>  
<p>请参阅：getWidth</p>  
<p>Column.setWrapText</p>  
<p>设置一个boolen值，指明列中的文本值是否可以在单元中换行显示。</p>  
<p class="title_2">语法</p>  
<p>public void setWrapText (boolean wrap)</p>  
<p class="title_2">参数</p>  
<p>wrap</p>  
<p>如果列中的值可以在单元中换行显示，就设置为true（为了在单元中输入多行文本，需要设置父DataGrid控件的rowHeight属性）。如果只允许输入文本多到单元边界，就设置false。wrapText属性的缺省值是false。</p>  
<p>更详细的信息，请参阅getWrapText。</p>  
<p>Column.shouldPersistBackColor</p>  
<p>指明列背景颜色是否应该永久性保存。</p>  
<p class="title_2">语法</p>  
<p>public boolean shouldPersistBackColor ()</p>  
<p class="title_2">返回值</p>  
<p>如果要永久性保存列背景颜色，就返回true；否则，就返回false。</p>  
<p class="title_2">说明</p>  
<p>通常在Forms Designer内部使用该方法。</p>  
<p>Column.shouldPersistFont</p>  
<p>指明列的字体是否应该永久性保存。</p>  
<p class="title_2">语法</p>  
<p>public boolean shouldPersistFont ()</p>  
<p class="title_2">返回值</p>  
<p>如果要永久性保存列的字体，就返回true；否则，就返回false。</p>  
<p class="title_2">说明</p>  
<p>通常在Forms Designer内部使用该方法。</p>  
<p>Column.shouldPersistForeColor</p>  
<p>指明列前景颜色是否应该永久性保存。</p>  
<p class="title_2">语法</p>  
<p>public boolean shouldPersistForeColor ()</p>  
<p class="title_2">返回值</p>  
<p>如果要永久性保存列前景颜色，就返回true；否则，就返回false。</p>  
<p class="title_2">说明</p>  
<p>通常在Forms Designer内部使用该方法。</p>  
<p>Column.shouldPersistSelectedBackColor</p>  
<p>指明列中所选中单元的背景颜色是否应该永久性保存。</p>  
<p class="title_2">语法</p>  
<p>public boolean shouldPersistSelectedBackColor ()</p>  
<p class="title_2">返回值</p>  
<p>如果要永久性保存列中所选中单元的背景颜色，就返回true；否则，就返回false。</p>  
<p class="title_2">说明</p>  
<p>通常在Forms Designer内部使用该方法。</p>  
<p>Column.shouldPersistSelectedForeColor</p>  
<p>指明列中所选中单元的前景颜色是否应该永久性保存。</p>  
<p class="title_2">语法</p>  
<p>public boolean shouldPersistSelectedForeColor ()</p>  
<p class="title_2">返回值</p>  
<p>如果要永久性保存列中所选中单元的前景颜色，就返回true；否则，就返回false。</p>  
<p class="title_2">说明</p>  
<p>通常在Forms Designer内部使用该方法。</p>  
<p>Column.toString</p>  
<p>检取列的描述信息。</p>  
<p class="title_2">语法</p>  
<p>public String toString ()</p>  
<p class="title_2">返回值</p>  
<p>返回列的描述信息字符串。</p>  
<p class="title_2">说明</p>  
<p>toString所返回的字符串提供了下列有关列的信息：</p>  
<p>* 类名。</p>  
<p>* 绑定字段的名字。</p>  
<p>* 记录集中字段的索引。</p>  
<p>* 列的索引。</p>  
<hr><p class="title_1"><a name="ColumnEditingEvent类">ColumnEditingEvent类</a></p>  
<p>为DataGrid控件的columnEditing事件提供数据。</p>  
<pre>Event
  |
  + -- ColumnEditingEvent
</pre> 
<p>package com.ms.wfc.data.ui</p>  
<p>public final class ColumnEditingEvent</p>  
<p>extends Event</p>  
<p class="title_2">说明</p>  
<p>当单元进入编辑状态时就触发columnEditing事件。ColumnEditingEvent对象指明要被编辑的列以及触发该事件所按下的键，并提供取消该事件的标记。</p>  
<p>有关WFC事件模型的信息，请参阅《Microsoft Visual J++ 6.0 程序员指南》第12章“WFC编程概念”中的“WFC中的事件处理”一节。</p>  
<p class="title_2">字段</p>  
<p>ColumnEditingEvent.cancel</p>  
<p>指明是否取消该事件。</p>  
<p class="title_2">语法</p>  
<p>public boolean cancel ;</p>  
<p class="title_2">说明</p>  
<p>将该字段设置为true将取消columnEditing事件并退出单元的编辑模式。</p>  
<p>ColumnEditingEvent.column</p>  
<p>指明正在被编辑列的零基索引值。</p>  
<p class="title_2">语法</p>  
<p>public final int column ;</p>  
<p>ColumnEditingEvent.keyAscii</p>  
<p>指明触发该事件所按下的键的ASCII码。</p>  
<p class="title_2">语法</p>  
<p>public final int keyAscii;</p>  
<p class="title_2">说明</p>  
<p>如果用户按下的是F2或使用鼠标进入编辑模式，该字段的值就是0。</p>  
<p class="title_2">构造器</p>  
<p>ColumnEditingEvent.ColumnEditingEvent</p>  
<p>创建一个ColumnEditingEvent对象。</p>  
<p class="title_2">语法</p>