这些方法只适用于脚本对象模型（Scripting Object Model）。关于适用于设计期间控件的属性列表，参见本手册前边的“设计期间控件属性”（Design-TimeControl Propeties）。

有关脚本对象模型和设计期间控件的讨论，见Visual InterDev在线文档中的“Scripting with Design-Time Controls and Script Objects”部分。

ADDIMMEDIATE方法

把一个记录立即添加到数据库中。

适用于

Recordset脚本对象

语法

object.addImmediate ( )

参量

object

一个Recordset脚本对象。

说明

关于详细过程，包括适用于addImmediate的简单脚本，见Visual InterDev在线文档中的“Adding Records”。

ADDITEM METHOD方法

把一个项添加到一个Listbox或OptonGroup对象中。

适用于

Listbox脚本对象，OptionGroup脚本对象。

语法

object.addItem (strItem, [strValue], [nIndex] );

参量

object

一个Recordset脚本对象。

StrItem

规定显示项的文本。

strValue

为项的VALUE属性规定一个串。

nIndex

规定在列表中项位置的整数。

说明如果不提供strValue参量，strItem参量就作为strValue来使用。

如果不提供nIndex参量，项就加到列表的末尾。

其RowSource绑定到一个Recordset对象上的对象不提供这个addItem方法。

举例

下边的脚本使用DHTML中的窗口onload事件填充一个列表框。

function window_onload( )

{

    for ( i = 0; i < 5; i ++)

    {

        myListbox.addItem( ″Item″ + i ) ;

    }

    myListbox.selectedIndex = 3 ; // select the 4th item

}

ADDRECORD方法

在Recordset对象中添加一个新记录。

适用于

Recordset脚本对象

语法

object.addRecord ( )

参量

object

一个Recordset脚本对象。

说明

这个addRecord方法自动在Recordset对象中创建一个新记录。使用updateRecord方法把变更写到这个新记录中。

参见

RECORDSET设计期间控件， UPDATERECORD方法

ADVISE方法

登记一个对象，通告一个特定事件什么时间出现，并调用一个特定函数。

适用于

Button脚本对象, Checkbox脚本对象, Listbox脚本对象, OptionGroup脚本对象, PageObject脚本对象, Recordset脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象

语法

[id = ] object.advise ( strEvent, CallFunction )

参量

id

可以由注销对象的unadvise（注销通告）方法使用的一个标识符。

Object

一个脚本对象。

strEvent

引起对象通告的事件。

CallFunction

在事件出现时调用的函数。

说明

脚本对象有不需要通告的隐含事件。每个脚本对象的题目都列出这些事件。

对于PageObject事件就，如果使用Visual Basic, Scripting Edition (VBScript)函数处理客户机上的onbeforeserverevent事件，就使用这种通告方法登记事件。

javascript和VBScript在传递引用给一个函数的时候，会使用稍有不同的语法：

· 如果用javascript编写脚本，使用一种函数指针，不用圆括号和引号，如下行所示： Button1.advise("onmouseover", Button2_onmouseover)

· 如果用VBScript编写脚本，就按对象传递函数名字。这需要把引号放到包括引号的函数名字的两边，如下行所示：

Button1.advise("onmouseover", "Button2_onmouseover( )")

使用unadvise（注销通告）方法，取消对象的登记。

举例

下边的脚本在onmouseover事件出现的时候，将调用函数“Button_onmouseover”。这个例子把以DHTML为目标的按钮作为脚本平台。

< SCRIPT FOR= ″window″EVENT= ″onload″LANGUAGE=″javascript″>

Button1.advise(″onmouseover″,Button1_onmouseover);

< /SCRIPT >

参见

UNADVISE方法， ONBEFORESERVEREVENT事件

BINDALLCOLUMNS方法

使得Grid对象中的所有栏都是可见的。

适用于

Grid脚本对象

语法

object.bindAllColumns ( )

参量objcect

一个Grid脚本对象。

举例

grid1.bindAllColumns ( )；

参见

GRID设计期间控件， GRID脚本对象

CANCELOPERATION方法

取消在Recordset对象中调用的移动光标位置的方法。

适用于

RecordsetNavbar脚本对象

语法

objRSnavbar.cancelOperation ( )

参量

objRSnavbar

一个RecordsetNavbar脚本对象。

