borderLeftStyle
Properties Reference

borderLeftStyle

Description

Returns the CSS border-left-style attribute, which specifies the style of the left border.

Syntax

object.borderLeftStyle[ = borderLeftStyle]

Remarks

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

Applies To

style

CSS Attribute

border-left-style


borderLeftWidth

Description

Returns the CSS border-left-width attribute, which specifies the width of the left border.

Syntax

object.borderLeftWidth[ = borderLeftWidth]

Remarks

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

Applies To

style

CSS Attribute

border-left-width


borderRight

Description

Returns the CSS border-right attribute, which specifies the color, style, and width of the right border.

Syntax

object.borderRight[ = borderRight]

Remarks

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

Applies To

style

CSS Attribute

border-right


borderRightColor

Description

Returns the CSS border-right-color attribute, which specifies the color of the right border. The color can be one of the color names or values given in Color Table.

Syntax

object.borderRightColor[ = color]

Remarks

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

Applies To

style

CSS Attribute

border-right-color


borderRightStyle

Description

Returns the CSS border-right-style attribute, which specifies the style of the right border.

Syntax

object.borderRightStyle[ = borderRightStyle]

Remarks

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

Applies To

style

CSS Attribute

border-right-style


borderRightWidth

Description

Returns the CSS border-right-width attribute, which specifies the width of the right border.

Syntax

object.borderRightWidth[ = borderRightWidth]

Remarks

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

Applies To

style

CSS Attribute

border-right-width


borderStyle

Description

Returns the CSS border-style attribute, which specifies the style of the left, right, top, and bottom borders.

Syntax

object.borderStyle[ = borderStyle]

Remarks

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

Applies To

style

CSS Attribute

border-style


borderTop

Description

Returns the CSS border-top attribute, which specifies the color, style, and width of the top border.

Syntax

object.borderTop[ = borderTop]

Remarks

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

Applies To

style

CSS Attribute

border-top


borderTopColor

Description

Returns the CSS border-top-color attribute, which specifies the color of the top border. The color can be one of the color names or values given in Color Table.

Syntax

object.borderTopColor[ = color]

Remarks

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

Applies To

style

CSS Attribute

border-top-color


borderTopStyle

Description

Returns the CSS border-top-style attribute, which specifies the style of the top border.

Syntax

object.borderTopStyle[ = borderTopStyle]

Remarks

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

Applies To

style

CSS Attribute

border-top-style


borderTopWidth

Description

Returns the CSS border-top-width attribute, which specifies the width of the top border.

Syntax

object.borderTopWidth[ = borderTopWidth]

Remarks

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

Applies To

style

CSS Attribute

border-top-width


borderWidth

Description

Returns the CSS border-width attribute, which specifies the width of the left, right, top, and bottom border.

Syntax

object.borderWidth[ = borderWidth]

Remarks

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

Applies To

style

CSS Attribute

border-width


bottomMargin

Description

Specifies the bottom margin for the entire body of the page and overrides the default margin.

Syntax

object.bottomMargin[ = bottomMargin]

Settings

This read-write property takes a string representation of a decimal number. If set to "", the bottom margin will be exactly on the bottom edge.

Applies To

BODY


browserLanguage

Description

Indicates the current browser language. For possible return values, see Language Codes.

Syntax

object.browserLanguage

Remarks

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

Applies To

navigator


bufferDepth

Description

Specifies an offscreen bitmap buffer.

Syntax

object.bufferDepth[ = bufferDepth]

Settings

This read-write property can have these values:

0
No explicit buffering. The colorDepth property is set to the screen depth.
-1
Perform buffering at the screen depth. colorDepth is set to the screen depth.
1, 4, 8, 15, 16, 24, or 32
Perform buffering using the given bits-per-pixel. colorDepth is also set to this value. The value 15 specifies 16 bits-per-pixel, in which only 15 bits are used in a 5-5-5 layout of RGB values.

Nonsupported values cause bufferDepth to be set to -1.

When bufferDepth is -1 and the user changes system settings that affect the screen depth, the buffer depth is automatically updated to the new depth. This is not the case if you set bufferDepth to a specific value.

Applies To

screen


button

Description

Specifies which mouse button, if any, is pressed.

Syntax

object.button

Settings

This read-only property has one of these values:

0 No button.
1 Left button is pressed.
2 Right button is pressed.
4 Middle button is pressed.

This property is intended to be used with the onmousedown, onmouseup, and onmousemove events. For other events, it typically is zero regardless of the state of the mouse buttons.

Applies To

event


cancelBubble

Description

Specifies whether the current event should bubble up the hierarchy of event handlers.

Syntax

object.cancelBubble[ = cancelBubble]

