com.ms.wfc.html

提供Java类对动态HTML对象模型的访问。这包括客户和服务器应用程序。

类

DhAlignment

定义对齐常量。

DhBaseContainer

代表所有容器元件的基类。

DhBorderInfo

提供有关元件边框风格的结构化信息。

DhBorders

定义边框位置常量。

DhBorderStyle

定义边框风格常量。

DhBreak

实现HTML分割线元件。

DhBrowser

使能对IE浏览器功能的访问。

DhBulletedList实现HTML中排序或非排序的项目或数字列表。

DhButton

实现了HTML按钮控件。

DhCantAddElementException

指明对命名元件的请求失败，因为该命名元件不存在。

DhCantModifyElementException

指明试图要修改只读的元件，比如从服务器发送给客户端的元件。

DhCell

创建表格单元。

DhCheckBox

实现了HTML内部带文本标签的复选框。

DhComboBox

实现了HTML下拉式组合框控件。

DhComponentWrapper

封装WFC控件以便从HTML文档中进行访问。

DhCursor

定义控制元件游标风格的常量。

DhDialogInfo

代表对话框的信息类。

DhDocument

代表HTML文档。

DhEdit

实现了HTML编辑框控件。

DhElement

代表了该包中所有用户界面元件的超类。

DhElementExistsInDocumentException

指明所指定的元件已经添加到了文档中。

DhElementNotFoundException

指明对指定元件的请求失败，因为该元件名字不存在。

DhEnumeration

代表HTML文档中元件的集合。

DhEventInfo

将数据源中的事件信息传递给事件槽(sink)。

DhForm

代表使用传统HTML一维流布局的元件容器。

DhHorizontalRule

代表在页面上创建水平分隔栏的HTML水平规则元件。

DhHotSpot

实现代表图像映射中热点的对象。

DhHotSpotShapes

提供了DhHotSpoe形状常量。

DhHTMLGenerator

代表生成HTML的基类。

DhHyperlink创建文档中到书签或当前文档元件或不同文档的跳转。

DhImage

实施在文档中显示点位图文件的图像对象。

DhInlineFrame

代表联编框架元件。

DhInsertOptions

提供将DhElement项插入容器项中的常量。

DhJumpPoint

代表文档中的书签。

DhLinkTarget

提供设置文档目的地窗口的常量。

DhListBox

实现了HTML列表框框架。

DhListType

提供常量并支持DhBulletedList框架中的列表类型。

DhMargins

提供有关元件边缘空白设置的结构化信息。

DhMarginWidthInfo

提供定义边缘空白操作的常量。

DhModule

提供com.ms.wfc.html包的设置服务。

DhObjectFactory

从现有的ActiveX/COM或Java对象中创建一个对象，并将该对象添加到文档中。

DhPaddings

提供填充风格操作的常量。

DhPaddingWidthInfo

提供有关元件填充宽度设置的结构化信息。

DhPropertyBag

检取模块PARAM标记中的属性值。

DhRadioButton

实现了HTML内部的带文本标签的单选按钮。

DhRawHTML

使能原HTML任意输出到文档中。

DhResetButton

实现了HTTP表单提交过程的重置(reset)按钮控件。

DhRow

实现了DhTable表格中的一行。

DhScrollBars

定义滚动条常量。

DhSelectBox

代表DhComboBox和DhListBox控件的基类。

DhStyle

代表可任意应用于任何元件的属性集合。

DhStyleBase

提供了支持风格类的超类，如DhStyle和DhElement对象。

DhSubmitButton

实现了HTTP表单提交过程的提交按钮控件。

DhTable

创建了可以填充行和列数据的表格元件。

DhText

代表HTML文档中的静态文本。

DhTextMode

定义DhText类的模式常量。

DhUnits提供DHTML中各种单位类型的常量。

DhWindow封装了HTML窗口。

DhWindowInfo

提供新浏览器或模式对话框窗口特征设置常量。

DhAlignment类

定义对齐常量。

Enum
  |
  + -- DhAlignment

package com.ms.wfc.html

public class DhAlignment

extends Enum

说明

DhStyleBase, DhElement, DhListBox和DhRadioButton类使用对齐格式常量。

字段

DhAlignment.ABSBOTTOM

指明垂直底边对齐。

语法

public static final int ABSBOTTOM;

DhAlignment.ABSMIDDLE

指明垂直中间对齐。

语法

public static final int ABSMIDDLE;

DhAlignment.BASELINE

指明与当前文本行的基准线对齐。

语法

public static final int BASELINE;

DhAlignment.BOTTOM

指明与底线对齐。

语法

public static final int BOTTOM;

DhAlignment.CENTER

指明中间对齐。

语法

public static final int CENTER;

DhAlignment.JUSTIFY

指明调整对齐格式。

语法