说明这个cancelOperation方法防止调用下述方法：moveFirst、movePrevious、moveNext和moveLast。这些方法适用于Recordset对象。

举例

Sub myRSNavbar_onfirstclick( )

    if sUserName = ″Frank″Then

        ′ don′t let Frank move these recordsets around,

        ′ he′ll run the server right into the ground

        myRSNavbar.cancelOperation( )

    end if

End Sub

参见

RECORDSETNAVBAR设计期间控件， ONFIRSTCLICK事件， ONLASTCLICK事件， ONNEXTCLICK事件， ONPREVIOUSCLICK事件， ISOPERATIONCANCELLED方法， RECORDSETNAVBAR脚本对象

CANCELUPDATE方法

取消对当前记录作出的改变。

适用于

Recordset脚本对象

语法

object.cancelUpdate ( )

参量

object

一个Recordset对象。

说明

这个cancelUpdate方法使得用updateRecord方法对当前记录作出的改变归于失败，并把记录的字段恢复成原来的值。

在更新记录时，可以使用onbeforeupdate和onafterupdate事件去俘获错误。

举例

在一个数据入口窗体中，通常允许用户插入新记录，更新已有记录，删除记录等。如果允许用户更新记录，他们大概也需要能够取消这些操作。

下边的代码片段显示了用户如何取消在窗体中的更新操作。

function btnCancel_onclick( )

{

    DTCRecordset1.cancelUpdate( );

    DTCRecordset1.move(0);

}

这个方法将用以前的值取代用户在窗体中所有更新的值。这个移动方法只用于ASP页面情况，在这里强制窗体显示以前的值。对于DHTML情况，这种移动方法不需要，也不用。

参见

ONAFTERUPDATE事件， ONBEFOREUPDATE事件， UPDATERECORD方法

CLEAR方法

清除Listbox或OptionGroup对象的内容。

适用于

Listbox脚本对象，Optiongroup脚本对象

语法

object.clear ( )

参量

object

一个Listbox或OptionGroup脚本对象。

说明

绑定到Recordset对象上RowSource所在的对象不支持这种清除方法。

举例

Sub AddListBoxItems(aArrayOfItems)

Dim iCount

    ′clear the item out of the list box

    MyListBox.clear( )

    for iCount = 0 to ubound(aArrayOfItems)

        MyListbox.addItem(aArrayOfItems(iCount))

    Next

End Sub

CLOSE方法

关闭一个Recordset（记录集）对象。

适用于

Recordset脚本对象

语法

object.close ( )

参量

object

一个Recordset脚本对象。

举例

这个例子显示如何使用文本框中的值改变查询(query)子句所在的位置。

function btnQuery_onclick( )

{

    if ( RS1.isOpen( ) )

        RS1.close( ); //must close the recordset before changing the SQLText

    RS1.setSQLText(′Select * from TABLE1

        where (ID=′+ txtQuery.value +′) ′);

    RS1.open( );

}

参见

ISOPEN方法， OPEN方法

CREATEDE方法

创建一个“数据环境”（Data Environment）自动服务器。只适用于服务器脚本。

适用于

PageObject脚本对象

语法

object.createDE ( )

参量

object

一个PageObject脚本对象。

说明

“数据环境”可以作为放在ActiveX Data Object(ADO)外边的封套（wrapper）去访问数据。

在创建“数据环境”时，命名为“DE”，于是就可以引用包含在这个数据环境中的命令对象和链接。

举例

想象已经建立起一个命令对象，这个对象借助于一种已存过程把第一个名字和最后名字插入到Customers（客户）表中，于是可以调用的就是这样一个命令对象InsertCustomer。

Sub thisPage_onenter( )

    ThisPage.createDE( )

    ′ at this point the DE is now in the namespace′

    ′ now invoke the command object

    DE.InsertCustomer(″FirstName″, ″LastName″)

end sub

DELETERECORD方法

从Recordset（记录集）中删除当前记录。

适用于

Recordset脚本对象

语法

object.deleteRecord ( )

参量

object

一个recordset脚本对象。

说明

可以使用下述方法移动光标，使它选定当前记录：move、moveNext、movePrevious、moveFirst和moveLast。

参见

ADDRECORD方法， UPDATERECORD方法

DISPLAY方法

把脚本对象插入到HTML流中。

适用于

Label脚本对象, Button脚本对象, Checkbox脚本对象, Listbox脚本对象,OptionGroup 脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象

