colSpan
Properties Reference

colSpan

Description

Specifies how many columns in the TABLE this cell should span.

Syntax

object.colSpan[ = colSpan]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Remarks

This property can only be changed after the page has been loaded.

Applies To

TD, TH


compact

Description

Specifies that the list should be compacted to remove extra space between list elements.

Syntax

object.compact[ = compact]

Remarks

The default value for this property is FALSE.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

DL


complete

Description

Returns whether the specified element is fully loaded.

Syntax

object.complete

Settings

This read-only property is TRUE if the element is loaded, or FALSE otherwise.

Applies To

IMG


connectionSpeed

Description

Indicates the current connection speed of your session.

Syntax

object.connectionSpeed

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

navigator


content

Description

Specifies meta-information to be associated with the given name or HTTP response header.

Syntax

object.content[ = content]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

META

See Also

httpEquiv


cookie

Description

Specifies a string value of a cookie, which is a small piece of information stored by the browser.

Cookies are made from the following. (All are optional with the exception of the name=value pair.) Arguments are separated by semicolons.

name=value; Each cookie is stored in a name=value pair, that is, if the cookie is "foo" and you want to save foo's value as "bar", the cookie would be saved as foo=bar. You can save as many name=value pairs in the cookie as you want, but the cookie is always returned as a string of all the cookies that apply to the page, so the string that is returned has to be parsed to find the values of individual cookies.
Expires=date; If no expiration is set on a cookie, it will expire when the browser is closed. Setting an expiration date in the future causes the cookie to be saved across browser sessions. Setting an expiration date in the past will delete a cookie. The date should be specified using GMT format.
domain=domainname; The domain of the cookie can be set, which allows pages on a domain made up of more than one server to share cookie information.
path=path; Setting a path for the cookie will allow the current document to share cookie information with other pages within the same domain, that is, if the path is set to /foobar, all pages in /foobar and all pages in subfolders of /foobar will be able to access the same cookie information.
secure; Specifying a cookie as "secure" means that the stored cookie information can be accessed only from a secure environment.

Syntax

object.cookie[ = cookie]

Remarks

Use string methods such as substring, charAt, indexOf, and lastIndexOf to determine the value stored in the cookie.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

document


cookieEnabled

Description

Returns whether client-side cookies are enabled in the browser.

Syntax

object.cookieEnabled

Settings

This read-only property is TRUE if cookies are enabled, or FALSE otherwise.

Applies To

navigator


coords

Description

Specifies coordinates that define the hot spot's shape.

Syntax

object.coords[ = coords]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

AREA

See Also

shape


cpuClass

Description

Returns a string of the CPU class (for example, x86, Alpha, Other).

Syntax

object.cpuClass

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

navigator


cssText

Description

Sets or returns the persisted representation of the style rule. If a string is returned, it will break out the composite properties into individual attributes.

Syntax

object.cssText[ = cssText]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style


ctrlKey

Description

Returns the state of the CTRL key, a Boolean value.

Syntax

object.ctrlKey

Settings

This read-only property is TRUE if the key is down, or FALSE otherwise.

Applies To

event


cursor

Description

Sets or retrieves the CSS cursor attribute, which specifies the type of cursor to display for the mouse pointer.

Syntax

object.cursor[ = cursor]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style

CSS Attribute

cursor


data

Description

Specifies a URL that references the object's data.

Syntax

object.data

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

OBJECT

See Also

type


dataFld

Description

Specifies which field of a given data source (as specified by the dataSrc property) to bind to the given element.

Syntax

object.dataFld

Remarks

The property can be set at run time. At design time it can be set through the DATAFLD attribute.

Examples

In the following example, the <OBJECT> with ID="sundae" has its Color property bound to the color column of the data source control. Similarly, the text box displays the flavor.

<TABLE DATASRC="#ice_cream">
    <TR> 
        <TD><INPUT TYPE=TEXTBOX DATAFLD=flavor>
<TD><OBJECT ID="sundae" WIDTH=100 HEIGHT=51
            CLASSID="CLSID:FFFFFFF-EEEE-DDDD-CCCC-BBBBBBBBBBBB">
            <PARAM NAME="Color" DATAFLD="color">
            <PARAM NAME="Appearance" VALUE="1">
        </OBJECT>
</TABLE>