Settings

This read-write property takes a Boolean value:

TRUE Cancels bubbling for this event, preventing the next event handler in the hierarchy from receiving the event.
FALSE Enables bubbling. This is the default value.

Using this property to cancel bubbling for an event does not affect subsequent events.

Example

The following document fragment cancels bubbling of the onclick event if it occurs in the IMG element when the SHIFT key is down. This prevents the event from bubbling up to the onclick event handler for the document.

<SCRIPT LANGUAGE="JScript">
function checkCancel() {
if (window.event.shiftKey)
    window.event.cancelBubble = true;
}
function showSrc() {
    if (window.event.srcElement.tagName == "IMG")
        alert(window.event.srcElement.src);
}
</SCRIPT>
<BODY onclick="showSrc()">
<IMG onclick="checkCancel()" SRC="sample.gif">

Applies To

event


caption

Description

Points to the CAPTION element in the TABLE. If none exist, it is null.

Syntax

object.caption[ = element]

Return Value

This property has read-only permission.

Remarks

The following example sets the inline style for the CAPTION.

document.all.myTable.caption.style.color = "blue" 

Applies To

table


cellIndex

Description

Indicates the element's position in the cells collection of a given row. Collection indexes are in the source order of the HTML document. Note that when a cell spans multiple rows, that cell only appears in the cells collection for the first of the rows that the cell spans.

Syntax

object.cellIndex[ = element]

Return Value

This property has read-only permission.

Applies To

TD

See Also

sectionRowIndex, sourceIndex, rowIndex


cellPadding

Description

Specifies the amount of space between the border of the cell and the content of the cell.

Syntax

object.cellPadding[ = cellPadding]

Remarks

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

Applies To

TABLE

See Also

cellSpacing


cellSpacing

Description

Specifies the amount of space between cells in a table.

Syntax

object.cellSpacing[ = cellSpacing]

Remarks

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

Applies To

TABLE

See Also

cellPadding


charset

Description

Sets or returns the character set of the document.

Syntax

object.charset[ = charset]

Remarks

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

Applies To

document, META


checked

Description

Specifies whether the given check box or radio button is selected.

Syntax

object.checked[ = checked]

Settings

This read-write property takes a Boolean value. It is TRUE if the control is selected, or FALSE otherwise. The default value for this property is FALSE.

Check boxes that are not selected do not return their values when the form is submitted.

Applies To

INPUT

See Also

defaultChecked


classid

Description

Specifies the class identifier for the object.

Syntax

object.classid

Remarks

The format is: classid="clsid:controlspecificclsid "

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

Applies To

OBJECT


className

Description

Specifies the class of the given element. The class is typically used to associate a particular style rule in a style sheet with the element.

Syntax

object.className[ = className]

Settings

This read-write property takes any valid string. By default, the property is equal to the string assigned to the CLASS= attribute of the given element, or is an empty string if the attribute is not explicitly assigned.

Applies To

A, ACRONYM, ADDRESS, APPLET, AREA, B, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, H1, H2, H3, H4, H5, H6, HEAD, HR, I, IFRAME, IMG, INPUT, INS, KBD, LABEL, LEGEND, LI, LISTING, MAP, MARQUEE, MENU, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, S, SAMP, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, XMP


clear

Description

Returns the CSS clear attribute, which specifies whether the element allows floating elements on its left and/or right sides.

Syntax

object.clear[ = clear]

Remarks

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

Applies To

style

CSS Attribute

clear


clear

Description

Inserts vertical space so that the next text displayed will be past left-aligned or right-aligned floating images.

Syntax

object.clear[ = clear]

Settings

Possible values include:
all
left
right

Remarks

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

Applies To

BR


clientHeight

Description

Returns the height of the element, in pixels. This height does not take into account any margin, border, scroll bar, or padding that might have been applied to the element.

Syntax

object.clientHeight

Remarks

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

For more information on how to access the dimension and location of elements on the page through the document object model, see Measuring Element Dimension and Location.

Applies To

APPLET, BODY, BUTTON, CAPTION, DIV, EMBED, FIELDSET, IMG, INPUT, LEGEND, MARQUEE, OBJECT, SPAN, TABLE, TD, TEXTAREA, TR


clientInformation

Description

Returns the navigator object. You use this to retrieve information about the version and name of the browser, as well as whether certain features are enabled.

Syntax

object.clientInformation

Examples

The following JScript example checks whether the user agent name of the browser contains "MSIE". If it does, the browser is Microsoft® Internet Explorer.

if (window.clientInformation.userAgent.indexOf( "MSIE " ) > 0)
    // is Microsoft Internet Explorer

The following JScript example checks whether Java™ applets can be run.