语法

object.display ( )

说明

这种显示方法把脚本插入到HTML流中。如果对象是在HTML流中，可以使用hide和show方法改变它对用户的可见性。

注意：

这种显示方法一旦调出到服务器脚本（ASP）中，就不能用这个控件再做什么了，例如调用show或hide方法，或设置关闭的属性等。

参见

HIDE方法， ISVISIBLE方法， SHOW方法

ENDPAGECONTENT方法

结束由startPageContent方法开始的页面处理。

只适用于服务器脚本。

适用于

PageObject脚本对象

语法

object.endPageContent ( )

参量

object

一个PageObject脚本对象。

说明

endPageContent方法声明由ASP页面生成的客户文档内容结束。

举例

对编写分离的文本块来说，startPageContent和endPageContent方法很有用。如按照下述例子俘获错误，这两种方法很好用。

function thisPage_onenter( )

{

    if (thisPage.getState(″Error″) == 57 )

    {

        startPageContent( );

        response.write ″Error 57: Please call Helpdesk. ″;

        endPageContent( );

    }

}

参见

STARTPAGECONTENT方法

GETALIGNMENT方法

返回一个确定导航或选项按钮是纵向排列或横向排列的值。

适用于

OptionGroup脚本对象, RecordsetNavbar脚本对象

语法

object.getAlignment ( )

参量

object

一个RecordsetNavbar或OptionGroup脚本对象。

说明

这个方法返回下述值：

欲设置值，使用setAlignment方法。

举例

nAlign = RecordsetNavbar1.getAlignment ( );

参见

SETALIGNMENT方法， ALIGNMENT属性

对当前记录返回一个书签。

适用于

Recordset脚本对象

语法

object.getBookmark( )

参量

object

一个Recordset脚本对象。

说明

欲设置书签，使用setBookmark方法。

getBookmark和setBookmark方法对ADO记录集书签来说是类似的，但是可以持续保留在页之间。

因为在绑定到ASP中的数据上时，每次对页面服务时，默认表现都要求代码程序关闭(Close)并重新打开(Reopen)记录集，并且因为记录集一旦关闭ADO书签便成为无效的，因此，Microsoft Visual InterDev实现一种定制书签，其表现同ADO书签一样。

这样，就可以存储一个书签，关闭记录集，重新打开记录集，并设置书签，于是就找到了要到达的记录。

举例

下边的脚本存储一个书签，关闭记录集，重新打开这个记录集，再设置书签，于是就来到正确的记录位置。

Sub SampleBookmark( )

Dim tmpBookmark

    myRS.Open( )myRS.moveNext( ) ' now we are on the second record

    tmpBookMark = myRS.getBookMark( )

    ' now close the recordset

    myRS.Close( )

    typically your bookmark is invalid, but in Visual InterDev it is not

    'we will re-open this recordset, but assume this is another page perhaps

    myRS.Open( )

    ' let's also assume that several records have been inserted before

    'and after the record we bookmarkedmyRS.setBookMark(tmpBookMark)'we are now on the same record we were before

    '(which this time is not necessarily the 2nd record)

End Sub

参见

SETBOOKMARK方法

GETBORDER方法

返回一个值，表示OptionGroup对象周围是否有边框。

适用于

OptionGroup脚本对象

语法

object.getBorder ( )

参量

object

一个OptionGroup脚本对象。

说明

如果无边框，返回0；如果有边框，返回1。

参见

SETBORDER方法

GETBUTTON方法

返回由RecordsetNavbar对象或由OptionGroup对象创建的一个Button（按钮）对象。

适用于

OptionGroup脚本对象，RecordsetNavbar脚本对象

语法

object.getButton ( nIndex )

参量

object

一个RecordsetNavbar或OptionGroup脚本对象。

NIndex

指定是由哪个按钮对象返回的整数。下边的值确定对RecordsetNavbar返回哪个按钮。

举例

objLastButton = RecordsetNavbar1.getButton(3);

objLastButton.value = ″Very Last″; // change caption of the ″Last″button

GETBUTTONSTYLE方法

返回一个值，表示哪个按钮显示图像，哪个按钮显示RecordsetNavbar上的文本。

适用于

RecordsetNavbar脚本对象

语法

object.getButtonStyles ( )

参量

object