In the following example the <SELECT> control is bound to the "card_type" column of the data source control "#order". The value of the field will result in the appropriate option being selected.

<SELECT DATASRC="#order" DATAFLD="card_type">
    <OPTION>Visa
    <OPTION>Mastercard
    <OPTION>American Express
    <OPTION>Diners Club
    <OPTION>Discover
</SELECT>

Applies To

A, APPLET, BODY, BUTTON, DIV, FRAME, IFRAME, IMG, INPUT, LABEL, MARQUEE, OBJECT, SELECT, SPAN, TEXTAREA


dataFormatAs

Description

Specifies how the data supplied to the element should be rendered.

Syntax

object.dataFormatAs

Remarks

The property can be set at run time. At design time it can be set through the dataFormatAs attribute. In Internet Explorer 4.0, the possible values for both the property and the corresponding HTML attribute are TEXT and HTML. TEXT is the default.

Examples

In the following DIV and SPAN examples, the data will be supplied in HTML format. In the TEXTAREA example, the data will be supplied in text format.

<DIV DATAFLD="Column2" DATAFORMATAS="html"></DIV>
<TEXTAREA DATASRC="#customer" DATAFLD="address" DATAFORMATAS="text" 
    ROWS=6 COLS=60>
</TEXTAREA>
<SPAN DATASRC="#bank_acct" DATAFLD="balance" DATAFORMATAS="none"></SPAN>

Applies To

BODY, BUTTON, DIV, INPUT type=button, LABEL, MARQUEE, SPAN


dataPageSize

Description

Sets the number of records displayed in a table bound to a data source.

Syntax

object.dataPageSize

Remarks

Use the nextPage and previousPage methods to display the subsequent and previous page of records in the table.

The property can be set at run time. At design time it can be set through the dataPageSize attribute.

Example

In the following example, the intrinsic text box is bound to the customer name of the current row of the data source control with the ID "#customer_source". The row in the table will be repeated 10 times, the value specified by DATAPAGESIZE.

<TABLE DATASRC="#customer_source" DATAPAGESIZE=10> 
    <TR>
        <TD><INPUT TYPE=TEXTBOX DATAFLD="customer_name">
</TABLE>

Applies To

TABLE


dataSrc

Description

Specifies the source of the data for databinding.

Syntax

object.dataSrc

Remarks

Both tabular and single-valued data consumers use the dataSrc property to specify a binding. The property takes a string that corresponds to the unique ID of a data source object (DSO) on the page.

When the dataSrc property is used for tabular data binding, it specifies that the entire contents of the table be repeated once for each record from the data set.

The dataSrc property can be inherited by the elements contained in a repeated TABLE. This behavior occurs when an element within a TABLE when that element only specifies a dataFld attribute. To complete the binding, the binding agent interrogates the enclosing TABLE for its data source. This inheritance behavior holds only for single-valued consumers. Tabular data consumers (TABLE) must specify an explicit dataSrc.

The property can be set at run time. At design time it can be set through the corresponding DATASRC attribute.

Example

In the following example, the intrinsic text box is bound to the customer name of the current row of the data source control with the ID "#customer_source", and the contents of the table, in this case <TR>, will be repeated once for each record in the set of tabular data.

<TABLE DATASRC="#customer_source"> 
    <TR>
        <TD><INPUT TYPE=TEXTBOX DATAFLD="customer_name">
</TABLE>

Applies To

A, APPLET, BODY BUTTON, DIV, FRAME, IFRAME, IMG, INPUT, LABEL, MARQUEE, OBJECT, SELECT, SPAN, TABLE, TEXTAREA


defaultCharset

Description

Sets or returns the default character set of the document.

Syntax

object.defaultCharset[ = defaultCharset]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

META, document


defaultChecked

Description

Determines whether the check box or radio button is selected by default.

Syntax

object.defaultChecked[ = defaultChecked]

Settings

This read-write property is TRUE if the check box or radio button is selected by default, or FALSE otherwise. The default value for this property is TRUE.

The property can be changed programmatically but has no affect on the appearance nor on how forms are submitted.

Applies To

INPUT

See Also

checked


defaultSelected

Description

Determines whether the option is selected by default.

Syntax

object.defaultSelected[ = defaultSelected]

Settings

This read-write property is TRUE if the option is selected by default, or FALSE otherwise. The default value for this property is TRUE.