public static final int JUSTIFY;

DhAlignment.LEFT

指明DhRadionButton和DhCheckBox中文本左对齐、按钮右对齐。

语法

public static final int LEFT;

DhAlignment.RIGHT

指明DhRadionButton和DhCheckBox中文本右对齐、按钮左对齐。

语法

public static final int RIGHT;

DhAlignment.SUBSCRIPT

指明下标属性。

语法

public static final int SUBSCRIPT;

DhAlignment.SUPERSCRIPT

指明上标属性。

语法

public static final int SUPERSCRIPT;

DhAlignment.TEXTTOP

指明与当前文本行的顶部对齐。

语法

public static final int TEXTTOP;

DhAlignment.TOP

指明与顶部对齐。

语法

public static final int TOP;

方法

DhAlignment.valid

确定所指定的值是否是该枚举类型中的有效值。

语法

public static boolean valid ( int n )

参数

n

要检查的值。

返回值

如果该值有效，就返回true；否则，就返回false。

说明

你应该在自己的枚举类中覆盖该方法。

DhBaseContainer类

代表所有容器元件的基类。

Component
|
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +-- DhBaseContainer

package com.ms.wfc.html

public abstract class DhBaseContainer

extends DhElement

implements ITopLevelWindow

说明

应该派生该类而不要实化它。

方法

DhBaseContainer.add

给容器增加一个Java Windows基础类(WFC)控件。

语法

public void add ( Control c )

public void add ( DhElement e )

public void add ( DhElement e, int insertFlag )

public void add ( DhElement e, DhElement relativeTo, int insertFlag )

参数

c

要增加的WFC控件。

e

要增加的元件。

insertFlag

DhInsertOptions中的插入位置。

relativeTo

相对于哪个元件来添加新元件。

请参阅：remove

DhBaseContainer.dispose

释放与该元件关联的所有资源。

语法

public void dispose ()

说明

在运行时不应该调用该方法。当元件释放进行垃圾回收时，该元件所使用的任何资源都将被释放。继承该类应总是调用超类的dispose方法。

DhBaseContainer.findElement

查找指定对等元件、ID、索引或DhElement对象的子元件。

语法

public DhElement findElement ( IUnknown peer )

public DhElement findElement ( String ID )

public DhElement findElement ( int index )

public int findElement ( DhElement e )

参数

peer

对等元件的引用。

ID

要查找元件的ID。

index

要返回子元件的原始位置。

e

要检取其索引值的DhElement子对象。

返回值

返回一个子元件，如果没有找到，就返回null。

异常

如果没有找到合适的子元件，就产生DhElementNotFoundException异常。

DhBaseContainer.getAllElements

递归检取所有的子元件以及它们的子元件。

语法

public DhElement[] getAllElements ()

返回值

返回所有子元件的矩阵。

DhBaseContainer.getElementCount

检取容器中子元件的数量。

语法

public int getElementCount()

返回值

返回子元件的数量。

DhBaseContainer.getElements

检取该容器的直接子元件。

语法

public DhElement[] getElements ()

返回值

返回直接子元件的矩阵。

DhBaseContainer.onChildAdded

当给该容器添加了新的子元件时框架就调用该方法。

语法

protected void onChildAdded ( DhElement eChild )

参数

eChild

对子元件的引用。

说明

给你自己的派生类中覆盖该方法，这样，如果给容器添加了子元件就可以通知你了。注意，只有该容器可以有子元件的情况下才是正确的。例如，当用户调用该容器的DhBaseContainer.add或者使用DhBaseContainer.findElement方法将HTML页面上已经存在的元件绑定到该容器的子元件时就调用该方法。

不要给该类增加添加元件的函数，如addText或newLine，或者会无限递归的方法。然而，你可以覆盖该方法给其他的容器添加元件。

DhBaseContainer.onChildRemoved

当从容器中删除一个子元件时就调用该方法。

语法

protected void onChildRemoved ( DhElement removedChild )

参数

removedChild

对已删除子元件的引用。

说明

给你自己的派生类中覆盖该方法，这样，如果在容器中删除了子元件就可以通知你了。注意，只有该容器可以有子元件的情况下才是正确的。

DhBaseContainer.onChildrenFound

当该容器的所有直接子元件都可以使用时就调用该方法。

语法

protedted void onChildrenFound ()

说明

给你自己的派生类中覆盖该方法，这样，如果容器所有的子元件可以使用时就可以通知你了。当检查子元件时就调用该方法。当你调用DhDocument.findElement指明现有Web页面上的一个元件或者需要执行检查该子元件状态的操作时，就将调用该方法。处于性能上的考虑，com.ms.wfc.html包推迟该操作直到需要数据时才执行该方法。

DhBaseContainer.remove

从容器中删除一个元件。

语法

public int remove ( DhElement element )