一个RecordsetNavbar脚本对象。

说明

返回一个值，表示四个按钮的各个样式。返回的值是下列的和：

欲设置哪个按钮显示图像，哪个按钮显示文本，见本节后边的“setButtonStyles方法”。

举例

下边的javascript检查RecordsetNavbar的第一个按钮上是否有标题。如果有，则改变这个标题。

function Button1_onclick( )

{

    nButtonMask = RecordsetNavbar1.getButtonStyles( );

    if ((nButtonMask & (RSNB_MASK_FIRSTCAPTION)) ! = 0 )

    {

        // Button has a caption, so lets change it

        RecordsetNavbar1.getButton(0).value = ″First Record″;

    }

}

参见

SETBUTTONSTYLE方法

GETCAPTION方法

返回对象的标题。

适用于

Label脚本对象，Checkbox脚本对象，OptionGroup脚本对象

语法

object.getCaption ( )

参量

object

一个脚本对象。

说明

欲设置标题，使用setCaption方法。

对于Checkbox和OptionGroup对象，标题是在客户机上查看页面时，出现在页面上复选框后边的文本。

对于Label对象，标题是标签上的文本。

举例

在下边的脚本中，getCaption把Button1的标题传递给strCaption:

strCaption = Button1.getCaption ( )

参见

SETCAPTION方法

GETCHECKED方法

返回一个布尔值，表示复选框被检查还是不被检查

适用于

Checkbox脚本对象

语法

object.getChecked ( )

参量

object

一个Checkbox脚本对象。

说明

这个Checkbox对象用于显示数据库中的二进制数据或把二进制数据写入数据库中。Checkbox的状态映射成 < INPUT > 标记的VALUE属性。在客户浏览器上显示的VALUE属性的设置，取决于Recordset对象的DataField属性的数据类型。

注意：

这种方法可以调用，无需数据绑定。

欲设置Checkbox对象的状态，见setChecked方法。

举例

在下边的例子使用DHTML和javascript:

if ( myCheckbox.getChecked ( ) )

{

    response.write ( myCheckbox.getCaption ( ) )

}

参见

SETCHECKED方法

GETCOLUMNCOUNT方法

返回Textbox对象中的栏数，以便确定宽度。

适用于

Textbox脚本对象

语法

object.getColumnCount ( )

参量

object

一个脚本对象。

说明

Textbox对象中的栏数决定客户机中文本框的宽度，单位是字符。这个栏数等效于COLS属性。

欲设置栏数，使用setColumnCount方法。

参见

SETCOLUMNCOUNT方法

GETCONNECTSTRING方法

返回确定数据连接的文本串或对象。

适用于

Recordset脚本对象

语法

object.getConnectString ( )

参量

object 一个Recordset脚本对象。

举例

Sub myRS_onbeforeopen ( )

Dim sConnString

    sConnString = myRS.getConnectString( )

    Msgbox "Here is the connection string that was used to open this

        recordset: ″ & sConnString

End Sub

GETCOUNT方法

返回对象中的项数。

适用于

Listbox脚本对象, OptionGroup脚本对象, Recordset脚本对象, fields脚本对象,

语法

object.getCount ( )

参量

object

一个脚本对象。

说明

对于Listbox对象，由getCount返回的数据总是比最大的selectedIndex属性的值大1。

对于Recordset对象，getCount返回Recordset中的记录数。如果Recordset是空，则返回值是－1。

举例

使用DHTML和JavaScropt显示一个列表框对象中的所有项。

For ( i = 0; i < 1stTest.getCount ( ) ; i ++ )

{

    alter (″Item is: ″ + 1stTest.getText ( i ) );

}

GETDATAFIELD方法

返回绑定当前对象的Recordset对象的数据段。

适用于

Label脚本对象, Checkbox脚本对象, Listbox脚本对象, OptionGroup脚本对象, Textbox脚本对象

语法

object.getDataField ( )

参量

object

一个脚本对象。

说明

由getDataSource方法返回的Recordset对象。

参见

SETDATAFIELD方法

GETDATAFORMATAS方法

返回一个串，表示提供给对象的数据是按照文本还是按照HTML提交的。

适用于

Label脚本对象

语法

object.getDataFormatAs ( )

参量

object

一个Label脚本对象。

说明

如果返回“LBL_TEXT”, 则数据按照文本处理。如果返回“LBL_HTML”，则数据按照HTML处理。