The property can be changed programmatically but has no affect on the appearance nor on how forms are submitted. It does change the appearance of the selected option if the form is reset.

Applies To

OPTION

See Also

selected


defaultStatus

Description

For a window, reflects the default message displayed in the status bar at the bottom of the window.

Syntax

object.defaultStatus[ = defaultStatus]

Remarks

Do not confuse defaultStatus with status. The status property reflects a priority or transient message in the status bar, such as the message that appears when an onmouseover event occurs over an anchor.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

window


defaultValue

Description

Specifies the initial contents of a password or text control or the TEXTAREA element.

Syntax

object.defaultValue[ = defaultValue]

Settings

This read-write property takes a string value.

This value can be changed programmatically but has no affect on the appearance nor on how forms are submitted. It does change the initial value of the control when the form is reset.

Applies To

INPUT, TEXTAREA


Defer

Description

Indicates to the browser that there is no code in the script that needs to be executed at this time. When this occurs, the browser does not need to stop and wait for any code to execute and it can continue parsing the page. Using this property appropriately can improve the download performance of a page.

Syntax

object.defer

Applies To

Script


defer

Description

Indicates whether the script contains an inline executable function.

Syntax

object.defer

Applies To

SCRIPT


dialogArguments

Description

Returns the variable or array of variables passed into the modal dialog window.

Syntax

object.dialogArguments

Remarks

This property applies only to windows created using the showModalDialog method.

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

window


dialogHeight

Description

Returns the height of the dialog window.

Syntax

object.dialogHeight[ = dialogHeight]

Remarks

This property applies only to windows created using the showModalDialog method.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

window


dialogLeft

Description

Returns the left coordinate of the dialog window.

Syntax

object.dialogLeft[ = dialogLeft]

Remarks

This property applies only to windows created using the showModalDialog method.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

window


dialogTop

Description

Returns the top coordinate of the dialog window.

Syntax

object.dialogTop[ = dialogTop]

Remarks

This property applies only to windows created using the showModalDialog method.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

window


dialogWidth

Description

Returns the width of the dialog window.

Syntax

object.dialogWidth[ = dialogWidth]

Remarks

This property applies only to windows created using the showModalDialog method.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

window


direction

Description

Specifies which direction the text should scroll.

Syntax

object.direction[ = direction]

Settings

This read-write property can be one of these strings:

down The marquee scrolls down.
left The marquee scrolls left.
right The marquee scrolls right.
up The marquee scrolls up.

The default value is left, which means scrolling to the left from the right.

Applies To

MARQUEE


disabled

Description

Disables a control. The control appears greyed and does not respond to user input.

Syntax

object.disabled[ = disabled]

Remarks

The default value for this property is FALSE.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

APPLET, BUTTON, INPUT, LINK, SELECT, STYLE, TEXTAREA


disabled

Description

Returns FALSE for a style sheet that does not specify a title and that is not currently selected.

Syntax

object.disabled

Remarks

The value of this property can also change per media-dependent style sheets. The application of individual style sheets can be turned on and off dynamically. Note that the value of this property is also controlled by whether titled style sheets are applied.

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

styleSheet


display

Description

Sets or retrieves the CSS display attribute, which specifies whether an element is rendered. If set to "none", the element is not rendered. If set to "", the element is rendered. The default value is "".

Syntax

object.display[ = display]

Remarks

Although you can apply the display property to parts of a table (such as a TR or TD element), changing the property has no effect on those parts. However, you can dynamically control the rendering of the entire table by applying the property to the TABLE element.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style

CSS Attribute

display


domain

Description

Sets or returns the security domain of the document.

Syntax

object.domain[ = domain]

Settings

This read-write property initially returns the host name of the server the page is from. It can be assigned the domain suffix to allow sharing of pages across frames. For example, a page in one frame from home.microsoft.com and a page from www.microsoft.com would initially not be able to communicate with each other. However, by setting the domain property of both pages to the suffix, microsoft.com, both pages would be considered secure and now access is available between the pages.

Applies To

document


dynsrc

Description

Specifies the address of a video clip or VRML world to be displayed in the window. Stands for Dynamic Source.

Syntax

object.dynsrc[ = dynsrc]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

IMG


encoding

Description

Specifies the mime encoding for the form. This property corresponds to the HTML ENCTYPE= attribute.

