Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The FRAMESETelement specifies a frameset consisting of 1 or more frames. This is a block element and requires a closing tag.

Using this Element

There are some common properties and collections that apply to all the elements of the document object model, see Common Properties, Methods and Collections for the HTML Elements in Internet Explorer Mobile.

This element can be used within a web page with attributes.

This element can be used within scripts where it will have properties, eventsand methods.

Attributes

The following table shows items that Internet Explorer Mobile supports.

Attribute Value Description

BORDER

0…#

Specifies the number of pixels to reserve as space between frames. If the value is less than 3, Internet Explorer Mobile uses the value of 3.

BORDERCOLOR

Special

Sets the table border color. Table border colors are disabled on grayscale devices, and borders are always black. See BODY BGCOLOR for the format and possible color names.

This attribute is equivalent to the CSS:

Copy Code
border-color: {color};

CLASS

 

Associates the element with a CSS style.

Note:
Supported only on Pocket PC for Windows Mobile 2003 and later.

COLS

 

Comma-separated values specifying frame width. Values are in pixels, a percentage of the available width, or the relative value width*. After allocating space for pixel and percentage width sized frames, the remaining space is divided between relative-sized frames.

ID

 

Uniquely identifies the element within a document.

Note:
Supported only on Pocket PC for Windows Mobile 2003 and later.

ONLOAD

 

An event that occurs when the frameset is loaded.

Note:
Supported only on Pocket PC 2002 and later.

ONUNLOAD

 

An event that occurs immediately before the frameset is unloaded.

Note:
Supported only on Pocket PC 2002 and later.

ROWS

Special

Comma-separated values specifying frame height. Values are in pixels, a percentage of the available width, or the relative value height*. After allocating space for pixel and percentage height sized frames, the remaining space is divided between relative-sized frames.

STYLE

 

Provides the definition of the CSS styles used for this element.

Note:
Supported only on Pocket PC for Windows Mobile 2003 and later.

Scripting Properties

The following table shows items that Internet Explorer Mobile supports.

Property Type Access Comments

border

variant

Read

Sets or retrieves the space between the frames, including the 3-D border.

borderColor

variant

Read

Sets or retrieves the border color of the object.

cols

long

Read

Sets or retrieves the frame widths of the object.

document

object

Read

Retrieves the HTML document in a given pop-up window.

name

string

Read

Sets or retrieves the frame name.

onload

function

Read/Write

 

onunload

function

Read/Write

 

rows

long

Read

Sets or retrieves the frame heights of the object.

Scripting Events

The following table shows items that Internet Explorer Mobile supports.

Event Comment

onload

This event fires when the frameset is loaded. The onload event will not fire if the user refreshes a page. For frames pages, the onload event does not fire until all frames in the frameset are loaded.

onunload

This event fires immediately before the frameset is unloaded.

Scripting Methods

The following table shows items that Internet Explorer Mobile supports.

Method Arguments Comments

getAttribute

option

Syntax:

vAttrValue=frameset.getAttribute(sAttrName[,iFlags])

  • Returns the value of the specified attribute. If the attribute is not present then a NULL is returned.

    sAttrNameis a String containing the name of the attribute.

    iFlagsis an integer that specifies one or more of the following:

    0 (Default) Performs a property search that is not case-sensitive, and returns an interpolated value if the property is found.

    1 Performs a case-sensitive property search. To find a match, the uppercase and lowercase letters in sAttrNamemust exactly match those in the attribute name.

    2 Returns the value exactly as it was set in script or in the source document.

Requirements

Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also