参数

element

要删除的元件。

返回值

返回所删除元件原来的顺序位置。

异常

如果element不是该容器的子元件就产生WFCInvalidArgumentException异常。

请参阅：add

DhBaseContainer.removeAll

从容器中删除所有的子元件。

语法

public void removeAll ()

说明

在调用该方法之前加入的所有元件都将看不见了。

DhBaseContainer.replace

将一个子元件替换为另一个。

语法

protected void replace ( DhElement eCur, DhElement eNew )

参数

eCur

要替换的元件。

eNew

新元件。

异常

如果eCur不是该容器的子元件，就产生DhElementNotFoundException异常。

DhBaseContainer.setDocument

设置与该容器关联的文档。

语法

public void setDocument ( DhDocument document )

参数

document

要设置的文档。

DhBaseContainer.setNewComponents

给容器增加文档。

语法

public final void setNewComponents ( Component[] comps )

参数

comps

代表要添加到控件中的组件矩阵。

说明

只能从com.ms.wfc.ui.Control或DhElement中派生组件。

DhBaseContainer.setNewElements

给容器添加HTML元件。

语法

public final void setNewElements ( DhElement[] elems )

参数

elems

代表要添加到容器的HTML元件矩阵。

说明

只能从DhElement中派生组件。

DhBorderInfo类

提供有关元件边框风格的结构化信息。

package com.ms.wfc.html

public class DhBorderInfo

说明

DhStyleBase.getBorderInfor和DhStyleBase.setBorderInfo方法使用这些常量。

字段

DhBorderInfo.bottomColor

指明底线边框颜色。

语法

public Color bottomColor;

DhBorderInfo.bottomStyle

指明当前底线边框风格，是一个DhBorderStyle常量。

语法

public int bottomStyle;

DhBorderInfo.bottomWidth

一个正数，指明当前底线边框宽度，单位由bottomWidthUnit指定。

语法

public int bottomWidth;

说明

当且仅当宽度是值/单位格式（比如20px）而且bottomWidthUnit不等于NULL时该标签才有效。

DhBorderInfo.bottomWidthUnit

指明当前底线边框宽度的单元，是DhUnits中的一个常量。

语法

public int bootomWidthUnit;

说明

当且仅当宽度是值/单位格式（比如20px）而且该值不等于NULL时该标签才有效。

有关单位标签常量的信息，请参阅DhUnits。

DhBorderInfo.leftColor指明左边框颜色。

语法

public Color leftColor;

DhBorderInfo.leftStyle

指明当前左边框风格，是一个DhBorderStyle常量。

语法

public int leftStyle;

DhBorderInfo.leftWidth

一个整数，指明当前左边框宽度，单位由leftWidthUnit指定。

语法

public int leftWidth;

DhBorderInfo.leftWidthUnit

指明左边框宽度的单元，是DhUnits中的一个常量。

语法

public int leftWidthUnit;

说明

当且仅当宽度是值/单位格式（比如20px）而且该值不等于NULL时该标签才有效。

有关单位标签常量的信息，请参阅DhUnits。

DhBorderInfo.rightColor

指明右边框颜色。

语法

public Color rightColor;

DhBorderInfo.rightStyle

指明当前右边框风格，是一个DhBorderStyle常量。

语法

public int rightStyle;DhBorderInfo.rightWidth

指明当前右边框宽度。

语法

public int rightWidth;

DhBorderInfo.rightWidthUnit

指明右边框宽度的单元，是DhUnits中的一个常量。

语法

public int rightWidthUnit;

说明

当且仅当宽度是值/单位格式（比如20px）而且该值不等于NULL时该标签才有效。

有关单位标签常量的信息，请参阅DhUnits。

DhBorderInfo.topColor

指明上边框颜色。

语法

public Color topColor;

DhBorderInfo.topStyle

指明当前上边框风格，是一个DhBorderStyle常量。

语法

public int topStyle;

DhBorderInfo.topWidth

一个整数，指明当前上边框宽度，单位由topWidthUnit指定。

语法

public int topWidth;

DhBorderInfo.topWidthUnit

指明上边框宽度的单元，是DhUnits中的一个常量。

语法

public int topWidthUnit;

说明

当且仅当宽度是值/单位格式（比如20px）而且该值不等于NULL时该标签才有效。

有关单位标签常量的信息，请参阅DhUnits。

构造器

DhBorderInfo.DhBorderInfo

创建一个DhBorderInfo对象。

语法

public DhBorderInfo ()

public DhBorderInfo (DhBorderInfo biInit )

参数

biInit

用于初始化该DhBorderInfo对象的现有的DhBorderInfo对象。

方法

DhBorderInfo.close

检取该DhBorderInfo对象的等价拷贝。

语法

public DhBorderInfo clone ()

返回值

