DhRadioButton 类

优质

小牛编辑

127浏览

2023-12-01

DhRadioButton类

实现一个真正的带文本标签的HTML 单选按钮（radio button）。

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

package com.ms.wfc.html

public class DhRadioButton

extends DhBaseContainer

说明

单选按钮组允许在一个选项列表中唯一地选择其中一个选项。

构造器

DhRadioButton. DhRadioButton

创建一个DhRadioButton对象。

语法

public DhRadioButton()

pubilc DhRadioButton( String strText, boolean fChecked )

参数

strText

随按钮一起显示的标签文本。

FChecked

按钮的初始选择状态。

说明

缺省构造器创建一个空的单选按钮，没有选择也没有文本标签。你设置这些值来初始化它们。带参数的构造器创建的单选按钮带有右对齐的文本（LeftRight-Alignment.RIGHT）。

方法

DhRadioButton.addOnCheckedChange

为change事件指定一个代理。

语法

final public void addOnCheckedChange ( EventHandler h )

参数

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

说明

当按下的选择状态发生改变时就触发该事件。

请参阅：removeOnCheckedChange

DhRadioButton.addOnGotFocus

为gotFocus事件指定一个代理。

语法

public final void addOnGotFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnGotFocus

DhRadioButton.addOnLostFocus

为lostFocus事件指定一个代理。

语法

public final void addOnLostFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnLostFocus

DhRadioButton.addOnResize

为resize事件指定一个代理。

语法

public final void addOnResize ( EventHandler h )

参数

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

说明

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

请参阅：removeOnResize

DhRadioButton.addOnSelect

为select事件指定一个代理。

语法

final public void addOnSelect( EventHandler h )

参数

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

说明

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

请参阅：removeOnSelect

DhRadioButton.focus

设置该控件的输入焦点。

语法

public void focus()

DhRadioButton.getChecked

检取单选按钮当前的选择状态。

语法

public boolean getChecked ()

返回值

如果选择了该按钮就返回true；否则就返回false。

请参阅：setSubmitName, getSubmitName, setChecked

DhRadioButton.getEnabled

检取按钮当前的使能状态。

语法

public boolean getEnabled ()

返回值

如果该按钮处于使能状态，就返回true；否则就返回false。

请参阅：setEnabled

DhRadioButton.getName

检取按钮的名字。

语法

public String getName ()

返回值

返回按钮的名字。

请参阅：setName

DhRadioButton.getSubmitName

检取当前单选按钮控件的提交名字。

语法

public String getSubmitName ()

返回值

返回提交（组）名字。

说明

提交名字确定将与哪个单选按钮组连接。组中一次只能选择一个DhRadioButton按钮。

请参阅：setSubmitName

DhRadioButton.getSubmitValue

检取该单选按钮控件的提交值。

语法

public String getSubmitValue ()

返回值

返回提交（组）名字。

请参阅：setSubmitValue

DhRadioButton.getText

检取单选按钮当前的文本标签。

语法

public String getText ()

返回值

返回文本标签。

请参阅：setText

DhRadioButton.getTextAlign

检取当前的对齐方式。

语法

public int getTextAlign()

返回值

返回当前的对齐格式，可以是右对齐( LeftRightAlignment.RIGHT)或左对齐(LeftRightAlignment.LEFT)。

请参阅：setTextAlign

DhRadioButton.removeOnCheckedChange

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

语法

final public void removeOnCheckedChange ( EventHandler h )

参数

要删除的EventHandler代理。

请参阅：addOnCheckedChange

DhRadioButton. RemoveOnGotFocus

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

语法

public final void removeOnGotFocus ( EventHandler h )

参数

指明事件处理器方法的EventHandler代理。

说明

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

请参阅：addOnGotFocus

DhRadioButton. RemoveOnLostFocus

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

语法

