course4.htm

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

<p>在开始查找之前项的零基索引（即从该项开始查找）。如果从列</p>
<p>表开头查找，就设置为-1。</p>
<p class="title_2">返回值</p>
<p>返回所找到项的零基索引。如果没有找到，就返回-1。</p>
<p>DhSelectBox.findStringExact</p>
<p>在列表中查找与指定字符串严格匹配的项。</p>
<p class="title_2">语法</p>
<p>public int findStringExact ( String s )</p>
<p>public final int findStringExact ( String s, int startIndex )</p>
<p class="title_2">参数</p>
<p>s</p>
<p>要严格匹配的字符串。</p>
<p>startIndex</p>
<p>开始查找位置的零基索引。如果从头开始，就设置为-1。</p>
<p class="title_2">返回值</p>
<p>返回所找到项的零基索引；如果没有找到，就返回-1。</p>
<p>DhSelectBox.focus</p>
<p>将输入焦点设置给该控件。</p>
<p class="title_2">语法</p>
<p>public void focus ()</p>
<p>DhSelectBox.getEnabled</p>
<p>检取元件的使能状态。</p>
<p class="title_2">语法</p>
<p>public boolean getEnabled ()</p>
<p class="title_2">返回值</p>
<p>如果使能，就返回true；否则，就返回false。</p>
<p>请参阅：setEnabled</p>
<p>DhSelectBox.getItemCount</p>
<p>检取目前列表中项的数目。</p>
<p class="title_2">语法</p>
<p>public int getItemCount()</p>
<p class="title_2">返回值</p>
<p>返回项的数量。</p>
<p>DhSelectBox.getItemsSubmitValue</p>
<p>检取列表中与项提交值相对应的文本项矩阵。</p>
<p class="title_2">语法</p>
<p>public String[] getItemsSubmitValue ()</p>
<p class="title_2">返回值</p>
<p>返回项提交值的矩阵；如果没有项，就返回空矩阵。</p>
<p>DhSelectBox.getItemsText</p>
<p>检取列表中文本项矩阵。</p>
<p class="title_2">语法</p>
<p>public String[] getItemsText()</p>
<p class="title_2">返回值</p>
<p>返回列表项的矩阵，如果列表中没有项，就返回null。</p>
<p>DhSelectBox.getItemSubmitValue</p>
<p>检取索引处项的提交值。</p>
<p class="title_2">语法</p>
<p>public String getItemSubmitValue ( int index )</p>
<p class="title_2">参数</p>
<p>index</p>
<p>要查找提交值的项的零基索引；如果是当前选择的项，就设置为</p>
<p>-1。</p>
<p class="title_2">返回值</p>
<p>返回索引项的提交值。</p>
<p class="title_2">说明</p>
<p>在HTTP表单提交过程中使用提交值。</p>
<p>请参阅：setItemsSubmitValue</p>
<p>DhSelectBox.getItemText</p>
<p>检取指定索引项的文本。</p>
<p class="title_2">语法</p>
<p>public String getItemText ( int index )</p>
<p class="title_2">参数</p>
<p>index要查找文本值的项的零基索引；如果是当前选择的项，就设置为</p>
<p>-1。</p>
<p class="title_2">返回值</p>
<p>返回索引指定项的文本，如果指定为-1或者没有选择项就返回空字</p>
<p>符串(摂)。</p>
<p>请参阅：setItemText</p>
<p>DhSelectBox.getSelected</p>
<p>检取项当前的选择状态。</p>
<p class="title_2">语法</p>
<p>public boolean getSelected ( int index )</p>
<p class="title_2">参数</p>
<p>index</p>
<p>要查询项的零基索引。</p>
<p class="title_2">返回值</p>
<p>如果该项是处于选择状态，就返回true；否则就返回false。如果索</p>
<p>引值与列表中的项不匹配，也返回false。</p>
<p>请参阅：setSelected</p>
<p>DhSelectBox.getSelectedIndex</p>
<p>检取当前选择项的索引。</p>
<p class="title_2">语法</p>
<p>public int getSelectedIndex ()</p>
<p class="title_2">返回值</p>
<p>返回第一个选择项的零基索引。</p>
<p class="title_2">说明</p>
<p>如果在DhListBox中选择了多项，该方法就返回选择中的第一项。</p>
<p>DhSelectBox.getSelectedIndices检取包含当前所有选择项零基索引的矩阵。</p>
<p class="title_2">语法</p>
<p>public int[] getSelectedIndices()</p>
<p class="title_2">返回值</p>
<p>返回一个整数矩阵，包含了当前所有选择项的零基索引值。在单选列表框中，返回包含一个元素的矩阵。如果列表中没有选中的项，就返回空矩阵。DhSelectBox.getSelectedSubmitValue检取选中项的值。</p>
<p class="title_2">语法</p>
<p>public String getSelectedSubmitValue ()</p>
<p class="title_2">返回值</p>
<p>返回第一个选择项的提交值，如果没有选择项，就返回空字符串。如果选择了多项，就返回选择项中第一项的提交值。</p>
<p>DhSelectBox.getSelectedText检取当前选择项的文本。</p>
<p class="title_2">语法</p>
<p>public String getSelectedText()</p>
<p class="title_2">返回值</p>
<p>返回当前选择项文本，或者如果没有选择项，就返回空字符串。如果选择了多项，就返回选择项中第一项的文本。DhSelectBox.getSubmitName检取选择框的名字。</p>
<p class="title_2">语法</p>
<p>public String getSubmitName ()</p>
<p class="title_2">返回值</p>
<p>返回选择框的名字。</p>
<p class="title_2">说明</p>
<p>该NAME属性用于HTTP提交过程。</p>
<p>请参阅：setSubmitName</p>
<p>DhSelectBox.insertItem在列表指定索引处插入一项。</p>
<p class="title_2">语法</p>
<p>public void insertItem ( int index, String strText )public void insertItem ( int index, String strText, boolean fSelected )public void insertItme (int index, String strText, boolean fSelected,String strValue)</p>
<p class="title_2">参数</p>
<p>index在该索引处添加新项。如果比0小或比当前项的数量大，则该项就追加到列表的末尾。strText新项的文本。fSelected新项的选择状态。strValue该项的VALUE属性（用于HTTP表单提交）。</p>
<p>DhSelectBox.removeAll删除控件中的所有项。</p>
<p class="title_2">语法</p>
<p>public void removeAll ()DhSelectBox.removeItem从列表中删除指定索引项。</p>
<p class="title_2">语法</p>
<p>public void removeItem ( int index )</p>
<p class="title_2">参数</p>
<p>index要删除项的零基索引。</p>
<p>请参阅：addItemDhSelectBox. removeOnGotFocus删除为gotFocus事件指定的代理。</p>
<p class="title_2">语法</p>
<p>public final void removeOnGotFocus ( EventHandler h )</p>
<p class="title_2">参数</p>
<p>h指明事件处理器方法的EventHandler代理。</p>
<p class="title_2">说明</p>
<p>当元件收到输入焦点时就触发onGotFocus事件。DhSelectBox. removeOnLostFocus删除为lostFocus事件指定的代理。</p>
<p class="title_2">语法</p>
<p>public final void removeOnLostFocus ( EventHandler h )</p>
<p class="title_2">参数</p>
<p>h要删除的EventHandler代理。</p>
<p class="title_2">说明</p>
<p>当元件失去输入焦点时就触发lostFocus事件。</p>
<p>请参阅：addOnLostFocus</p>
<p>DhSelectBox. removeOnResize删除为resize事件指定的代理。</p>
<p class="title_2">语法</p>
<p>public final void removeOnResize ( EventHandler h )</p>
<p class="title_2">参数</p>
<p>h要删除的EventHandler代理。</p>
<p class="title_2">说明</p>
<p>当元件改变大小时就触发resize事件。</p>
<p>请参阅：addOnReszieDhSelectBox. removeOnSelectedIndexChanged删除为selectedIndexChanged事件指定的代理。</p>
<p class="title_2">语法</p>
<p>public final void addOnSelectedIndexChanged ( EventHandler h )</p>
<p class="title_2">参数</p>
<p>h要删除的EventHandler代理。</p>
<p class="title_2">说明</p>
<p>当改变当前选择的元件时就触发该事件。</p>
<p>请参阅：addOnSelectedIndexChangedDhSelectBox.setEnabled设置元件的使能状态。</p>
<p class="title_2">语法</p>
<p>public void setEnabled ( boolean f)</p>
<p class="title_2">参数</p>
<p>f如果要使能该控件，就设置为true；否则，就设置为false。</p>
<p>请参阅：getEnabledDhSelectBox.setItem更新某项的属性。</p>
<p class="title_2">语法</p>
<p>public void setItem ( int index , String strText, boolean fSel, StringstrValue )</p>
<p class="title_2">参数</p>
<p>index要更新项的索引。strText该项新的文本。fSel该项新的选择状态。strValue该项新的VALUE属性（用于HTTP表单提交）。</p>
<p class="title_2">说明</p>
<p>如果index与当前列表中的项不匹配，就在列表中添加一新项。如果将</p>
<p class="title_2">参数</p>
<p>指定为null，将不改变项的值。使用空字符串来清除字符串值。DhSelectedBox.setItems设置列表中的项。</p>
<p class="title_2">语法</p>
<p>public final void setItems ( String[] strings)public final void setItems ( String[] strings, boolean[] selected )public final void setItems ( String[] strings, boolean[] selected,</p>
<p>String[] submitValues )</p>
<p class="title_2">参数</p>
<p>strings要设置给列表的一个String矩阵。selected一个boolean矩阵，指明相应的项是否处于选择状态。submitValues一个String矩阵，相应项的提交值。</p>
<p class="title_2">说明</p>
<p>列表中的所有项都将被替换。DhSelectBox.setItemSubmitValue设置项的属性值。</p>
<p class="title_2">语法</p>
<p>public void setItemsSubmitValue ( int index, String stringValue )</p>
<p class="title_2">参数</p>
<p>index指定项的索引。stringValue</p>
<p>新值的字符串。异常如果索引指定的项不在列表中就产生WFCInvalidArgumentException异常消息。</p>
<p>请参阅：getItemSubmitValueDhSelectBox.setItemsText设置列表中指定项的文本属性。</p>
<p class="title_2">语法</p>
<p>public void setItemsText( int index , String strText )</p>
<p class="title_2">参数</p>
<p>index指定项的零基索引。strText该项新的文本。异常如果索引指定的项不在列表范围内，就产生WFCInvalidArgumentException异常消息。</p>
<p>请参阅：getItemText</p>
<p>DhSelectBox.setSelected设置列表中某项的选择状态。</p>
<p class="title_2">语法</p>
<p>public void setSelected ( int index , boolean value )</p>
<p class="title_2">参数</p>
<p>index要更新项的零基索引。value如果要选择该项，就设置为true；否则就设置为false。</p>
<p class="title_2">说明</p>
<p>如果列表允许选择多项，则该项的设置将不会影响其他项的选择状态。否则，其他项的选择状态将被清除。</p>
<p>请参阅：getSelectedDhSelectBox.setSelectedIndex设置当前选择项的索引。</p>
<p class="title_2">语法</p>
<p>public void setSelectedIndex ( int index )</p>
<p class="title_2">参数</p>
<p>index要选择项的零基索引。DhSelectBox.setSubmitName设置选择框的名字。</p>
<p class="title_2">语法</p>
<p>public void setSubmitName ( String strName )</p>
<p class="title_2">参数</p>
<p>strName选择框的名字。异常如果strName不是有效的名字（包含空格），就产生WFCInvalidArgumentException异常消息。</p>
<p class="title_2">说明</p>
<p>该NAME属性用于HTTP提交过程，代表HTML NAME属性。</p>
<p>请参阅：getSubmitName</p>
<hr><p class="title_1"><a name="DhStyle类">DhStyle类</a></p>
<p>表示了一个属性集合，该集合可任意应用于任何元件。</p>
<pre>Component
  |
  +-- DhStyleBase
     |
     +-- DhStyle</pre>