返回一个新的DhBorderInfo对象。

DhBorderInfo.copy

将另一个DhBorderInfo对象的内部数据拷贝到该对象中。

语法

public void copy (DhBorderInfo biOther )

参数

biOther

要拷贝的DhBorderInfo类。

DhBorders类

定义边框位置常量。

Enum
   |
   +-- DhBorders

package com.ms.wfc.html

public class DhBorders

extends Enum

说明

DhStyleBase.setBorderStyle和DhStyleBase.setBorderWidth方法使用该类指明要设置哪条边。可以使用位操作符OR组合多个值。

字段

DhBorders.ALL

指明所有边框的组合。这等价于（TOP | RIGHT | BOTTOM | LEFT）。

语法

public static final int ALL;

DhBorders.BOTTOM

指明底边框。

语法

public static final int

BOTTOM;DhBorders.LEFT

指明左边框。

语法

public static final int LEFT;

DhBorders.RIGHT

指明右边框。

语法

public static final int RIGHT;

DhBorders.TOP

指明上边框。

语法

public static final int TOP;

方法

DhBorders.valid

确定所指定的值是否是该枚举类型中的有效值。

语法

public static boolean valid ( int n )

参数

n

要检查的值。

返回值

如果该值是类中的有效值，就返回true；否则，就返回false。

说明

你应该在自己的枚举类中覆盖该方法。

DhBorderStyle类

定义边框风格常量。

Enum
   |
   +-- DhBorderStyle

package com.ms.wfc.html

public class DhBorderStyle

extends Enum

说明

DhStyleBase.getBorderInfo和DhStyleBase.setBorderInfo方法在使用DhBorderInfo时要使用该类中的常量。

字段

DhBorderStyle.DOUBLE

指明在元件背景上方绘制双线边框。

语法

public static final int DOUBLE;

说明

两条单线以及这两条单线之间的间距加起来就等于该边框的宽度值。该边框宽度必须至少比绘制双边框还宽出3个像素。

DhBorderStyle.GROOVE

指明用指定的颜色值绘制三维凹槽。

语法

public static final int GROOVE;

DhBorderStyle.INSET

指明用指定的颜色值绘制三维嵌入部分。

语法

public static final int INSET;

DhBorderStyle.NONE

指明不绘制任何边框（不管边框宽度值）。

语法

public static final int NONE;

DhBorderStyle.OUTSET

指明用指定的颜色值绘制三维凸起部分。

语法

public static final int OUT

SET;DhBorderStyle.RIDGE

指明用指定的颜色值绘制三维脊线。

语法

public static final int RIDGE;

DhBorderStyle.SOLID

指明边框采用实心线条。

语法

public static final int SOLID;

方法

DhBorderStyle.valid

确定所指定的值是否是给枚举类型中的有效值。

语法

public static boolean valid ( int n )

参数

n

要检查的值。

返回值

如果所指定的值是该类中的有效值，就返回true；否则，就返回false。

说明

你应该在自己的枚举类中覆盖该方法。

DhBreak类

实现HTML中的分割线(
)元件。

Component
  |
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +-- DhBreak

package com.ms.wfc.html

public class DhBreak

extends DhElement

字段

DhBreak.CLEAR_ALL

插入垂直空间，这样，就可以越过所有的浮动图像显示文本信息。

语法

public static final int CLEAR_ALL;

DhBreak.CLEAR_LEFT

插入垂直空间，这样，就可以越过左对齐浮动图像来显示文本信息。

语法

public static final int CLEAR_LEFT;

DhBreak.CLEAR_NONE

插入标准的行分隔符。

语法

public static final int CLEAR_NONE;

DhBreak.CLEAR_RIGHT

插入垂直空间，这样，就可以越过右对齐的浮动图像显示文本信息。

语法

public static final int CLEAR_RIGHT;

构造器

DhBreak.DhBreak

创建一个DhBreak对象。

语法

public DhBreak()

public DhBreak ( int clearFlag )

参数

clearFlag

清除类型标记。

说明

缺省的构造器所创建的DhBreak对象使用标准的行分隔符（CLEAR_NONE）。

请参阅：CLEAR_LEFT, CLEAR_RIGHT, CLEAR_ALL

方法

DhBreak.getClearFlag

检取当前的清除标记。

语法

public int getClearFlag ()

返回值

返回当前的标记类型。

请参阅：setClearFlag, CLEAR_NONE, CLEAR_LEFT, CLEAR_RIGHT,CLEAR_ALL

DhBreak.setClearFlag

设置当前的清除标记。

语法

public void setClearFlag ( int clearFlag )

参数

clearFlag

新的标记类型。

请参阅：getClearFlag, CLEAR_NONE, CLEAR_LEFT, CLEAR_RIGHT,CLEAR_ALL

DhBrowser类