规定若数据按HTML文本提交，则使用SetDataFormatAs方法。

参见

SETDATAFORMATAS方法

GETDATASOURCE方法

返回用于绑定数据的Recordset对象。

适用于

Label脚本对象, Checkbox脚本对象, Listbox脚本对象, OptionGroup脚本对象 RecordsetNavbar脚本对象, Textbox脚本对象

语法

object.getDataSource ( )

参量

object

一个脚本对象。

说明

欲规定用哪个字段绑定Recordset对象，使用setDataField和getDataField方法。

当使用设计期间控件时，由Recordset属性规定Recordset对象。

举例

在下边的一行中，getDataSource返回绑定到一个Listbox对象上的Recordset对象，并把它传递给变量objRS。objRS=Listbox1.getDataSource();

参见

GETDATAFIELD方法， SETDATASOURCE方法

GETDHTMLDATASOURCEID方法

从DHTML数据源的ID返回文本串。只用于客户脚本。

适用于

Recordset脚本对象

语法

object.getDHTMLDataSourceID ( )

参量

object

一个Recordset脚本对象。

说明

ID相当于DHTML属性的设置。在把数据同内部HTML进行绑定时可以使用ID。

GETMAXLENGTH方法

返回一个Textbox对象的最大长度，单位是字符。

适用于Textbox脚本对象

语法object.getMaxLength ( )

参量object 一个Textbox脚本对象。

说明

欲设置最大长度，则使用setMaxLength方法。

参见

SETMAXLENGTH方法

GETNAME方法

从字段集合返回一个字段名字。

适用于

fields脚本对象

语法

object.filds.getName ( nIndex )

参量

object

一个Recordset脚本对象。

NIndex

指定一个字段索引的整数，而这个字段的名字正是要返回的。nIndex 是从零开始的。

说明

这个字段集合是Recordset脚本对象的子对象。使用getValue方法返回这个字段的值。

举例

使用DHTML和javascript，从一个记录集把字段的名字加到一个列表框中。

For ( i = 0; i < myRecordset.fields.getCount ( ); i ++ )

{

    myListbox.addItem ( myRecordset.fields.getName ( i ) );

}

GETPAGINGNAVBAR方法

创建一个到RecordsetNavbar脚本对象的引用，以便为分页导航去调用方法或设置属性。

适用于

Grid脚本对象

语法

object.getPagingNavbar ( )

参量

object

一个Grid脚本对象。

举例

objPagingNavbar = grid1.getPagingNavbar( );

objPagingNavbar.updateOnMove = false; //Sets the updateOnMove Property off

参见

GRID设计期间控件， GRID脚本对象， RECORDSETNAVBAR脚本对象

GETPARAMETER方法

从存储的过程或参量化查询中获取参量。

适用于

Recordset脚本对象

语法

object.getParameter ( nIndex )

参量

object

一个Recordset脚本对象。

NIndex

一个整数，规定在参量数组中从零开始的具体参量的索引。

说明

欲为已存储的过程或参量化查询设置参量，则使用setParameter方法。

举例

关于使用已存储的过程的例子和使用参量化查询的例子，见setparameter。

参见

SETPARAMETER方法

GETPROPERTY方法

返回用户定义的属性值。

适用于

PageObject脚本对象

语法

object.getproperty

参量

object

一个PageObject脚本对象。

Getproperty

规定用户定义的属性，其属性值是希望返回的。

说明

这个方法是由PageObject设计期间控件创建的。对于希望在PageObject控件的定制属性对话框的Properties标签卡上创建的每个属性，PageObject控件以这个属性为基础创建一对方法。例如，如果希望把一个属性加到PageObject控件上，而且命名为“Cost”，那么这个控件就创建getCost和setCost方法。

欲设置用户定义的属性值，就使用setproperty方法。

注意：

可以在PageObject控件的定制属性对话框的Properties标签卡上设置属性的作用域（读/写，客户/服务器）。

获取和设置用户定义属性值的另一种方式是使用getState和setState方法。

关于创建和使用ASP页面上属性的内容，详见在线文档中“Extending theScripting Object Model Across Pages”中的 defining Properties for a PageObject

参见

GETSTATE方法， SETSTATE方法

GETRECORDSETNAVBAR方法