<p>package com.ms.wfc.html</p>
<p>public class DhStyle</p>
<p>extends DhStyleBase</p>
<p class="title_2">说明</p>
<p>该类的基本应用情形是创建该类的一个实例，调用DhElement.setStyle方法来使用这个实例。</p>
<p class="title_2">构造器：</p>
<p>DhStyle. DhStyle创建一个DhStyle对象。</p>
<p class="title_2">语法</p>
<p>public DhStyle()public DhStyle ( String name )</p>
<p class="title_2">参数</p>
<p>name用于生成底层HTML的风格的名字。</p>
<p class="title_2">说明</p>
<p>使用带</p>
<p class="title_2">参数</p>
<p>的</p>
<p class="title_2">构造器：</p>
<p>的给你的风格命名并控制该对象所生成的底层HTML代码。注意：这在缺省</p>
<p class="title_2">构造器：</p>
<p>中都完全替你处理完了。方法DhStyle.getName检取HTML对象所看到的该风格对象底层的名字。</p>
<p class="title_2">语法</p>
<p>public String getName ()</p>
<p class="title_2">返回值</p>
<p>返回风格规则的字符串名字。</p>
<p class="title_2">说明</p>
<p>这个一种高级技巧，并不是普通的操作。</p>
<p>请参阅：setNameDhStyle.setName设置HTML对象所看到的该风格对象底层的名字。</p>
<p class="title_2">语法</p>
<p>public void setName ( String name )</p>
<p class="title_2">参数</p>
<p>name风格规则的字符串名字。</p>
<p class="title_2">说明</p>
<p>这个一种高级技巧，并不是普通的操作。</p>
<p>请参阅：getName</p>
<hr><p class="title_1"><a name="DhStyleBase类">DhStyleBase类</a></p>
<p>为支持风格的类如DhStyle和DhElement对象等提供超类。</p>
<pre>Component
   |
   +-- DhStyleBase</pre>