使能对IE浏览器功能的访问。

package com.ms.wfc.html

public class DhBrowser

说明

要使用该类，调用DhWindow.getBrowser方法，该方法将返回一个DhBrowser对象实例。下面的代码演示了如果检取并显示所有的浏览器字符串属性：

public class Class1 extends DhDocument

{
protected void initForm ()
{
	DhWindow thisWindow = this.getWindow() ;
	DhBrowser browser = thisWindow.getBrowser () ;
	DhText t1, t2, t3, t4, t5, t6, t7, t8, t9, t10 ;
	this.add ( t1 = new DhText"(AppCodeName = "+browser.getAppCodeName ())) ;
	this.newLine ();
	this.add ( t2 = new DhText("MinorVersion = "+browser.getAppMinorVersion ())) ;this.newLine ();
	this.add ( t3 = new DhText("AppName = "+ browser.getAppName ())) ;
	this.newLine ();
	this.add ( t4 = new DhText("AppVersion = "+ browser.getAppVersion())) ;
	this.newLine ();
	this.add ( t5 = new DhText("BrowserLanguage = "+browser.getBrowserLanguage ())) ;
	this.newLine ();
	this.add ( t6 = new DhText("CpuClass = "+ browser.getCpuClass ())) ;
	this.newLine ();
	this.add ( t7 = new DhText("Platform = "+ browser.getPlatform ())) ;
	this.newLine ();this.add ( t8 = new DhText("SystemLanguage = "+browser.getSystemLanguage ())) ;
	this.newLine ();
	this.add ( t9 = new DhText("UserAgent = "+ browser.getUserAgent ())) ;
	this.newLine ();
	this.add ( t10 = new DhText("UserLanguage = "+ browser.getUserLanguage ())) ;
}
}

方法

DhBrowser.getAppCodeName

检取浏览器代码名字。

语法

public String getAppCodeName ()

返回值

返回浏览器的代码名字（例如，“Mozilla”）。

DhBrowser.getAppMinorVersion

检取应用程序二级版本号字符串。

语法

public String getAppMinorVersion ()

返回值

返回浏览器的二级版本号（例如“;SP1”）。

DhBrowser.getAppName

检取浏览器的名字。

语法

public String getAppName ()

返回值

返回浏览器的名字（例如“Microsoft Internet Explorer”）。

DhBrowser.getAppVersion

检取浏览器的版本号。

语法

public String getAppVersion ()

返回值