创建一个到RecordsetNavbar脚本对象的引用，以便为用Grid控件进行记录导航去调用方法或设置属性。

适用于

Grid脚本对象

语法

object.getRecordsetNavbar ( )

参量

object

一个Grid脚本对象。

举例

objRecordsetNavbar = grid1.getRecordsetNavbar( );

objRecordsetNavbar.updateOnMove = false;//Sets the updateOnMove Property off

参见

GRID设计期间控件， GRID脚本对象， RECORDSETNAVBAR脚本对象

GETRECORDSOURCE方法

返回ADO Recordset对象。

适用于

Recordset脚本对象

语法

object.getRecordSource ( )

参量

object

一个Recordset脚本对象。

说明

这个方法返回ADO记录集对象，从而允许访问ADO支持的属性和方法，这时这些属性和方法不暴露在Recordset脚本对象中。

欲设置ADO Recordset对象，则要调用setRecordSource方法。

参见

SETRECORDSOURCE方法

GETROWCOUNT方法

返回确定一个Textbox对象高度的行数。

适用于

Textbox脚本对象

语法

object.getRowCount ( )

参量

object

一个Textbox脚本对象。

说明

欲设置行数，则要调用setRowCount方法。

参见

SETROWCOUNT方法

GETROWSOURCE方法

对给定的控件，从询查记录集中返回一个记录集脚本对象。

适用于

Listbox脚本对象, OptionGroup脚本对象

语法

object.getRowSource ( )

参量

object

一个Listbox或OptionGroup脚本对象。

说明

把数据绑定到一个Listbox对象上，然后再把那个Listbox中的项绑定到一个记录集上，这往往是很有用的。这个记录集就称作rowsource（行源）。这个方法返回上述记录集。

参见

SETROWSOURCE方法

GETSELECTEDINDEX方法

返回一个OptionGroup对象中的已选项索引。

适用于OptionGroup脚本对象

语法

object.getselectedIndex ( )

参量

object

一个OptionGroup脚本对象。

参见

SELECTEDINDEX属性

GETSQLTEXT方法

返回一个SQL语句，这个语句是在数据库中查询记录集时用的。

适用于

Recordset脚本对象

语法

object.getSQLText ( )

参量

object

一个Recordset脚本对象。

说明

欲设置SQL语句，则调用setSQLText方法。

举例

Sub myRS_onbeforeopen( )

    Msgbox ″The query that is about to be executed is : ″& myRS.getSQLText( )

End Sub

参见

SETSQLTEXT方法

GETSTATE方法

返回用户定义的属性值，或者null，如果这个属性不存在的话。

适用于

PageObject脚本对象

语法

object.getState ( Property )

参量

object

一个PageObject脚本对象。

Property

用户定义的可由PageObject设计期间控件创建的属性。

说明

欲设置用户定义的属性值，则使用setState方法。

获取或设置用户定义属性值的另一种方法是使用getProperty和setProperty方法。

可以为PageObject定制属性对话框的Properties标签卡上的PageObject控件创建用户定义的属性。这也是可以设置这种属性作用域（读/写，客户/服务器）的地方。

有关创建和使用ASP页面属性的内容，详见Visual InterDev在线文档中的“Extending the Scriping Object Model Across Pages”。

参见

GETPROPERTY方法， SETPROPERTY方法， SETSTATE方法

GETSTYLE方法

返回标识对象样式的一个整数。

适用于

Button脚本对象, Textbox脚本对象

语法

object.getStyle ( )

参量

object

一个Textbox或Button脚本对象。

说明

对于Button对象，整数标识Button的样式

对于Textbox，整数标识Textbox的样式

欲设置对象样式，则调用setStyle。

参见

SETSTYLE方法

GETTEXT方法

返回Listbox对象的一个项的文本串。

适用于

Listbox脚本对象

语法

object.getText ( [nIndex] )

参量

object

一个Listbox脚本对象。

NIndex

以零开头列表中一个项的索引。如果留下的是null，则索引默认当前选定的项。当前选定项的索引相当于selectedIndex属性的值。

举例

在下边的脚本中，gerText把一个串从列表框的第五项传递给一个名字叫strItem的变量。

strItem = ListBox1.getText ( 4 );

参见

GETVALUE方法， SELECTBYCAPTION方法， SELECTBYINDEX方法， SELECTBYTEXT方法， SELECTBYVALUE方法， SETTEXT方法， SETVALUE方法， SELECTEDINDEX属性