public final void removeOnLostFocus ( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnLostFocus

DhRadioButton. RemoveOnResize

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

语法

public final void removeOnResize ( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnResize

DhRadioButton. RemoveOnSelect

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

语法

final public void removeOnSelect( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnSelect

DhRadioButton.setChecked

设置单选按钮的选择状态。

语法

public void setChecked ( boolean fValue )

返回值

如果要选择该按钮就设置为true；否则就设置为false。

说明

如果该按钮是组中的一员，则设置该值将影响组中其他的DhRadioButton项。

请参阅：setSubmitName, getSubmitName, getChecked

DhRadioButton.setEnabled

设置按钮的使能状态。

语法

public void setEnabled ( boolean f )

参数

如果想要按钮处于使能状态，就设置为true；要禁止该按钮，就设置为false。

请参阅：getEnabled

DhRadioButton.setName

设置按钮的名字。

语法

public void setName ( String n )

参数

按钮的名字。

请参阅：getName

DhRadioButton.setSubmitName

设置当前单选按钮控件的提交名字。

语法

public void setSubmitName ( String strName )

参数

strName

返回名字,也称为组名。每个文档中的组名必须唯一。

注意：strName参数不能包含空格；否则就产生异常消息。

异常

如果strName不是有效的对齐格式常量，就产生WFCInvalidArgumentException异常消息。

说明

同一个组中的DhRadioButton对象是互斥的；即一次只能选择一个DhRadioButton按钮。

而且，组名用于HTTP表单提交过程。在表单提交过程中，该名字就当作HTML的NAME属性。

请参阅：getSubmitName

DhRadioButton.setSubmitValue

设置该单选按钮控件的提交值。

语法

public void setSubmitValue ( String strValue )

参数

strValue

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

说明

同一个组中的DhRadioButton对象是互斥的；即一次只能选择一个DhRadioButton按钮。

而且，组名用于HTTP表单提交过程。在表单提交过程中，该名字就当作HTML的VALUE属性。

请参阅：getSubmitName

DhRadioButton.setText

设置单选按钮的文本标签。

语法

public void setText ( String strText )

参数

strText

按钮的文本标签。

请参阅：getText

DhRadioButton.setTextAlign

设置当前的对齐方式。

语法

public void setTextAlign( int newAlignment )

参数

newAlignment

对齐格式，可以是右对齐( LeftRightAlignment.RIGHT)或左对齐(LeftRightAlignment.LEFT)。

异常

如果newAlignment不是有效的常量值，就产生WFCInvalidEnumException异常消息。

请参阅：getTextAlign

DhRawHTML类

使得任意原始HTML能够输到文档中。

Component
  |
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +-- DhRawHTML

package com.ms.wfc.html

public class DhRawHTML

extends DhElement

说明

要将任意的HTML文本加入到文档中，需要创建一个DhRawHTML对象，当你创建时添加HTML字符串，或者在创建以后使用setHTML方法。然后将DhRawHTML添加到文档或文档的容器中。

构造器

DhRawHTML. DhRawHTML

创建一个DhRawHTML对象。

语法

public DhRawHTML ()

public DhRawHTML( String html )

参数

html

初始的HTML字符串。

请参阅：setHTML

方法

DhRawHTML.getHTML

检取当前的HTML字符串。

语法

public String getHTML()

返回值

返回HTML字符串，如果没有的话就返回null。

请参阅：setHTML

DhRawHTML.setHTML

将HTML字符串输出到文档中。

语法

public void setHTML( String html )

参数

html

要输出的字符串。

请参阅：getHTML

DhResetButton类

实现了HTTP表单提交上的重置按钮控件。

Component
  |
  +-- DhStyleBase
     |
     +--DhElement
        |
        +--DhButtonBase
           |
           +--DhResetButton

package com.ms.wfc.html

public class.DhResetButton

extends DhButtonBase

说明

该按钮将表单上所有的控件都设置为初始化时的数值。给DhForm对象增加一个DhResetButton对象将使得DhForm成为HTML Form元件。有关Form元件的详细信息，包括重置和提交按钮，可以参考InternetClient SDK文档。该文档位于MSDN光盘上Internet/Intranet/ExtranetServices目录下的Platform SDK一节。也可以在MSDN在线SDK文档中找到（http://www.microsoft.com/msdn/sdk/inetsdk /help）。

请参阅：DhForm，DhSubmitButton

构造器：

DhResetButton. DhResetButton

创建一个DhResetButton对象。

语法

public DhResetButton ()

public DhResetButton ( String caption )

参数

caption

新设置按钮的标题。

说明

缺省构造器：创建的重置按钮标题为揜eset敗７椒―

DhResetButton.getText

检取按钮当前的文本标题。

语法

public String getText ()

返回值

返回按钮标题。

请参阅：setText

DhResetButton.setText

设置按钮标题。

语法

public void setText (String strCaption )

参数

strCaption

新标题字符串。

请参阅：getText

DhRow类

在DhTable类中实现一新行。

DhElement
  | 
  +--DhBaseContainer
     |
     +-- DhRow

package com.ms.wfc.html

public class DhRow

extends DhBaseContainer

构造器：

创建一个DhRow对象。

语法

public DhRow()

说明

该构造器创建一空行。

方法

DhRow.add

为该行的末尾追加一个单元。

语法

public void add ( DhCell cell )

参数

cell

要追加到该行的DhCell。

DhRow.addOnGotFocus

为gotFocus事件指定一个代理。

语法

public final void addOnGotFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnGotFocus

DhRow.addOnLostFocus

为lostFocus事件指定一个代理。

语法

public final void addOnLostFocus ( EventHandler h )

参数

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

说明

当元件失去输入焦点时就调用代理所指定的方法。DhRow.addOnResize为resize事件指定一个代理。

语法

public final void addOnResize ( EventHandler h )

参数

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

说明

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

请参阅：removeOnResize

DhRow.getCell

返回单元的顺序位置（序号）。

语法

public DhCell getCell ( int nCol )

参数

nClo单元所在列的次序位置。

返回值

返回单元的位置nCol。如果该位置没有单元，就返回null。

DhRow.getCells

返回本行中的单元矩阵。

语法

public DhCell[] getCells()

返回值

返回DhCell对象矩阵。如果该位置没有单元，就返回null。

DhRow.getColumnCount

返回本上列的数目。

语法

public int getColumnCount ()

返回值

返回列的数目。

DhRow.getRecordNumber

检取当前行所显示记录的序号。

语法

public int getRecordNumber ()

返回值

返回该行记录的绝对序号。如果该行没有绑定数据，就返回-1。

说明

只有单元绑定了数据之后该方法才是有效的。

DhRow.getRowNumber

如果当前是在一个表格中就返回行号。

语法

public int getRowNumber ()

返回值

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

DhRow.remove

从行中删除单元。

语法

public int remove ( DhCell cell )

参数

cell

要删除的DhCell。

返回值

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

DhRow.removeOnGotFocus

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

语法

public final void removeOnGotFocus ( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnGotFocus

DhRow. removeOnLostFocus

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

语法

public final void removeOnLostFocus ( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnLostFocus

DhRow. removeOnResize

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

语法

public final void removeOnResize ( EventHandler h )

参数

要删除的EventHandler代理。

说明

当该容器失去输入焦点时就触发resize事件。

请参阅：addOnResize

DhScrollBars类

定义滚动杆常量。

Enum
   |
   +-- DhScrollBars

package com.ms.wfc.html

public class DhScrollBars

extends Enum

说明

DhDocument, DhInlineFrame和DhWindows类中的getScroll和

setScroll方法使用这些常量。

字段

DhScrollBars.AUTO

指明浏览器在需要的时候将增加滚动杆。

语法

public static final int AUTO;

DhScrollBars.NO

指明禁止滚动。

语法

public static final int NO;

DhScrollBars.YES

指明允许滚动操作。

语法

public static final int YES;

方法

DhScrollBars.valid

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

语法

public static boolean valid ( int n)

参数

要检查的值。

返回值

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

说明

你应该在自己派生的类中覆盖该方法。

DhSelectBox类

表示DhComboBox和DhListBox控件的基类。

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

package com.ms.wfc.html

public abstract class DhSelectBox

extends DhBaseContainer

说明

基类不能实化。

方法

DhSelectBox.addItem给列表末尾追加一项。

语法

public void addItem ( String strText )

public void addItem ( String strText, boolean fSelected )

public void addItem ( String strText , boolean fSelected, String

strValue )

参数

strText

新项的文本。

fSelected设置该项的选择状态。如果该项处于选择状态，就设置为true；

否则就设置为false。

strValue

设置该项的VALUE属性。对于HTTP表单提交字符串来说是很

有用的。

说明

将项追加到列表的末尾。

请参阅：removeItem

DhSelectBox.addOnGotFocus

为gotFocus事件指定一个代理。

语法

public final void addOnGotFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnGotFocus

DhSelectBox.addOnLostFocus

为lostFocus事件指定一个代理。

语法

public final void addOnLostFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnLostFocus

DhSelectBox.addOnResize

为resize事件指定一个代理。

语法

public final void addOnResize ( EventHandler h )

参数

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

说明

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

请参阅：removeOnReszie

DhSelectBox.addOnSelectedIndexChanged

给selectIndexChanged事件增加代理。

语法

public final void addOnSelectedIndexChanged ( EventHandler h )

参数

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

说明

当改变当前选择的元件时就调用代理所指定的方法。

请参阅：removeOnSelectedIndexChanged

DhSelectBox.findString寻找列表中以指定字符串开头的第一项。

语法

public int findString ( String s )

public final int findString ( String s, int startIndex )

参数

要匹配的字符串。任何以指定字符开头的字符串都认为是匹配

的。

startIndex

在开始查找之前项的零基索引（即从该项开始查找）。如果从列

表开头查找，就设置为-1。

返回值

返回所找到项的零基索引。如果没有找到，就返回-1。

DhSelectBox.findStringExact

在列表中查找与指定字符串严格匹配的项。

语法

public int findStringExact ( String s )

public final int findStringExact ( String s, int startIndex )

参数

要严格匹配的字符串。

startIndex

开始查找位置的零基索引。如果从头开始，就设置为-1。

返回值

返回所找到项的零基索引；如果没有找到，就返回-1。

DhSelectBox.focus

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

语法

public void focus ()

DhSelectBox.getEnabled

检取元件的使能状态。

语法

public boolean getEnabled ()

返回值

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

请参阅：setEnabled

DhSelectBox.getItemCount

检取目前列表中项的数目。

语法

public int getItemCount()

返回值

返回项的数量。

DhSelectBox.getItemsSubmitValue

检取列表中与项提交值相对应的文本项矩阵。

语法

public String[] getItemsSubmitValue ()

返回值

返回项提交值的矩阵；如果没有项，就返回空矩阵。

DhSelectBox.getItemsText

检取列表中文本项矩阵。

语法

public String[] getItemsText()

返回值

返回列表项的矩阵，如果列表中没有项，就返回null。

DhSelectBox.getItemSubmitValue

检取索引处项的提交值。

语法

public String getItemSubmitValue ( int index )

参数

index

要查找提交值的项的零基索引；如果是当前选择的项，就设置为

-1。

返回值

返回索引项的提交值。

说明

在HTTP表单提交过程中使用提交值。

请参阅：setItemsSubmitValue

DhSelectBox.getItemText

检取指定索引项的文本。

语法

public String getItemText ( int index )

参数

index要查找文本值的项的零基索引；如果是当前选择的项，就设置为

-1。

返回值

返回索引指定项的文本，如果指定为-1或者没有选择项就返回空字

符串(摂)。

请参阅：setItemText

DhSelectBox.getSelected

检取项当前的选择状态。

语法

public boolean getSelected ( int index )

参数

index

要查询项的零基索引。

返回值

如果该项是处于选择状态，就返回true；否则就返回false。如果索

引值与列表中的项不匹配，也返回false。

请参阅：setSelected

DhSelectBox.getSelectedIndex

检取当前选择项的索引。

语法

public int getSelectedIndex ()

返回值

返回第一个选择项的零基索引。

说明

如果在DhListBox中选择了多项，该方法就返回选择中的第一项。

DhSelectBox.getSelectedIndices检取包含当前所有选择项零基索引的矩阵。

语法

public int[] getSelectedIndices()

返回值

返回一个整数矩阵，包含了当前所有选择项的零基索引值。在单选列表框中，返回包含一个元素的矩阵。如果列表中没有选中的项，就返回空矩阵。DhSelectBox.getSelectedSubmitValue检取选中项的值。

语法

public String getSelectedSubmitValue ()

返回值

返回第一个选择项的提交值，如果没有选择项，就返回空字符串。如果选择了多项，就返回选择项中第一项的提交值。

DhSelectBox.getSelectedText检取当前选择项的文本。

语法

public String getSelectedText()

返回值

返回当前选择项文本，或者如果没有选择项，就返回空字符串。如果选择了多项，就返回选择项中第一项的文本。DhSelectBox.getSubmitName检取选择框的名字。

语法

public String getSubmitName ()

返回值

返回选择框的名字。

说明

该NAME属性用于HTTP提交过程。

请参阅：setSubmitName

DhSelectBox.insertItem在列表指定索引处插入一项。

语法

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)

参数

index在该索引处添加新项。如果比0小或比当前项的数量大，则该项就追加到列表的末尾。strText新项的文本。fSelected新项的选择状态。strValue该项的VALUE属性（用于HTTP表单提交）。

DhSelectBox.removeAll删除控件中的所有项。

语法

public void removeAll ()DhSelectBox.removeItem从列表中删除指定索引项。

语法

public void removeItem ( int index )

参数

index要删除项的零基索引。

请参阅：addItemDhSelectBox. removeOnGotFocus删除为gotFocus事件指定的代理。

语法

public final void removeOnGotFocus ( EventHandler h )

参数

h指明事件处理器方法的EventHandler代理。

说明

当元件收到输入焦点时就触发onGotFocus事件。DhSelectBox. removeOnLostFocus删除为lostFocus事件指定的代理。

语法

public final void removeOnLostFocus ( EventHandler h )

参数

h要删除的EventHandler代理。

说明

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

请参阅：addOnLostFocus

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

语法

public final void removeOnResize ( EventHandler h )

参数

h要删除的EventHandler代理。

说明

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

请参阅：addOnReszieDhSelectBox. removeOnSelectedIndexChanged删除为selectedIndexChanged事件指定的代理。

语法

public final void addOnSelectedIndexChanged ( EventHandler h )

参数

h要删除的EventHandler代理。

说明

当改变当前选择的元件时就触发该事件。

请参阅：addOnSelectedIndexChangedDhSelectBox.setEnabled设置元件的使能状态。

语法

public void setEnabled ( boolean f)

参数

f如果要使能该控件，就设置为true；否则，就设置为false。

请参阅：getEnabledDhSelectBox.setItem更新某项的属性。

语法

public void setItem ( int index , String strText, boolean fSel, StringstrValue )

参数

index要更新项的索引。strText该项新的文本。fSel该项新的选择状态。strValue该项新的VALUE属性（用于HTTP表单提交）。

说明

如果index与当前列表中的项不匹配，就在列表中添加一新项。如果将

参数

指定为null，将不改变项的值。使用空字符串来清除字符串值。DhSelectedBox.setItems设置列表中的项。

语法

public final void setItems ( String[] strings)public final void setItems ( String[] strings, boolean[] selected )public final void setItems ( String[] strings, boolean[] selected,

String[] submitValues )

参数

strings要设置给列表的一个String矩阵。selected一个boolean矩阵，指明相应的项是否处于选择状态。submitValues一个String矩阵，相应项的提交值。

说明

列表中的所有项都将被替换。DhSelectBox.setItemSubmitValue设置项的属性值。

语法

public void setItemsSubmitValue ( int index, String stringValue )

参数

index指定项的索引。stringValue

新值的字符串。异常如果索引指定的项不在列表中就产生WFCInvalidArgumentException异常消息。

请参阅：getItemSubmitValueDhSelectBox.setItemsText设置列表中指定项的文本属性。

语法

public void setItemsText( int index , String strText )

参数

index指定项的零基索引。strText该项新的文本。异常如果索引指定的项不在列表范围内，就产生WFCInvalidArgumentException异常消息。

请参阅：getItemText

DhSelectBox.setSelected设置列表中某项的选择状态。

语法

public void setSelected ( int index , boolean value )

参数

index要更新项的零基索引。value如果要选择该项，就设置为true；否则就设置为false。

说明

如果列表允许选择多项，则该项的设置将不会影响其他项的选择状态。否则，其他项的选择状态将被清除。

请参阅：getSelectedDhSelectBox.setSelectedIndex设置当前选择项的索引。

语法

public void setSelectedIndex ( int index )

参数

index要选择项的零基索引。DhSelectBox.setSubmitName设置选择框的名字。

语法

public void setSubmitName ( String strName )

参数

strName选择框的名字。异常如果strName不是有效的名字（包含空格），就产生WFCInvalidArgumentException异常消息。

说明

该NAME属性用于HTTP提交过程，代表HTML NAME属性。

请参阅：getSubmitName

DhStyle类

表示了一个属性集合，该集合可任意应用于任何元件。

Component
  |
  +-- DhStyleBase
     |
     +-- DhStyle

package com.ms.wfc.html

public class DhStyle

extends DhStyleBase

说明

该类的基本应用情形是创建该类的一个实例，调用DhElement.setStyle方法来使用这个实例。

构造器：

DhStyle. DhStyle创建一个DhStyle对象。

语法

public DhStyle()public DhStyle ( String name )

参数

name用于生成底层HTML的风格的名字。

说明

使用带

参数

的

构造器：

的给你的风格命名并控制该对象所生成的底层HTML代码。注意：这在缺省

构造器：

中都完全替你处理完了。方法DhStyle.getName检取HTML对象所看到的该风格对象底层的名字。

语法

public String getName ()

返回值

返回风格规则的字符串名字。

说明

这个一种高级技巧，并不是普通的操作。

请参阅：setNameDhStyle.setName设置HTML对象所看到的该风格对象底层的名字。

语法

public void setName ( String name )

参数

name风格规则的字符串名字。

说明

这个一种高级技巧，并不是普通的操作。

请参阅：getName

DhStyleBase类

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

Component
   |
   +-- DhStyleBase

package com.ms.wfc.html

public abstract class DhStyle

Baseextends Component

说明

扩展DhStyleBase的类都有某些印刷和可视化属性，如颜色和字体

等。该类是抽象类，不能被实化。

请参阅：DhStyle, DhElement

字段

DhStyleBase.UNINITIALIZED

指明还没有设置该风格。

语法

public final int UNINITIALIZED;

方法

DhStyleBase.dispose

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

语法

public void dispose()

说明

在运行时不应该调用该方法。当元件进行垃圾回收时，所有被该元

件使用的资源都将被释放。继承类应调用super.dispose。

DhStyleBase.getBackColor

检取背景颜色属性。

语法

final public Color getBackColor()

返回值

返回一个Color对象，即当前背景颜色。

请参阅：setBackColor

DhStyleBase.getBorderInfo

检取有关当前边框状态信息的DhBorderInfo类。

语法

public DhBorderInfo getBorderInfo ()

返回值

返回DhBorderInfo边框信息类。

请参阅：setBorderInfo

DhStyleBase.getBounds

检取元件的位置和大小。

语法

final public Rectangle getBounds()

返回值

以Rectangle对象返回元件的位置。

请参阅：getWidthUnit, getHeightUnit, getTopUnit, getLeftUnit,setBounds

DhStyleBase.getClipRect

检取当前剪裁矩形。

语法

public Rectangle getClipRect()

返回值

返回一个Rectangle对象，包含了当前剪裁矩形的大小。如果该未经

定义或使用setClip的String参数定义为揳uto敚騌ectangle对象的所

有字段都将是-1。

DhStyleBase.getCSSStyleInt

检取级联风格表单的风格号。

语法

public int getCSSStyleInt ( String strStyleKey )

参数

strStyleKey

要检取的风格名字。

返回值

返回级联风格表单的风格号。

说明

直接调用该方法并不是该包的正常操作。你应该使用特定的风格方

法。

请参阅：setCSSStyleInt

DhStyleBase.getCSSStyleString

检取级联风格表单的风格。

语法

public String getCSSStyleString ( String strStyleKey )

参数

strStyleKey要检取的风格名字。

返回值

风格字符串。

说明

直接调用该方法并不是该包的正常操作。你应该使用特定的风格方

法。

DhStyleBase.getCSSStyleText

检取级联风格表单底层的文本字符串。

语法

public String getCSSStyleText ()

返回值

返回该对象底层的级联风格表单文本字符串。

说明

这是该库的高级特征，并不是普通的操作。

请参阅：setCSSStyleText

DhStyleBase.getCursor

检取该元件的鼠标光标风格。

语法

public int getCursor()

返回值

返回在DhCursor类中定义的鼠标光标风格。

请参阅：setCursor

DhStyleBase.getCursorString

检取该元件当前的鼠标光标风格。

语法

public String getCursorString()

返回值

返回当前鼠标光标类型。

说明

有关详细信息，请参阅Internet Client SDK中CSS属性参考一节。

可在MSDN光盘中Internet/Intranet/Extranet Services目录下DHTML

References中的Plaform SDK一节找到。也可以在MSDN在线文档中找

到( http://www.microsoft.com/msdn/ sdk/inetsdk/help)。

DhStyleBase.getFont

检取当前的字体。

语法

public Font getFont()

返回值

返回一个Font对象，即当前的字体。

请参阅：setFont

DhStyleBase.getForeColor

检取文本前台颜色属性。

语法

final public Color getForeColor()

返回值

返回当前的前台Color对象。

请参阅：setForeColor

DhStyleBase.getHeightUnit

检取高度单位。

语法

final public int getHeightUnit()

返回值

返回代表度量单位一个DhUnits常量。

请参阅：getBounds, setHeightUnitDhStyleBase.getLeftUnit检取左边位置单位。

语法

final public int getLeftUnit()

返回值

返回代表度量单位的一个DhUnits常量。

请参阅：getBounds,setLeftUnit

DhStyleBase.getLocation

检取元件的位置。

语法

public Point getLocation ()

返回值

返回元件的位置。

请参阅：getTopUnit, getLeftUnit, setLocation

DhStyleBase.getMarginWidthInfo

检取一个DhMarginWidthInfo类，描述该元件当前的边框空白设置。

语法

public DhMarginWidthInfo getMarginWidthInfo()

返回值

返回一个DhMarginWidthInfo类。

请参阅：setMarginWidthInfo

DhStyleBase.getPaddingWidthInfo

检取一个DhPaddingWidthInfo类，描述该元件当前填充宽度的设

置。

语法

public DhPaddingWidthInfo getPaddingWidthInfo ()

返回值

返回一个DhPaddingWidthInfo类。

请参阅：setPaddingWidthInfo

DhStyleBase.getPosAbsolute

确定级联风格的表单中位置风格是否设置为绝对风格。

语法

public boolean getPosAbsolute()

返回值

如果位置风格设置为绝对的，就返回true；否则，就返回false。

说明

绝对位置将元件定位到其第一个父亲原点的、由左边(left)和上边(top)

属性的设置决定的偏移量处。

请参阅：getPosRelative, setPosAbsolute, setPosRelative

DhStyleBase.getPosRelative

确定级联风格表单中的位置风格是否设置为相对的。

语法

public boolean getPosRelative ()

返回值

如果位置风格设置为相对的，就返回true；否则就返回false。

说明

相对位置将元件定位到HTML中标准位置的、由左边(left)和上边(top)

属性的设置决定的偏移量处。

请参阅：getPosAbsolute, setPosAbsolute, setPosRelative

DhStyleBase.getSize

检取元件的大小。

语法

public Point getSize()

返回值

返回元件的大小，以Point对象表示。

请参阅：getWidthUnit, getHeightUnit, setSize

DhStyleBase.getTextAlign

检取当前文本的对齐格式。

语法

public int getTextAlign()

返回值

返回当前对齐格式，是下面DhAlignment值之一：

·LEFT（缺省值）

·RIGHT

·CENTER?JUSTIFY

请参阅：setTextAlign

DhStyleBase.getTextVerticalAlign

检取当前文本对齐格式。

语法

public int getTextVerticalAlign()

返回值

返回当前的对齐格式，是下面的DhAlignment值之一：

·BASELINE（缺省值）

·SUBSCRIPT

·SUPERSCRIPT

请参阅：setTextVerticalAlign

DhStyleBase.getTopUnit

检取上边位置单位。

语法

final public int getTopUnit ()

返回值

返回代表度量单位的一个DhUnits常量。

请参阅：getBounds, setTopUnit

DhStyleBase.getVisible

检取元件可视状态。

语法

public boolean getVisible()

返回值

如果元件可见，就返回true；否则，就返回false。

请参阅：setVisible

DhStyleBase.getWidthUnit

检取宽度单位。

语法

final public int getWidthUnit()

返回值

返回代表度量单位的一个DhUnits常量。

请参阅：getBounds, setWidthUnit

DhStyleBase.getZIndex

检取该元件与其容器相对应的z-索引（分层）次序。

语法

public int getZIndex ()

返回值

返回由setZIndex设置的z-索引值。

请参阅：setZIndex

DhStyleBase.hasStyleText

确定该风格是否有一个底层级联风格表单文本字符串。

语法

protected boolean hasStyleText()

返回值

如果存在风格文本，就返回true；否则，就返回false。

说明

直接调用该方法并不是该包使用过程中的标准操作。相反，你应该

使用更特殊的风格方法。

DhStyleBase.invoke

在拥有该元件底层对等元件的线程中执行指定的代理。

语法

public final Object invoke ( Delegate method )

public final Object invoke ( Delegate method , Object args[] )

参数

method

在元件的线程结构中包含要调用方法的代理。该代理可以是一个

EventHandler对象，其中sender参数将包含该元件，event参数将包

含Event.EMPTY。代理也可以是MethodInvoker对象或任何其他带

参数列表的代理。调用EventHandler或MethodInvoker代理比调用其

他类型的代理要快得多。当使用带args参数的invoke方法时，该代

理必须指向一个包含与args中相同数目和参数类型的方法。

args

一个对象矩阵，将参数传递给指定的方法。如果不需要参数就设

置为null。

返回值

回所激活代理的返回值；如果没有返回值，就返回null。

异常

如果元件的线程被阻塞就产生WFCSystemException异常消息。

说明

在调用过程中产生的异常信息都传递给调用者。

DhStyleBase.resetBackColor

重新将背景颜色设置为缺省的、继承时的值。

语法

final public void resetBackColor ()

请参阅：getBackColor

DhStyleBase.resetBorder

清除当前边框设置。

语法

public void resetBorder()

DhStyleBase.resetClip

将剪裁区域重新设置为缺省的继承值。

语法

public void resetClip()

DhStyleBase.resetCursor

将当前的鼠标光标重新设置为缺省光标。

语法

public void resetCursor()

请参阅：getCursorDhStyleBase.resetFont清除元件中任何的字体设置，允许这些设置采用继承值。

语法

public void resetFont()

请参阅：getFontDhStyleBase.resetForeColor将前景颜色重新设置为缺省的继承值。

语法

final public void resetForeColor ()

请参阅：getForeColorDhStyleBase.resetLocation清除位置属性值，允许通过布局引擎（通常是Microsoft InternetExplorer）来放置元件。

语法

public void resetLocation()

请参阅：getLocation

DhStyleBase.resetMargin

清除当前的边缘空白设置。

语法

public void resetMargin()

DhStyleBase.resetPadding

清除当前填充风格的设置值。

语法

public void resetPadding()

DhStyleBase.resetSize

清除任何的大小属性，允许布局引擎（通常是Microsoft Internet

Explorer）来设置元件的大小。

语法

public void resetSize()

请参阅：getSzie

DhStyleBase.resetTextAlign

清除任何现有的文本对齐属性。

语法

public void resetTextAlign()

请参阅：getTextAlign

DhStyleBase.resetTextVerticalAlign

清除任何现有的垂直文本对齐属性。

语法

public void resetTextVerticalAlign()

请参阅：getTextVerticalAlign

DhStyleBase.resetZIndex

创建任何z-索引设置。

语法

public void resetZIndex()

请参阅：getZIndex

DhStyleBase.setBackColor

设置元件的背景颜色。

语法

final public void setBackColor ( Color color )

参数

color

Color对象，该元件新的背景颜色。

说明

如果从没有设置该值，就使用容器的背景颜色。

请参阅：getBackColor

DhStyleBase.setBorder

设置该项所有边的边框值。

语法

public void setBorder ( int borderStyle, int borderWidth, int

borderWidthUnit, Color borderColor )

参数

borderStyle

边框风格。必须是DhBorderStyle常量之一。

borderWidth

整数值，边框宽度。

borderWidthUnit

边框宽度单位。必须是DhUnits常量之一。

borderColor

边框颜色。

请参阅：DhBorderStyle, DhUnits, Color

DhStyleBase.setBorderColor

将边框颜色设置为指定的Color值。

语法

public void setBorderColor ( int borderMask, Color color )

public void setBorderColor ( Color color )

参数

borderMask

要设置的边框，可以是DhBorders常量组合。

colorColor

对象，新边框颜色。

DhStyleBase.setBorderInfo

更新该元件的边框风格。

语法

public void setBorderInfo ( DhBorderInfo biNew )

参数

biNew

包含新边框状态的DhBorderInfo类。在结构中使用字符串值代

替整数值。

请参阅：getBorderInfo

DhStyleBase.setBorderStyle

将风格设置为指定的常量值。

语法

public void setBorderStyle ( int borderMask , int borderStyle )

public void setBorderStyle ( int borderStyle )

参数

borderMask

要设置的边框，可以是DhBorders常量组合。

borderStyle

要设置的边框风格，可以是DhBorderStyle常量的组合。

DhStyleBase.setBorderWidth

将边框设置为指定的值和单位。

语法

public void setBorderWidth ( int borderMask , int nWidth, int

nUnitKey )

public void setBorderWidth ( int nWidth, int nUnitKey )

参数

borderMask

要设置的边框，可以是DhBorders常量的组合。

nWidth

边框的数字宽度。

nUnitKey

指定给宽度的单位键值。有关具体数值，请参阅DhUnits。

DhStyleBase.setBounds

设置元件的位置和大小。

语法

final public void setBounds ( int x, int y, int width , int height )

final public void setBounds ( Rectangle rect )

参数

位置左坐标。

位置上坐标。

width

元件新的宽度。

height

元件新的高度。

rect

元件的位置和尺寸。

请参阅：setWidthUnit, setHeightUnit, setTopUnit ,setLeftUnit, setSize,

setLocation, getBounds

DhStyleBase.setClip

设置剪裁矩形。

语法

public void setClip ( Rectangle r )

public void setClip ( String strClip )

参数

剪裁Rectangle对象。

strClip剪裁字符串。可以是搑ect(top,right,bottom,left)數母袷剑渲校瑃op, left, bottom或right可以是揳uto敾蛞桓龀ざ戎怠Ｋ得鞑换嬷萍舨镁匦沃獾牟糠帧

DhStyleBase.setCSSStyle

通过级联风格表单的字符串值来设置风格。

语法

public void setCSSStyle( String strStyleKey, String value )

参数

strStyleKey

要设置的风格名字。

value

字符串值。

说明

直接调用该方法并不是使用该包的标准操作。你应该使用更特殊的

风格方法（如DhStyleBase.setFont）。

DhStyleBase.setCSSStyleInt

通过级联风格表单的整数值来设置风格。

语法

public void setCSSStyleInt ( String strStyleKey, int value )

参数

strStyleKey

要设置的风格名字。

value

字符串值。

说明

直接调用该方法并不是使用该包的标准操作。你应该使用更特殊的

风格方法（如DhStyleBase.setFont）。

请参阅：getCSSStyleInt

DhStyleBase.setCSSStyleText

修改页面上元件的只读风格设置。

语法

protected void setCSSStyleText ( String strStyleName, String strValue,

boolean fCaseSensitive )

参数

strStyleName

要修改风格的字符串名字。这是实际的级联风格表单的风格，而

不是风格元件属性。

strValue

新的属性值。

fCaseSensitive

要使用大小写敏感的搜索方式就设置为true；否则，就设置为

false。

说明

有关只读风格的详细信息，请参阅在线文档中的Internet Client SDK

文档。

请参阅：getCSSStyleText

DhStyleBase.setCursor

设置该元件的鼠标光标风格。

语法

public void setCursor( int nCursor )

public void setCursor ( String strCursor )

参数

nCursorDhCursor

鼠标光标类型。

strCursor

需要的鼠标光标类型。

请参阅：getCursor

DhStyleBase.setFont

设置该元件的字体。

语法

public void setFont( Font font)

参数

font

要应用的字体，；一个Font对象。

请参阅：getFont

DhStyleBase.setForeColor

设置文本颜色（其他前台对象）。

语法

final public void setForeColor( Color color)

参数

color一个Color对象，新的前台颜色。

请参阅：getForeColor

DhStyleBase.setHeightUnit

设置元件的高度。

语法

final void setHeightUnit( int h, int unit )

参数

高度。

unit

表示度量单位的DhUnits常量。

请参阅：setBounds, getHeightUnit

DhStyleBase.setLeftUnit

设置元件的左边位置。

语法

final public void setLeftUnit( int v , int unit )

参数

左边位置值。

unit

表示度量单位的DhUnits常量。

请参阅：setBounds,getLeftUnit

DhStyleBase.setLocation

设置元件的位置。

语法

public void setLocation (int x, int y )

public void setLocation ( Point pt )

参数

位置的左坐标。

位置的上坐标。

元件新的位置。

请参阅：setTopUnit, setLeftUnit, getLocation

DhStyleBase.setMarginWidth

将所有的边框空白宽度都设置为只读的值。

语法

public void setMarginWidth( int nWidth, int nUnit )

public void setMarginWidth( int nMarginMask, int nWidth, int nUnit )

参数

nWidth

边缘空白的宽度。

nUnit

边缘空白宽度的单位。有关边缘空白宽度值，请参阅DhUnits。

nMarginMask

要应用的边缘空白组合。有关边缘空白的值，请参阅

DhMargins。

DhStyleBase.setMarginWidthInfo

设置边缘空白宽度。

语法

public void setMarginWidthInfo( DhMarginWidthInfo mwi )

参数

mwi

一个DhMarginWidthInfo类，边缘空白宽度的设置。

请参阅：getMarginWidthInfo

DhStyleBase.setPaddingWidth

将所有的填充宽度都设置为指定的值。

语法

public void setPaddingWidth( int nWidth, int nUnit )

public void setPaddingWidth( int nPaddingMask, int nWidth, int

nUnits )

参数

nWidth

填充的宽度。

nUnitDhUnits

填充宽度单位。

nPaddingMask

要应用的填充方式组合。详细信息，请参阅DhPaddings。

DhStyleBase.setPaddingWidthInfo

根据DhPaddingWidthInfo类中的信息设置填充宽度。

语法

public void setPaddingWidthInfo ( DhPaddingWidthInfo mwi )

参数

mwi

新的填充宽度。正确的信息，请参阅DhPaddingWidthInfo。

请参阅：getPaddingWidthInfo

DhStyleBase.setPosAbsolute

将级联风格的表单中位置风格设置为绝对风格。

语法

public void setPosAbsolute( )

说明

绝对位置将元件定位到其第一个父亲原点的、由级联风格表单左边

(left)和上边(top)属性的设置决定的偏移量处。

请参阅：getPosRelative, getPosAbsolute, setPosRelative

DhStyleBase.setPosRelative

将级联风格表单中的位置风格设置为相对的。

语法

public void setPosRelative ()

说明

相对位置将元件定位到在HTML布局中通常的位置的某一偏移量处，该偏移量

由级联风格表单的左和上属性设置值决定。

请参阅：getPosAbsolute, setPosAbsolute, getPosRelative

DhStyleBase.setSize

设置元件的大小。

语法

public void setSize( int w, int h)

public void setSize ( Ponit pt )

参数

元件新的宽度。

元件新的高度。

元件新的宽度和高度。

异常

如果元件的宽度或高度小于0就产生WFCInvalidArgumentException

异常消息。

请参阅：setWidthUnit, setHeightUnit, getSize

DhStyleBase.setTextAlign

设置文本的对齐格式。

语法

public void setTextAlign( int nAlignement)

参数

nAlignment

新的对齐格式，是下面DhAlignment值之一：

?LEFT（缺省值）

?RIGHT

?CENTER?JUSTIFY

异常

如果nAlignment不是有效值之一，就产生

WFCInvalidArgumentException异常消息。

请参阅：getTextAlign

DhStyleBase.setTextVerticalAlign

设置文本垂直对齐格式。

语法

public void setTextVerticalAlign( int nVerticalAlign)

参数

nVerticalAlign

新的对齐格式，可以是下面的DhAlignment值之一：

?BASELINE（缺省值）

?SUBSCRIPT

?SUPERSCRIPT

异常

如果nVerticalAlign不是上述有效值之一，就产生

WFCInvalidArgumentException异常消息。

请参阅：getTextVerticalAlign

DhStyleBase.setTopUnit

设置上边位置单位。

语法

final public void setTopUnit ( int t, int unit )

参数

上边位置值。

Unit

一个DhUnits常量，表示度量单位。

请参阅：setBounds, getTopUnit

DhStyleBase.setVisible

设置元件为可视状态。

语法

public void setVisible( boolean visible )

参数

visible

如果允许元件可见，就设置为true；否则，就设置为false。

请参阅：getVisible

DhStyleBase.setWidthUnit

设置元件宽度。

语法

final public setWidthUnit( int w, int unit )

参数

宽度值。

Unit

代表度量单位的一个DhUnits常量。

请参阅：getBounds, getWidthUnit

DhStyleBase.setZIndex

设置该元件与其容器中其他元件相对应的z-索引（分层）次序。

语法

public void setZIndex ( int i)

参数

元件的z-索引值。

说明

在任何容器中，具有最高z-索引值的元件总是显示在所有其他元件之上。z-索引值小的元件可能就显示在底层。

请参阅：getZIndex

DhStyleBase.shouldPersistBackColor

确定背景颜色是否是永久性的。

语法

public boolean shouldPersistBackColor()

返回值

如果背景颜色是永久性的，就返回true；否则就返回false。

DhStyleBase.shouldPersistBorder

确定边框设置是否是永久性的。

语法

public boolean shouldPersistBorder()

返回值

如果边框设置是永久性的，就返回true；否则就返回false。

DhStyleBase.shouldPersistClip

确定剪裁区域是否是永久性的。

语法

public boolean shouldPersistClip()

返回值

如果剪裁区域设置为永久性的，就返回true；否则，就返回false。

DhStyleBase.shouldPersistFont

确定字体设置是否是永久性的。

语法

public boolean shouldPersistFont()

返回值

如果字体设置是永久性的，就返回true；否则，就返回false。

DhStyleBase.shouldPersistForeColor

确定前景颜色的设置是否是永久性的。

语法

public boolean shouldPersistForeColor()

返回值

如果前景颜色的设置是永久性的，就返回true；否则，就返回false。

DhStyleBase.shouldPersistMargin

确定边框空白的设置是否是永久性的。

语法

public boolean shouldPersistMargin()

返回值

如果边框空白的设置是永久性的，就返回true；否则，就返回false。

DhStyleBase.shouldPersistPadding

确定填充设置是否是永久性的。

语法

public boolean shouldPersistPadding()

返回值

如果填充设置是永久性的，就返回true；否则，就返回false。

DhSubmitButton类

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

Component
  |
  +-- DhStyleBase
     |
     +-- DhElement
        |
        +--DhButtonBase
           |
           +-- DhSubmitButton

package com.ms.wfc.html

public class DhSubmitButton

extends DhButtonBase

说明

提交按钮将激活表单ACTION属性中的URL地址。给DhForm对象增加一个DhSubmitButton将使得DhForm成为一个HTML表单元件。

当表单提交给服务器时，表单上每个控件的名字和值都连成一个字符串并提交给服务器。有关表单元件的详细信息，包括重置和提交按钮，

请参阅Internet Client SDK文档。这可以在MSDN光盘的Internet/Intranet/Extranet Services目录下的Platform SDK一节找到。也可以在MSDN在线SDK文档找到（http://www.microsoft.com/msdn/sdk/inetsdk/help）。

请参阅：DhForm,

DhResetButton

构造器

DhSubmitButton. DhSubmitButton

创建一个DhSubmitButton对象。

语法

public DhSubmitButton()

public DhSubmitButton( String strCaption )

参数

strCaption

新按钮的初始标题。

说明

缺省构造器创建的DhSubmitButton按钮上的标题是“Submit”。

方法

DhSubmitButton.getText

检取按钮当前的文本标题。

语法

public String getText ()

返回值

返回按钮标题。

请参阅：setText

DhSubmitButton.setText

设置按钮标题。

语法

public void setText ( String strCaption )

参数

strCaption

新的标题字符串。

请参阅：getText

DhTable类

创建一个可以通过行和列操作的表格元件。

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

package com.ms.wfc.htmlfinal

public class DhTable

extends DhBaseContainer

构造器

DhTable. DhTable

创建一个DhTable对象。

语法

public DhTable()

public DhTable( IDataStream dataSource )

public DhTable ( IDataStream dataSource, String dataMember,DataBinding[] dataBindings, DhRow repeaterRow )

参数

dataSource

显示在表格中的com.ms.wfc.data.IDataSource对象。

DataMember

数据成员。

DataBindings

描述repeaterRow中数据绑定的任何com.ms.wfc.data.ui.DataBinding对象矩阵。

RepeaterRow

以所需要的元件和格式绑定到DataBinding对象的DhRow对

象。

说明

缺省构造器创建了一个空的表格元件。

请参阅：setRepeaterRow, setDataBindings

方法

DhTable.add

在表格的顶部或底部或在另一行的前或后增加一新行，这得看DhInsertOptions的insertFlag参数值。

语法

final public void add( DhRow row, DhRow relativeTo , int insertFlag)

final public void add( DhRow row, int insertFlag)

final public void add( DhRow row)

参数

row

要增加的新行。

RelativeTo

当insertFlag参数使用BEFORE或AFTER常量时所参照的行。

insertFlag

一个有效且可应用的insert 常量。

InsertFlag

的有效值如下：

·END在表格的底部插入一行。此时，relativeTo参数必须是null。

·BEGINING在表格的顶部插入一行。此时，relativeTo参数必须是null。

·BEFORE在relativeTo指定行的前面插入一行。relativeTo参数不能是null。

·AFTER在relativeTo指定行的后面插入一行。relativeTo参数不能是null。

DhTable.addOnReadyStateChange

为readyStateChange事件指定一个代理。

语法

final public void addOnReadyStateChange( ReadyStateEventHandler h )

参数

当准备状态发生变化时就调用ReadyStateEventHandler代理。

说明

当由于表格中的内容发生变化而导致准备状态发生改变时就触发

readyState-Change事件。

请参阅：removeOnReadyStateChange

DhTable.getAutoHeader

检取当前表头生成模式。

语法

public boolean getAutoHeader ()

返回值

如果模板行没有表头而自动生成表头就返回true；否则就返回false。

说明

只有在没有指明repeater行的表中才自动生成表头。

请参阅：setAutoHeader

DhTable.getBodyCell

从表体中指定的位置上检取单元。

语法

final public DhCell getBodyCell ( int nRow, int nCol )

参数

nRow

零基行号。

NCol

零基列号。

返回值

返回指定位置的单元。

异常

如果在指定位置上没有单元，就产生DhElementNotFoundException异常消息。

DhTable.getBodyRow

检取指定的行。

语法

final public DhRow getBodyRow ( int nRow )

参数

nRow

要检取的行。

返回值

返回nRow处的行。

异常

如果表中没有该行，就产生DhElementNotFoundException异常消息。

说明

如果存在表头，那么0就是指行表头；否则，就是指表体中的第一行。

DhTable.getBodyRowCount

检取表中主体行的数量。

语法

public int getBodyRowCount ()

返回值

返回主体行的数量。

说明

主体行就是指不在表头或表脚注部分的行。

DhTable.getBodyRows

检取表体中所有行的矩阵（不包括表头和脚注）。

语法

final public DhRow[] getBodyRows()

返回值

返回一个DhRow元件矩阵。

DhTable.getBorder

检取表缺省的（非CSS）边框宽度。

语法

final public int getBorder ()

返回值

返回边框宽度。

请参阅：setBorder

DhTable.getCellPadding

检取表格CELLPADDING属性值。

语法

final public int getCellPadding()

返回值

返回整数填充值。

请参阅：setCellPadding

DhTable.getCellSpacing

检取表格的CELLSPACING属性值。

语法

final public int getCellSpacing()

返回值

返回整数填充值。

请参阅：setCellSpacing

DhTable.getDataBindings

检取与模板repeater行中元件关联的DataBinding对象。

语法

public DataBinding[] getDataBindings()

返回值

返回一个com.ms.wfc.data.ui.DataBinding对象矩阵。

说明

每个DataBinding对象必须引用当前记录集中的一列和repeater行中的一个对象。如果没有指明repeater行，就忽略这些绑定设置，表格就显示缺省的数据格式。

请参阅：setRepeaterRow, setDataBindings

DhTable.getDataMember

检取当前选择的数据成员。

语法

public String getDataMember()

返回值

返回当前选择的数据成员。如果没有设置，就返回摂或null。

请参阅：setDataMember

DhTable.getDataSource

检取当前设置的com.ms.wfc.data.IDataSource对象。

语法

public IDataSource getDataSource ()

返回值

返回当前设置的IDataSource对象，如果没有，就返回null。

请参阅：setDataSource

DhTable.getFooterRow

检取脚注行，如果存在的话。

语法

final public DhRow getFooterRow()

返回值

返回脚注DhRow，如果没有就返回null。

请参阅：setFooterRow

DhTable.getHeaderRow

检取表头行，如果存在的话。

语法

final public DhRow getHeaderRow ()

返回值

返回表头DhRow，如果没有，就返回null。

请参阅：setHeaderRow

DhTable.getPageSize

检取当前数据页面的大小（以行数表示），以便用于数据绑定操作。

语法

final public int getPageSize ()

返回值

返回页面中的行数。

请参阅：setPageSize

DhTable.getRangeEnd检取当前记录范围的末尾。

语法

public int getRangeEnd()

返回值

返回记录范围的末尾。缺省是-1，表示范围将一直显示到记录集的末尾。

请参阅：setRecordRange

DhTable.getRangeStart

检取当前记录范围的开头。

语法

public int getRangeStart ()

返回值

返回记录范围的开头。缺省是0 。

请参阅：setRecordRange

DhTable.getRepeaterRow

检取当前模板中的repeater行。

语法

public DhRow getRepeaterRow()

返回值

返回当前模板repeater行，如果没有就返回null。

请参阅：setRepeaterRow

DhTable.getTotalRowCount

检取表中行的数量，包括表头和脚注。

语法

pubilc int getTotalRowCount()

返回值

返回总的行数。

DhTable.refresh

如果表中数据是绑定到文档的，就刷新该数据。

语法

public void refresh()

DhTable.removeAll

删除表中所有行。

语法

public void removeAll()

说明

该方法将删除表中的表头、表体以及脚注行。

DhTable.removeBodyRows

删除表中非表头和脚注的所有行。

语法

final public void removeBodyRows()

说明

在HTML中，表体就是在THEAD和TFOOT标记之间的任何行。不删除表头和脚注。

DhTable.removeOnReadyStateChange

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

语法

final public void removeOnReadyStateChange( ReadyStateEventHandler h )

参数

要删除的ReadyStateEventHandler代理。

说明

当由于表格中的内容发生变化而导致准备状态发生改变时就触发readyState-Change事件。

请参阅：addOnReadyStateChange

DhTable.setAlign

设置表格的对齐格式。

语法

public void setAlign ( int alignType )

参数

alignType

在DhAlignment类中指定的一个常量（不能使用有关文本的对齐格式）。

异常

如果alignType是有关文本的对齐格式，就产生WFCInvalidArgumentException异常消息。DhAlignment类中有关文本的

对齐格式包括JUSTIFY, SUBSCRIPT和SUPERSCRIPT。

DhTable. SetAutoHeader

使能或禁止自动生成列表头。

语法

public void setAutoHeader ( boolean fAuto)

参数

fAuto

要使能自动生成表头，就设置为true；否则就设置为false。

异常

如果fAuto设置为true而表格中有一个repeater行，就产生WFCInvalidState-Exception异常消息。

说明

如果使能，在生成表格时将自动给表格增加一个包含列名字的表头。

注意：只有在没有指明repeater行的表中才自动生成表头。

请参阅：getAutoHeader

DhTable.setBorder

设置表缺省的（非CSS）边框宽度。

语法

final public void setBorder ( int width )

参数

width

边框宽度。

请参阅：getBorder

DhTable.setCellPadding

设置表格CELLPADDING属性值。

语法

final public void setCellPadding( int padding)

参数

padding

整数填充值。

请参阅：getCellPadding

DhTable.setCellSpacing

设置表格的CELLSPACING属性值。

语法

final public void setCellSpacing( int spacing)

参数

spacing

整数填充值。

请参阅：getCellSpacing

DhTable.setDataBindings

设置与模板repeater行中元件关联的DataBinding对象。

语法

public void setDataBindings(DataBinding[] dataBindings )

参数

dataBindings

一个com.ms.wfc.data.ui.DataBinding对象矩阵。

说明

每个DataBinding对象必须引用当前记录集中的一列和repeater行中

的一个对象。如果没有指明repeater行，就忽略这些绑定设置，表格就显示缺省的数据格式。

请参阅：setRepeaterRow, getDataBindings

DhTable.setDataMember

设置当前选择的数据成员。

语法

public void setDataMember( String dataMember )

参数

dataMember

当前选择的数据成员。如果要选择缺省的数据成员（摂）设置，就设置为null。

请参阅：getDataMember

DhTable.setDataSource

设置表格的数据源。

语法

public void setDataSource ( IDataSource dataSource)

参数

dataSource

与该表格关联的com.ms.wfc.data.IDataSource对象。

说明

如果表格有主体行，当生成表格数据时，这些行将被替换。

请参阅：getDataSource , com.ms.wfc.data.Recordset

DhTable.setFooterRow

将脚注行设置为DhRow元件指定的值。

语法

final public void setFooterRow( DhRow r )

参数

新的脚注行。设置为null将清除现有的脚注行。

请参阅：getFooterRow

DhTable.setHeaderRow

将表头上设置为DhRow所指定的值。

语法

final public void setHeaderRow ( DhRow r )

参数

新的表头。设置为null将清除现有的表头。

请参阅：getHeaderRow

DhTable.setPageSize

当进行数据绑定时，设置该表格所显示的页面大小。

语法

public void setPageSize ( int nPageSize)

参数

nPageSize

每页要显示的行数。

请参阅：getPageSize

DhTable.setRecordRange

设置将在表格中显示的记录范围。

语法

public void setRecordRange( int nStartRecord , int nEndRecord )

参数

nStartRecord

要显示的第一个记录。

NEndRecord

要显示的最后一个记录。

说明

这些数值反映决定的零基记录位置。

DhTable.setRepeaterRow

指明将被克隆给记录集中每条记录数据的模板行。

语法

public void setRepeaterRow( DhRow repeaterRow)

参数

repeaterRow

一个DhRow对象，带有所需要的格式和数据绑定元件。

说明

通过将元件连接到com.ms.wfc.data.ui.DataBinding对象上而在行中指明要与数据绑定的元件。如果在repeaterRow中的元件设置了事件，这些内容也将复制给所有的行。记住，事件复制是很费资源的，给repeater行增加太多的事件将使得表格生成速度明显变慢。更好的方法是只对相应的行或表格设置事件，而通过事件冒泡过程来处理它。

请参阅：getRepeaterRow

DhTable.showNextPage

显示表格中下一页数据。

语法

public void showNextPage()

请参阅：setPageSize

DhTable.showPreviousPage

显示表格中前一页数据。

语法

public void showPreviousPage()

请参阅：setPageSize

DhText类

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

DhStyleBase
  |
  +--DhElement
     |
     +-- DhText

package com.ms.wfc.html

public class DhText

extends DhElement

说明

以两种方式显示该元件：自由格式（缺省的）或保留空白键。后者意味着保留所有的空白键（包括回车键），元件看起来就象一个块，有前导行和结尾行（除非另行设置）。

构造器

DhText. DhText

创建一个DhText对象。

语法

public DhText()

public DhText( String text, int mode )

pubilc DhText ( String text )

参数

text

要显示的文本。

Mode

初始显示模式（是一个DhTextMode字段：FLOW，RESPECT_SPACE, NO_BREAK）。

说明

对于一步完成的构造器来说，text就是要在元件中显示的内容，mode就是初始化显示模式。

方法

DhText.addOnChange

为change事件指定一个代理。

语法

final public void addOnChange ( EventHandler h )

参数

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

说明

当用户修改文本或将输入焦点切换到不同的窗口时就触发该事件。

请参阅：removeOnChange

DhText.addOnGotFocus

为gotFocus事件指定一个代理。

语法

public final void addOnGotFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnGotFocus

DhText.addOnLostFocus

为lostFocus事件指定一个代理。

语法

public final void addOnLostFocus ( EventHandler h )

参数

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

说明

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

请参阅：removeOnLostFocus

DhText.addOnResize

为resize事件指定一个代理。

语法

public final void addOnResize ( EventHandler h )

参数

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

说明

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

请参阅：removeOnResize

DhText.addOnScroll为scroll

事件指定一个代理。

语法

public final void addOnScroll ( EventHandler h )

参数

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

说明

当元件滚动时就调用代理所指定的方法。

请参阅：removeOnScroll

DhText.addOnSelect

为select事件指定一个代理。

语法

public final void addOnSelect ( EventHandler h )

参数

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

说明

当用户修改文本框的选择区域时就触发该事件。

请参阅：removeOnSelect

DhText.getDisplayMode

检取当前的显示模式，是一个DhTextMode常量。

语法

public int getDisplayMode ()

返回值

返回当前的文本模式。

说明

缺省值是DhTextMode.FLOW。

请参阅：DhTextMode, setDisplayMode

DhText.getText

检取元件当前所显示的文本。

语法

public String getText()

返回值

返回元件所显示的文本。

DhText.removeOnChange

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

语法

final public void removeOnChange ( EventHandler h )

参数

要删除的EventHandler代理。

说明

当用户修改DhText控件的内容或将输入焦点切换到不同的窗口时就触发change事件。

请参阅：addOnChange

DhText. RemoveOnGotFocus

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

语法

public final void removeOnGotFocus ( EventHandler h )

参数

要删除的EventHandler代理。

说明

当元件使得输入焦点时就触发gotFocus事件。

请参阅：addOnGotFocus

DhText. RemoveOnLostFocus

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

语法

public final void removeOnLostFocus ( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnLostFocus

DhText. RemoveOnResize

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

语法

public final void removeOnResize ( EventHandler h )

参数

要删除的EventHandler代理。

说明

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

请参阅：addOnResize

DhText. RemoveOnScroll

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

语法

public final void removeOnScroll ( ScrollEventHandler h )

参数

要删除的ScrollEventHandler代理。

请参阅：addOnScroll

DhText. RemoveOnSelect

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

语法

public final void removeOnSelect ( EventHandler h )

参数

要删除的EventHandler代理。

说明

当用户修改文本框的选择区域时就触发select事件。

请参阅：addOnSelect

DhText.setDisplayMode

设置当前的显示模式，是一个DhTextMode常量。

语法

public void setDisplayMode ( int mode)

参数

mode

需要的文本模式（一个DhTextMode常量：FLOW,

RESPECT_SPACE或 NO_BREAK）。

说明

如果没有调用该方法，缺省值是DhTextMode.FLOW。

请参阅：getDisplayMode

DhText.setText

设置（或重新设置）元件所显示的文本。

语法

public void setText( String s )

参数

要显示的文本。

DhText.shouldPersistText

确定对象中的文本是否永久性保存。

语法

public boolean shouldPersistText ()

返回值

如果文本要永久性保存就设置为true；否则就返回false。

DhTextMode类

定义DhText类中的模式常量。

Enum
   |
   +-- DhTextMode

package com.ms.wfc.html

public class DhTextMode

extends com.ms.wfc.core.Enum

字段

DhTextMode.FLOW

指定文本内容将跟普通的HTML流一样处理。

语法

public final static int FLOW;

DhTextMode.NO_BREAK

指明文本内容都将连成一行，没有行分割符，在文档边缘上将剪裁掉多余的部分，而不换行。

语法

public final static int NO_BREAK;

DhTextMode.RESPECT_SPACE

指明文本内容以固定字体显示，而且所有的空白键如空格、跳格键、回车键和换行符也都将显示。

语法

public final static int RESPECT_SPACE;

说明

该元件看起来就象一个块，带有前导行和结束行，除非另行指定。

方法

DhTextMode.valid

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

语法

public static boolean valid ( int n )

参数

要检查的值。

返回值

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

说明

你一个在自己派生的枚举类中覆盖该方法。

DhUnits类

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

Enum
  |
  +-- DhUnits

package com.ms.wfc.html

public class DhUnitsextends Enum

说明

在设置DhElement和DhStyleBase类中的单位时会用到该类。

请参阅：DhPaddingWidthInfo, DhBorderInfo, DhMarginWidthInfo

字段

DhUnits.AUTO

表示自动类型。

语法

public static final int AUTO;

DhUnits.CM

表示厘米(cm)类型。

语法

public static final int CM;

DhUnits.COLOR

表示颜色类型。

语法

public static final int COLOR;

DhUnits.EM

表示元件字体的相对高度。

语法

public static final int EM;

DhUnits.EX

表示一个x高度(ex)。

语法

public static final int EX;

说明

这大约是当前元件字体中小写字母搙數母叨取

DhUnits.INCH

表示英尺(in)类型。

语法

public static final int INCH;

DhUnits.MM

表示毫米(mm)类型。

语法

public static final int MM;

DhUnits.NULL

表示为指定类型。

语法

public static final int NULL ;

DhUnits.PC

表示12点活字(pc)类型。

语法

public static final int PC ;

DhUnits.PERCENT

表示百分比(%)类型。

语法

public static final int PERCENT;

DhUnits.PIXEL

表示像素(px)类型。

语法

public static final int PIXEL;

DhUnits.POINT

表示点(pt)类型。

语法

public static final int POINT;

方法

DhUnits.valid

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

语法

public static boolean valid ( int n )

参数

要检查的值。

返回值

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

说明

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

DhWindow类

封装了一个HTML窗口。

package com.ms.wfc.html

public class DhWindow

方法

DhWindow.close

关闭窗口，将文档和窗口元件都设置为null。

语法

public void close ()

请参阅：getClosed

DhWindow.focus

设置或删除当前窗口的焦点。

语法

final public void focus ( boolean focus )

参数

focus

要设置焦点就设置为true；要删除焦点，就设置为false。

DhWindow.getBrowser

检取浏览器。

语法

final public DhBrowser getBrowser()

返回值

返回代表浏览器的一个对象。

DhWindow.getClosed

确定窗口是否关闭了。

语法

final public boolean getClosed ()

返回值

如果窗口关闭，就返回true；否则，就返回false。

请参阅：close

DhWindow.getDialogArguments

检取传递给模式对话框窗口的参数。

语法

final public Variant getDialogArgument ()

返回值

返回传递给通过showModalDialog所打开对话框的参数。

DhWindow.getDocument

检取窗口所包含的文档。

语法

public DhDocument getDocument ()

返回值

返回与该窗口关联的文档。

说明

如果文档不可访问，就返回null（比如由于安全的限制）。

DhWindow.getEventPeer

检取处理该窗口事件的对等元件。

语法

final public IUnknown getEventPeer()

返回值

返回一个IUnknown对象，包含了处理该窗口事件的对等元件的引用。

说明

调用该方法需要很高的技巧。通常，你不需要直接调用该方法。

DhWindow.getFrame

检取拥有指定名字的第一个框架。

语法

public DhWindow getFrame ( String name )

参数

name

要查找的框架名字。

返回值

返回拥有指定名称的、定义了该框架的窗口。

说明

名字必须是唯一的。否则，该方法就返回null。

DhWindow.getFrames

检取一个DhWindow矩阵，每个元素都是该窗口中的一个框架。

语法

public DhWindow[] getFrames()

返回值

返回定义了框架的窗口矩阵。

DhWindow.getHashString

检取传递给文档的散列字符串。

语法

final public String getHashString()

返回值

返回窗口URL的散列段。

说明

这通常是跟在散列符号(#)后面的字符串。

DhWindow.getHistoryLength

检取窗口历史中条目的数量。

语法

final public int getHistoryLength ()

返回值

返回历史长度。

DhWindow.getName

检取代表该窗口名字的字符串。

语法

final public String getName ()

返回值

返回窗口的名字。

请参阅：setName

DhWindow.getParent

检取窗口的父亲。

语法

public DhWindow getParent ()

返回值

返回该窗口的父窗口。

DhWindow.getPeer

检取该类底层HTML对等元件。

语法

final public IUnknown getPeer()

返回值

返回该类底层HTML对等元件。

说明

如果文档没有绑定到该类，就返回null。运行在信任环境中的Java代码可以任意地将结果引用转换为特定的元件对等类型（例如，com.ms.wfc.html.om.IHTML-Window2）。如果运行在Web服务器环境中，则总是返回null。

调用该方法需要很高的技巧。通常，你并不需要直接调用该方法。

DhWindow.getReturnValue

检取模式对话框窗口的返回值。

语法

final public Variant getReturnValue ()

返回值

返回模式对话框窗口的返回值。

请参阅：setReturnValue

DhWindow.getScroll

检取当前的滚动模式。

语法

public int getScroll ()

返回值

返回当前的滚动模式，可以是下列DhScrollBars值之一：

* AUTO，指明由浏览器来决定滚动模式。

* YES，指明使能滚动操作。

* NO，指明禁止滚动操作。

注意：AUTO和YES是等同的。

请参阅：setScroll

DhWindow.getSearchString

检取传递给文档的搜索字符串。

语法

final public String getSearchString()

返回值

返回窗口URL的搜索段。

说明

这通常是跟在问号(?)后面的字符串。

DhWindow.getTopWindow

检取继承体系结构中最顶层的祖先窗口。

语法

final public DhWindow getTopWindow ()

返回值

返回最顶层的DhWindow对象。

说明

如果本DhWindow窗口就是最顶层的，就返回该窗口。

DhWindow.getURL

检取表示窗口文档URL地址的字符串。

语法

final pubic String getURL()

返回值

返回窗口位置的URL地址。

请参阅：open

DhWindow.getWindowPeer

检取该类底层HTML对等元件。

语法

protected IHTMLWindow2 getWindowPeer ()

返回值

返回该类底层HTML对等元件。

说明

调用该方法需要很高的技巧。通常，你并不需要直接调用该方法。

DhWindow.goBackInHistory

加载历史列表中前一个URL。

语法

final public void goBackInHistory ( int delta, EventHandler h )

参数

delta

相对于当前页所要返回去的页面数。

当浏览器加载历史页面时就调用EventHandler代理所指定的方法。

请参阅：goRelativeInHistory , goForwardInHistory

DhWindow.goForwardInHistory

加载历史列表中下一个URL地址。

语法

final public void goForwardInHistory ( int delta, EventHandler h )

参数

delta

相对于当前页所要前进的页面数。

当浏览器加载下一个URL页面时就调用EventHandler代理所指

定的方法。

请参阅：goBackInHistory , goRelativeInHistory

DhWindow.goRelativeInHistory

加载历史列表中前一个URL地址。

语法

final public void goRelativeInHistory ( int delta, EventHandler h )

参数

delta

相对于当前页所要前进或后退的页面数。

当浏览器加载相对的URL页面时就调用EventHandler代理所指定的方法。

返回值

返回代表当前导向的唯一索引。

请参阅：goBackInHistory , goForwardInHistory

DhWindow.messageBox

显示一个模式用户信息对话框。

语法

final public void MessageBox ( String s )

参数

要显示的消息。

DhWindow.navigate

使用指定的名字和属性在本窗口中打开一个新的URL地址。

语法

final public void navigate ( String url, EventHandler h )

参数

url

定义新URL地址的字符串。

在浏览器导向新URL完毕后就调用EventHandler代理所指定的方法。

返回值

返回一个新开发窗口的DhWindow句柄。

DhWindow.open

使用指定的名字和属性在当前窗口中打开一个新的URL地址。

语法

final public DhWindow open ( String url, String name,DhWindowInfo wi, boolean fReplace )

参数

url

新位置的URL地址字符串。

Name

窗口的名字，该名字中不能包含空格。

一个DhWindowInfo对象，定义新窗口的外观和尺寸。

FReplace

设置为true将替换当前内容；设置为false将保留当前内容。

返回值

返回新打开窗口的DhWindow句柄。

请参阅：getURL

DhWindow.setName

设置当前窗口的名字。

语法

final public void setName ( String name )

参数

name

窗口的名字。该名字不能包含标点符号。

请参阅：getName

DhWindow.setReturnValue

设置将从模式对话框窗口返回的值。

语法

final public void setReturnValue ( Variant retValue )

参数

retValue

从模式对话框窗口返回的值。

请参阅：getReturnValue

DhWindow.setScroll

设置当前的滚动模式。

语法

public void setScroll ( int scrollMode )

参数

scrollMode

所需要的滚动模式，可以是下列之一：

* DhScrollBars.AUTO，指明由浏览器来决定滚动模式。

* DhScrollBars.YES，指明允许进行滚动操作。

* DhScrollBars.NO，指明不允许进行滚动操作。

请参阅：DhScrollBars, getScroll

DhWindow.setStatus

在窗口宿主（通常是浏览器）的状态条中显示一个字符串。

语法

final public void setStatus ( String s )

参数

要在状态条上显示的字符串。

DhWindow.showModalDialog

使用URL作为内容的来源以及使用DhDialogInfo来定义对话框窗口的外观从而打开一个HTML对话框窗口。

语法

final public Variant showModalDialog ( String dialogUrl, VariantdialogArgs, DhDialogInfo di )

参数

dialogUrl

对话框窗口内容的URL地址字符串。

DialogArgs

一个com.ms.com.Variant对象，包含了要传递给内容文档的可选参数。

一个DhDialogInfo对象，定义对话框窗口的外观。

返回值

返回一个com.ms.com.Variant对象，对对话框窗口的

返回值

进行打包。

DhWindowInfo类

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

package com.ms.wfc.html

public class DhWindowInfo

说明

当打开一个新的浏览器窗口时，该类的一个实例就作为参数传递给DhWindow.open方法。

请参阅：DhWindow.open

字段

DhWindowInfo.isResizable

通知浏览器打开一个新窗口时可以改变其大小。

语法

public boolean isResizable；

DhWindowInfo.showChannelMode

通知浏览器以theater模式打开一个新窗口并显示频道。

语法

public boolean showChannelMode;

说明

在theater模式下，Internet Explorer主窗口将填充整个屏幕并在工具栏中显示最小的导航工具条。在屏幕的右上角也将提供一个状态条。在theater模式中，Channels, Search, History和Favorites浏览器工具按钮将以自动隐藏的浮动工具栏的方式显示在屏幕左边。

请参阅：DhWindow.open

DhWindowInfo.showDirectoryButtons

通知浏览器打开一个新窗口并增加目录按钮。

语法

public boolean showDirectoryButtons;

DhWindowInfo.showFullScreen

通知浏览器以全屏方式打开一个新窗口。

语法

public boolean showFullScreen;

DhWindowInfo.showLocation

通知浏览器打开一个新窗口，并显示直接输入到浏览器中URL输入字段。

语法

public boolean showLocation ;

DhWindowInfo.showMenubar

通知浏览器打开一个新窗口并显示菜单工具条。

语法

public boolean showMenubar ;

DhWindowInfo.showScrollbars

通知浏览器打开一个新窗口并显示滚动条。

语法

public boolean showScroolbars;

DhWindowInfo.showStatusbar

通知浏览器打开一个新窗口并显示状态条。

语法

public boolean showStatusbar;

DhWindowInfo.showToolbar

通知浏览器显示浏览器工具条，并显示工具条按钮如Back, Forward和Stop等。

语法

public boolean showToolbar;

DhWindowInfo.size

通知浏览器打开一个新窗口并使用矩形作为该窗口的大小。

语法

public Rectangle size;

说明

Rectangle对象的宽度和高度不应小于100。y字段指明距离屏幕左上角的顶部相对像素位置，x字段指明距离屏幕左上角的左边相对像素位

置。

构造器

DhWindowInfo. DhWindowInfo

创建一个DhWindowInfo对象。

语法

public DhWindowInfo()

public DhWindowInfo( Rectangle size )

参数

size

描述窗口大小的Rectangle对象。

方法

DhWindowInfo.addFeature

增加一新的自定义特征。

语法

public void addFeature ( String name, String value )

参数

name

自定义特征的名字。

Value

自定义特征的数值。

请参阅：removeFeature

DhWindowInfo.getValue

检取自定义特征的值。

语法

public String getValue ( String name )

参数

name

要检取的自定义特征的名字。

DhWindowInfo.removeFeature

删除一个自定义特征。

语法

public void removeFeature( String name )

参数

name

要删除的自定义特征的名字。

请参阅：addFeature

DhWindowInfo.toString

检取代表DhWindowInfo对象的一个字符串。

语法

public String toString ()