返回浏览器的版本号（例如“4.0 (compatible;MSIE 4.01;Windows95”）。

DhBrowser.getBrowserLanguage

检取浏览器语言设置。

语法

public String getBrowserLanguage ()

返回值

返回包含浏览器语言的字符串。

DhBrowser.getCookieEnabled

确定浏览器中是否使能客户端小应用（cookie）。

语法

public boolean getCookieEnabled ()

返回值

如果使能，就返回true；否则，就返回false。

DhBrowser.getCpuClass

检取CPU类型字符串。

语法

public String getCpuClass ()

返回值

返回CPU的类型，比如“x86”,“Alpha”或“Other”。

DhBrowser.getOnLine

确定浏览器是否连到了网络上。

语法

public boolean getOnLine ()

返回值

如果该浏览器连到了网络上就返回true；否则，就返回false。

DhBrowser.getPeer

检取该类底层的对等对象。

语法

public IUnknown getPeer ()

返回值

返回DhBrowser对象底层的对等对象。

说明

该方法实现了IOmNavigator界面。调用该方法需要很高的技巧。通常，你并不需要直接使用该方法。

DhBrowser.getPlatform

检取平台的设置。

语法

public String getPlatform ()

返回值

返回平台字符串（例如“Win32”）。

DhBrowser.getSystemLanguage

检取系统语言设置。

语法

public String getSystemLanguage ()

返回值

返回包含系统语言的字符串（例如“en-us”）。

DhBrowser.getUserAgent

检取HTTP用户代理信息头字符串。

语法

public String getUserAgent ()

返回值

返回用户代理信息头字符串（例如“Mozilla/4.0(compatible;MSIE4.01;Windows 95”）。

DhBrowser.getUserLanguage

检取用户语言设置。

语法

public String getUserLanguage ()

返回值

返回包含用户语言的字符串（例如“en-us”）。

DhBulletedList类

实现了HTML中排序和未排序项目符号和数字列表。

Component
  |
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +-- DhBaseContainer
           |
           +-- DhBulletedList

package com.ms.wfc.html

public class DhBulletedList

extends DhBaseContainer

implements DhStringIDs

说明

这是一个简单的容器类，可以给其添加项目，每个项目都将相应地收到自己的符号或数字序号。

构造器

DhBulletedList.DhBulletedList

创建一个DhBulletedList对象。

语法

public DhBulletedList ()

public DhBulletedList ( int listType )

参数

listType

列表类型，可以是DhListType中定义的一个常量。

异常

如果listType不是类常量之一，就产生WFCInvalidEnumException异常。

说明

缺省构造器创建项目符号列表（DhListType.BULLETED）。

方法

DhBulletedList.addItem

将指定的元件添加到列表的末尾。

语法

public void addItem ( DhElement e )

参数

e

要添加的元件。

DhBulletedList.getAllElements

反复检取所有的子元件和它们的子元件。

语法

public DhElement[] getAllElements()

返回值

返回所有子元件的矩阵。

DhBulletedList.getElementIndex

如果所选定的元件是列表的直接子元件，就检取它的索引。

语法

public int getElementIndex ( DhElement e )

参数

e

要检取其索引值的元件。

返回值

返回该元件的零基索引值，如果列表中没有该元件，就返回-1。

DhBulletedList.getItem

检取指定索引位置处的元件。

语法

public DhElement getItem ( int index )

参数

index

要检取元件的索引。

异常

如果index不在列表中，就产生WFCInvalidArgumentException异常。

DhBulletedList.getItems

检取列表中元件的矩阵。

语法

public DhElement[] getItems ()

返回值

返回列表中元件的矩阵。

DhBulletedList.getListType

检取当前的列表类型。

语法

public int getListType ()

返回值

返回DhListType中提供的一个常量。

请参阅：setListType

DhBulletedList.insertItem

在指定的列表索引位置处插入一个元件。

语法

public void insertItem ( DhElement newElement, int index )

参数

newElement

要插入的新元件。

index

该元件放置位置的零基索引。

说明

如果索引值比0小或比列表中的元件数量大，该元件就插入在列表的末尾。

请参阅：remove

DhBulletedList.remove

从列表中删除指定的元件。

语法

public int remove ( DhElement e )

参数

e

要删除的元件。

返回值

返回被删除元件的索引值。如果没有找到该元件，就返回-1。

请参阅：removeAll

DhBulletedList.removeAll

从列表中删除所有的元件。

语法

public void removeAll ()

DhBulletedList.removeItem

从列表指定的索引位置处删除元件。

语法

public void removeItem ( int index )

参数

index

要删除元件的索引。

返回值

返回被删除元件的索引值。

DhBulletedList.setItem

设置或替换指定索引位置上的项。

语法

public void setItem ( int index, DhElement e )

参数

index

要设置项的索引。如果该索引值比0小或比列表长度大，该项就添加到列表的末尾。

e

要添加到列表中的元件。

说明

如果列表中没有所指定的索引，该项就添加到列表中。

DhBulletedList.setItems

设置列表中所有的项。

语法

public void setItems ( DhElement[] elements )

参数

elements

列表中新项的DhElement矩阵。

说明

替换列表目前所有的项。

DhBulletedList.setListType

设置当前的列表类型。

语法

public void setListType ( int newType )

参数

newType

需要的列表类型，是DhListType中提供的常量之一。

请参阅：getListType

DhButton类

实现了HTML按钮控件。

DhButtonBase
  |
  +-- DhButton

package com.ms.wfc.html

public class DhButton

extends DhButtonBase

说明

HTTP表单的内部或外部都可以使用该控件。

构造器

DhButton.DhButton

创建一个按钮。

语法

public DhButton ()

public DhButton ( String strText )

参数

strText

新按钮的标签。

说明

缺省构造器创建的按钮带有缺省的文本标签“button”

方法

DhButton.getEnabled

检取按钮的使能状态。

语法

public boolean getEnabled ()

返回值

如果按钮使能，就返回true；否则，就返回false。

请参阅：setEnabled

DhButton.getText

检取按钮的标签。

语法

public String getText ()

返回值

返回当前的标签字符串。

请参阅：setText

DhButton.setEnabled

设置按钮单位使能状态。

语法

public void setEnabled ( boolean f )

参数

f

要使能按钮，就设置为true；否则，就设置为false。

请参阅：getEnabled

DhButton.setText

设置按钮的文本标签。

语法

public void setText ( String strText )

参数

strText

新的标签。

请参阅：getText

DhCantAddElementException类

指明对命名元件的请求失败，因为所指定的命名元件不存在。

RunTimeException
  |
  + -- WFCException
      |
      +-- DhCantAddElementException

package com.ms.wfc.html

public class DhCantAddElementException

extends WFCException

构造器

DhCantAddElementException.DhCantAddElementException

创建一个DhCantAddElementException对象。

语法

public DhCantAddElementException ()

public DhCantAddElementException ( String s )

参数

s

异常的详细消息。

说明

缺省构造器创建的异常没有详细消息。

DhCantModifyElementException类

指明试图修改只读元件，比如从服务器发送给客户端的对象。

RunTimeException
  |
  +-- WFCException
     |
     +-- DhCantModifyElementException

package com.ms.wfc.html

public class DhCantModifyElementException

extends WFCException

说明

只在服务器应用程序上才产生这类异常。当试图对同一个元件执行多次DhModule.write操作时就产生该异常。在第一次调用write后，元件就成为只读的。

构造器

DhCantModifyElementException.DhCantModifyElementException

创建一个DhCantModifyElementException对象。

语法

public DhCantModifyElementException ()

public DhCantModifyElementException ( String detail )

参数

detail

异常的详细消息。

说明

缺省构造器创建的异常没有详细消息。

DhCell类

创建一个table单元。

Component
  |
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +-- DhBaseContainer
           |
           +-- DhForm
              |
              +-- DhCell

package com.ms.wfc.html

public class DhCell

extends DhForm

说明

你可以使用add方法给单元添加任何布局类型的任何多个元件。

构造器

DhCell.DhCell

创建空的单元。

语法

public DhCell ()

public DhCell ( String text )

参数

text

单元的文本内容。

方法

DhCell.add

给单元增加一个元件。

语法

public void add ( DhElement e )

参数

e

要添加的DhElement 元件。

请参阅：remove

DhCell.getColSpan

检取该单元跨度范围内列的数量。

语法

public int getColSpan ()

返回值

返回当前单元跨度范围内列的数量。

请参阅：setColSpan

DhCell.getColumnNumber

检取该单元所在的列号。

语法

public int getColumnNumber ()

返回值

返回单元所在的列号；如果单元不在表格中，就返回-1。

说明

因为表格中的行可以不同数量的列（单元），所返回的号码反映了包含该单元的行中列所在的位置。

DhCell.getRowNumber

检取该单元所在的行号。

语法

public int getRowNumber ()

返回值

返回单元的行号，如果该单元不在表格中就返回-1。

DhCell.getRowSpan

检取该单元跨度范围内行的数量。

语法

public int getRowSpan()

返回值

返回该单元跨度范围内所包含行的数量。

请参阅：setRowSpan

DhCell.getText

检取单元的文本。

语法

public String getText ()

返回值

返回单元的文本。

请参阅：setText

DhCell.getValue检取单元中显示的数字值。

语法

public int getValue ()

返回值

返回一个整数值。

请参阅：setValue, setText

DhCell.remove从单元中删除元件。

语法

public int remove ( DhElement e )

参数

e

要删除的DhElement元件。

返回值

如果成功删除该元件就返回true；否则，就返回false。

请参阅：add

DhCell.setColSpan

设置该单元所跨越的列数。

语法

public void setColSpan ( int span )

参数

span

单元应该跨越的列数。

请参阅：getColSpan

DhCell.setRowSpan

设置该单元所跨越的行数。

语法

public void setRowSpan ( int span )

参数

span

单元应该跨越的行数。

请参阅：getRowSpan

DhCell.setText

设置单元的文本。

语法

public void setText ( String text )

参数

text

要显示给用户的文本。

说明

设置该值将覆盖以前调用setText或setValue所设置的值。

请参阅：getText

DhCell.setValue

设置该调用的数字值。

语法

public void setValue ( int i )

参数

i

单元中显示的int值。

说明

设置该值将覆盖以前调用setText或setValue所设置的值。

请参阅：getValue

DhCheckBox类

实现HTML内部的带文本标签的复选框。

DhElement
  |
  +-- DhBaseContainer
     |
     +-- DhCheckBox

package com.ms.wfc.html

public class DhCheckBox

extends DhBaseContainer

构造器

DhCheckBox.DhCheckBox

创建一个DhCheckBox对象。

语法

public DhCheckBox ()

public DhCheckBox ( String strText, boolean fChecked )

参数

strText

文本标签。

fChecked

复选框初始化时的状态。

说明

缺省构造器（不带参数）没有标签也没有选择标记。带参数的构造器的标签缺省地是右对齐。

方法

DhCheckBox.addOnCheckedChange

为checkedChange事件指定一个代理。

语法

public final void addOnCheckedChange ( EventHandler h )

参数

h

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

说明

当用户修改了复选框的选择状态时就触发该事件。

请参阅：removeOnCheckedChange

DhCheckBox.addOnGotFocus

为gotFocus事件指定一个代理。

语法

final public void addOnGotFocus ( EventHandler h )

参数

h

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

说明

当该元件收到输入焦点时就调用代理所指定的方法。

请参阅：removeOnGotFocus

DhCheckBox.addOnLostFocus

为lostFocus事件指定一个代理。

语法

final public void addOnLostFocus ( EventHandler h )

参数

h

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

说明

当元件失去输入焦点时就调用代理所指定的方法。

请参阅：removeOnLostFocus

DhCheckBox.addOnResize

为resize事件指定一个代理。

语法

final public void addOnResize ( EventHandler h )

参数

h

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

说明

当元件改变大小时就调用代理所指定的方法。

请参阅：removeOnResize

DhCheckBox.addOnSelect

为select事件指定一个代理。

语法

final public void addOnSelect ( EventHandler h )

参数

h

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

说明

当用户选择该元件时就触发该事件。

请参阅：removeOnSelect

DhCheckBox.focus

将输入焦点设置给该控件。

语法

public void focus ()

DhCheckBox.getChecke

d检取复选框的选择状态。

语法

public boolean getChecked ()

返回值

如果复选框是选择状态，就返回true；否则，就返回false。

请参阅：setChecked

DhCheckBox.getEnabled

检取复选框的使能状态。

语法

public boolean getEnabled ()

返回值

如果复选框是使能的，就返回true；否则，就返回false。

请参阅：setEnabled

DhCheckBox.getSubmitName

检取复选框当前的NAME属性。

语法

public String getSubmitName ()

返回值

返回NAME属性。该属性仅用于HTTP表单提交过程；否则，就不需要该属性。

请参阅：setSubmitName

DhCheckBox.getSubmitValue

检取复选框的提交值。

语法

public String getSubmitValue ()

返回值

返回当前的提交值。

请参阅：setSubmitValue

DhCheckBox.getText

检取复选框当前的文本标签。

语法

public String getText ()

返回值

返回当前的文本标签。

请参阅：setText

DhCheckBox.getTextAlign

检取当前的对齐方式。

语法

public int getTextAlign ()

返回值

返回当前的对齐方式，可以是LeftRightAlignment.RIGHT或LeftRightAlignment. LEFT。

请参阅：setTextAlign

DhCheckBox.addOnCheckedChange

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

语法

final public void removeOnCheckedChange ( EventHandler h )

参数

h

要删除的EventHandler代理。

说明

请参阅：addOnCheckedChange

DhCheckBox.removeOnGotFocus

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

语法

final public void removeOnGotFocus ( EventHandler h )

参数

h

要删除的EventHandler代理。

说明

当该元件收到输入焦点时就触发gotFocus事件。

请参阅：addOnGotFocus

DhCheckBox.removeOnLostFocus

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

语法

final public void removeOnLostFocus ( EventHandler h )

参数

h

要删除的EventHandler代理。

说明

当元件失去输入焦点时就触发lostFocus事件。

请参阅：addOnLostFocus

DhCheckBox.removeOnResize

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

语法

public final void removeOnResize ( EventHandler h )

参数

h

要删除的EventHandler代理。

说明

当元件改变大小时就触发resize事件。

请参阅：addOnResize

DhCheckBox.removeOnSelect

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

语法

final public void removeOn ( EventHandler h )

参数

h

要删除的EventHandler代理。

说明

当用户选择该元件时就触发select事件。

请参阅：addOnSelect

DhCheckBox.setChecked设置复选框的选择状态。

语法

public void setChecked ( boolean fChecked)

参数

fChecked

如果复选框要处于选择状态，就设置为true；否则，就设置为false。

请参阅：getChecked

DhCheckBox.setEnabled

设置复选框的使能状态。

语法

public void setEnabled ( boolean f )

参数

f

要使能复选框，就设置为true；否则，就设置为false。

请参阅：getEnabled

DhCheckBox.setSubmitName

设置复选框HTTP提交名字。

语法

public void setSubmitName (String strName )

参数

strName

NAME属性。该名字在表单中应该是唯一的。

说明

在HTTP表单提交过程中该名字就充当HTML NAME属性。

请参阅：getSubmitName

DhCheckBox.setSubmitValue

设置复选框的HTTP提交值。

语法

public void setSubmitValue ( String strValue )

参数

strValue

新的提交值。

说明

在HTTP表单提交过程中该名字就充当HTML VALUE属性。

请参阅：getSubmitValue

DhCheckBox.setText

设置复选框的文本标签。

语法

public void setText (String strText)

参数

strText

复选框显示的标签。

说明

点击该标签就可以选择或清除复选框。

请参阅：getText

DhCheckBox.setTextAlign

设置当前的对齐方式。

语法

public void setTextAlign (int newAlignment )

参数

newAlignment

新的对齐方式，可以是LeftRightAlignment.RIGHT或LeftRightAlignment. LEFT。

请参阅：getTextAlign

DhComboBox类

实现了HTML下拉组合框控件。

Component
  |
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +-- DhBaseContainer
           |
           +-- DhSelectBox
              |
              +-- DhComboBox

package com.ms.wfc.html

public class DhComboBox

extends DhSelectBox

构造器

DhComboBox.DhComboBox

创建一个空的DhComboBox对象。

语法

public DhComboBox()