Syntax

object.encoding[ = encoding]

Remarks

The default is "application/x-www-form-urlencoded". Internet Explorer 4.0 also recognizes "multipart/form-data", which with a POST method is required to submit a file upload to the server.

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

FORM

See Also

action


event

Description

Specifies the event the script is being written for.

Syntax

object.event

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

SCRIPT


expando

Description

Specifies whether arbitrary variables can be created within an object. Default is set to TRUE.

Syntax

object.expando[ = boolean]

Remarks

You can extend the properties on an object by creating arbitrary properties with values. For example, an author scripting in a case-sensitive language such as JScript can easily make the mistake when setting a property value. For instance, if the property value is "borderColor" and the author types the value "bordercolor = 'blue'", they author has just, in fact, created another property on the style object called "bordercolor" with the value 'blue'. If the author queries the value of the property, the value "blue" will be returned. However, the borders for the element will not turn blue.

Setting this property to FALSE on the document object will disallow the creation of arbitrary variables.

Applies To

document


face

Description

Sets the current font's typeface.

Syntax

object.face[ = face]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

BASEFONT, FONT

See Also

font


fgColor

Description

Sets or retrieves the foreground (text) color of the document.

Syntax

object.fgColor[ = color]

Settings

This read-write property can be set to any one of the color names or values given in Color Table. The default value for this property is typically black, but depends on the browser.

Applies To

document

See Also

color, text


fileCreatedDate

Description

Returns the date the file was created.

Syntax

object.fileCreatedDate

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

IMG


fileModifiedDate

Description

Returns the date the file was last modified.

Syntax

object.fileModifiedDate

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

IMG


fileSize

Description

Returns the file size.

Syntax

object.fileSize

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

IMG


fileUpdatedDate

Description

Returns the date the file was last updated.

Syntax

object.fileUpdatedDate

Remarks

This property has read-only permission, meaning you can retrieve its current value, but not change it.

Applies To

IMG


filter

Description

Sets or retrieves the CSS filter attribute, which specifies the filter or collection of filters for the element.

Syntax

object.filter[ = filter]

Settings

This read-write property takes a string specifying a filter and its parameters.

Applies To

BODY, IMG, map, style

CSS Attribute

filter


font

Description

Sets or retrieves the CSS font attribute, which specifies typeface name, weight, and other attributes of the font used for text in the element.

Syntax

object.font[ = font]

Settings

This read-write property is a string consisting of the current values, separated by spaces, of the fontWeight, fontVariant, fontSize, and fontFamily properties.

Setting this property also sets the component properties. In this case, the string must be a combination of valid values for the component properties, with no more than one value per property. If the string does not contain a value for a component property, that property remains unchanged.

Example

The following JScript example sets the font to a 12-point, serif typeface having a normal weight with all letters given in small capital letters.

var el = document.all.MyParagraph;
el.style.font = "normal small-caps 12pt serif";
    .
    .
    .
alert(el.font.style);

Applies To

style

CSS Attribute

font


fontFamily

Description

Returns the CSS font-family attribute, which specifies the typeface name of the font used for text in the element.

Syntax

object.fontFamily[ = fontFamily]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style

CSS Attribute

font-family


fontSize

Description

Returns the CSS font-size attribute, which specifies the size of the font used for text in the element.

Syntax

object.fontSize[ = fontSize]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style

CSS Attribute

font-size


fontSmoothingEnabled

Description

Indicates whether the user has selected the corresponding option through the browser options.

Syntax

object.fontSmoothingEnabled

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

screen


fontStyle

Description

Sets or returns the CSS font-style attribute.

Syntax

object.fontStyle[ = fontStyle]

Settings

italic
normal
oblique

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style

CSS Attribute

font-style


fontVariant

Description

Sets or returns the CSS font-variant attribute.

Syntax

object.fontVariant[ = fontVariant]

Settings

This read-write property can be set to one of these strings:

normal
small-caps

The default value for this property is normal.

Applies To

style

CSS Attribute

font-variant


fontWeight

Description

Sets or returns the CSS font-weight attribute.

Syntax

object.fontWeight[ = fontWeight]

Remarks

This property has read-write permissions, meaning you can change as well as retrieve its current value.

Applies To

style

CSS Attribute

font-weight

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.