GETVALUE方法

从一个对象返回一个值。

适用于

Listbox脚本对象, OptionGroup脚本对象, fields脚本对象

语法

object.getValue ( [nIndex | strField] )

参量

object

一个脚本对象。

NIndex

以零开头列表中一个项的索引。如果留下的是null，则索引默认当前选定的项。当前选定项的索引相当于selectedIndex属性的值。

StrField

该字段的名字串。

说明

对于Listbox和OptionGroup对象，这种方法返回对应于HTML属性VALUE的文本串。

对于字段对象，这个方法返回当前记录的字段值。

注意：

对于OptionGroup对象和ASP页面，有另一种方法返回设置的值。可以使用它们的名字连同附在其后的“_value”引用一个OptionGroup对象。例如，可以通过调用 myVar = request (″myOptionGroup_value″) 的办法，从其id为“myOptionGroup”的OptionGroup中传递这个值。

对于脚本对象模型，可以使用下面的式子返回同样的结果：

myVar = myOptionGroup.getValue ( )

参见

GETTEXT方法， SELECTBYCAPTION方法， SELECTBYINDEX方法， SELECTBYTEXT方法， SELECTBYVALUE方法， SETTEXT方法， SETVALUE方法

HIDE方法

把对象隐蔽起来，以便在浏览页面时见不到它。

适用于

Button脚本对象, Checkbox脚本对象, Grid脚本对象, Label脚本对象, Listbox脚本对象, OptionGroup脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象

语法

object.hide ( )

参量

object

一个脚本对象。

说明

要小心，不要把display、hide和show几种方法搞混了。hide 和show两种方法决定对象在浏览页面的时候是否可见，而display方法决定对象是否包含在HTML流中。

举例

function btnCheck_onclick ( )

{

    if ( btnCheck.isVisible( ) ) //Toggle visibility of the checkbox

        Checkbox1.hide( );

    Else

        Checkbox1.show( );

}

参见

ISVISIBLE方法， SHOW方法， DISPLAY方法

ISOPEN方法

返回一个布尔值，表示一个Recordset对象是否是打开的。

适用于

Recordset脚本对象

语法

object.isOpen ( )

参量

object

一个Recordset脚本对象。

说明

如果Recordset是打开的，返回真，否则返回假。

举例

这个例子演示用Textbox的一个值改变查询（query）子句所在的地方。

Function btnQuery_onclick( )

{

    if ( RS1.isOpen( ) )

        RS1.close( );//must close the recordset before changing the SQLText

    RS1.setSQLText (′Select * from TABLE1 where ( ID = ′ + txtQuery.value + ′ )′ )

    RS1.open( );

}

参见

CLOSE方法， OPEN方法

ISOPERATIONCANCELLED方法

返回一个布尔值，表示一个移动方法是否已经取消。

适用于

RecordsetNavbar脚本对象

语法

object.isOpertationCancelled ( )

参量

object

一个RecordsetNavbar脚本对象。

说明

使用这个cancelOperation方法取消调出的用于在一个Recordset对象中移动光标位置的方法。

参见

RECORDSETNAVBAR设计期间控件， ONFIRSTCLICK事件， ONLASTCLICK事件， ONNEXTCLICK事件， ONPREVIOUSCLICK事件， CANCELOPERATION方法， RECORDSETNAVBAR脚本对象

ISVISIBLE方法

返回一个布尔值，表示一个对象是处于可见状态还是隐蔽状态。

适用于

Button脚本对象, Checkbox脚本对象, Grid脚本对象, Label脚本对象, Listbox脚本对象, OptionGroup脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象

语法

object.isVisible ( )

参量

object

一个脚本对象。

说明

如果对象是可见的（默认），这个方法就返回True，否则，返回False。欲显示或隐蔽对象，则使用show和hide方法。

要小心，不要把display、hide和show几种方法搞混了。hide 和show两种方法决定对象在浏览页面的时候是否可见，而display方法决定对象是否包含在HTML流中。]

举例

function btnCheck_onclick ( )

{

    if ( btnCheck.isVisible( ) ) //Toggle visibility of the checkbox

        Checkbox1.hide( );

    Else

        Checkbox1.show( );

}

参见

DISPLAY方法， HIDE方法， SHOW方法