<p>package com.ms.wfc.html</p>
<p>public abstract class DhStyle</p>
<p>Baseextends Component</p>
<p class="title_2">说明</p>
<p>扩展DhStyleBase的类都有某些印刷和可视化属性，如颜色和字体</p>
<p>等。该类是抽象类，不能被实化。</p>
<p>请参阅：DhStyle, DhElement</p>
<p class="title_2">字段</p>
<p>DhStyleBase.UNINITIALIZED</p>
<p>指明还没有设置该风格。</p>
<p class="title_2">语法</p>
<p>public final int UNINITIALIZED;</p>
<p class="title_2">方法</p>
<p>DhStyleBase.dispose</p>
<p>释放所有与该元件关联的资源。</p>
<p class="title_2">语法</p>
<p>public void dispose()</p>
<p class="title_2">说明</p>
<p>在运行时不应该调用该方法。当元件进行垃圾回收时，所有被该元</p>
<p>件使用的资源都将被释放。继承类应调用super.dispose。</p>
<p>DhStyleBase.getBackColor</p>
<p>检取背景颜色属性。</p>
<p class="title_2">语法</p>
<p>final public Color getBackColor()</p>
<p class="title_2">返回值</p>
<p>返回一个Color对象，即当前背景颜色。</p>
<p>请参阅：setBackColor</p>
<p>DhStyleBase.getBorderInfo</p>
<p>检取有关当前边框状态信息的DhBorderInfo类。</p>
<p class="title_2">语法</p>
<p>public DhBorderInfo getBorderInfo ()</p>
<p class="title_2">返回值</p>
<p>返回DhBorderInfo边框信息类。</p>
<p>请参阅：setBorderInfo</p>
<p>DhStyleBase.getBounds</p>
<p>检取元件的位置和大小。</p>
<p class="title_2">语法</p>
<p>final public Rectangle getBounds()</p>
<p class="title_2">返回值</p>
<p>以Rectangle对象返回元件的位置。</p>
<p>请参阅：getWidthUnit, getHeightUnit, getTopUnit, getLeftUnit,setBounds</p>
<p>DhStyleBase.getClipRect</p>
<p>检取当前剪裁矩形。</p>
<p class="title_2">语法</p>
<p>public Rectangle getClipRect()</p>
<p class="title_2">返回值</p>
<p>返回一个Rectangle对象，包含了当前剪裁矩形的大小。如果该未经</p>
<p>定义或使用setClip的String参数定义为 揳uto敚