if (window.clientInformation.javaEnabled() == true )
    // Java is enabled, applets can run

Applies To

window


clientLeft

Description

Returns the distance between the offsetLeft and the true left side of the client area, in pixels. The difference between the offsetLeft and clientLeft is the border of the element.

Syntax

object.clientLeft

Remarks

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

For more information on how to access the dimension and location of elements on the page through the document object model, see Measuring Element Dimension and Location.

Applies To

APPLET, BODY, BUTTON, CAPTION, DIV, EMBED, FIELDSET, IMG, INPUT, LEGEND, MARQUEE, OBJECT, SPAN, TABLE, TD, TEXTAREA, TR


clientTop

Description

Returns the distance between the offsetTop and the true top of the client area, in pixels. The difference between the offsetTop and the clientTop is the border area of the element.

Syntax

object.clientTop

Remarks

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

For more information on how to access the dimension and location of elements on the page through the document object model, see Measuring Element Dimension and Location.

Applies To

APPLET, BODY, BUTTON, CAPTION, DIV, EMBED, FIELDSET, IMG, INPUT, LEGEND, MARQUEE, OBJECT, SPAN, TABLE, TD, TEXTAREA, TR


clientWidth

Description

Returns the width of the element, in pixels. This width does not take into account any margin, border, scroll bar, or padding that might have been applied to the element.

Syntax

object.clientWidth

Remarks

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

For more information on how to access the dimension and location of elements on the page through the document object model, see Measuring Element Dimension and Location.

Applies To

APPLET, BODY, BUTTON, CAPTION, DIV, EMBED, FIELDSET, IMG, INPUT, LEGEND, MARQUEE, OBJECT, SPAN, TABLE, TD, TEXTAREA, TR


clientX

Description

Returns the position of the mouse hit relative to the size of the client area of the window. This does not include window decorations or scroll bars.

Syntax

object.clientX

Remarks

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

Applies To

event


clientY

Description

Returns the position of the mouse hit relative to the size of the client area of the window. This does not include window decorations or scroll bars.

Syntax

object.clientY

Remarks

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

Applies To

event


clip

Description

Returns the CSS clip attribute, which specifies which part of the element is visible.

Syntax

object.clip[ = clip]

Remarks

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

Applies To

style

CSS Attribute

clip


closed

Description

Returns whether the referenced window is closed.

Syntax

object.closed

Settings

This read-only property is TRUE if the window is closed, or FALSE otherwise.

Applies To

window


code

Description

Specifies the name of the file containing the compiled Java class.

Syntax

object.code

Remarks

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

Applies To

OBJECT


codeBase

Description

Specifies a URL referencing where to find the implementation of the object.

Syntax

object.codeBase

Remarks

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

Applies To

OBJECT


codeBase

Description

Specifies the base URL for the application. This is an optional parameter.

Syntax

object.codeBase

Remarks

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

Applies To

APPLET, EMBED


codeType

Description

Specifies the Internet media type for the code associated with the object.

Syntax

object.codeType[ = codeType]

Remarks

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

Applies To

OBJECT


color

Description

Sets the color to be used by the font or horizontal rule. The color can be one of the color names or values given in Color Table.

Syntax

object.color[ = color]

Remarks

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

Applies To

BASEFONT, FONT, HR


color

Description

Sets or retrieves the CSS color attribute of the element. The color can be one of the color names or values given in Color Table.

Syntax

object.color[ = color]

Remarks

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

Applies To

style

CSS Attribute

color


colorDepth

Description

Returns the bits-per-pixel value used for colors on the destination device or buffer. Script programmers use this value when deciding how best to use colors.

Syntax

object.colorDepth

Settings

The value of this read-only property depends on the bufferDepth property. If bufferDepth is 0 or -1, colorDepth is equal to the bits-per-pixel value for the screen or printer. If bufferDepth is nonzero, colorDepth is equal to bufferDepth.

Example

The following JScript example picks foreground and background colors based on the color depth of the screen.

if (screen.colorDepth > 2) {
    document.body.bgColor = "white";
    document.body.color = "blue";
} else {
    document.body.bgColor = "black";
    document.body.color = "white";
}

Applies To

screen


cols

Description

Specifies how many characters wide the text area is.

Syntax

object.cols[ = cols]

Remarks

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

Applies To

TEXTAREA


cols

Description

Specifies the number of columns in the table.

Syntax

object.cols[ = cols]

Remarks

Providing this number can speed up the processing of the table.

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

Applies To

TABLE


cols

Description

Specifies a comma-delimited list of frames to create. Each item in the list contains the initial size of the column.

Syntax

object.cols[ = cols]

Remarks

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

Applies To

FRAMESET

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