FRAME XHTML Element

A version of this page is also available for

4/8/2010

The FRAME element specifies an individual frame within a FRAMESET. This is a block element and does not require 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, events and methods.

The following table shows items that Internet Explorer Mobile supports

Attribute	Value	Description
CLASS		Associates the element with a CSS style. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
ID		Uniquely identifies the element within a document. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
MARGINHEIGHT	1…#	Specifies the top and bottom margins for the contents of the frame. The default value for MARGINHEIGHT is 6.
MARGINWIDTH	1…#	Specifies the left and right margins for the contents of the frame. The default value for MARGINWIDTH is 6.
NAME	String	Specifies the name of the frame
SCROLLING		Specifies whether or not the user can scroll the frame.
	auto	The browser determines if scrollbars are necessary. This is the default setting.
	yes	The frame can be scrolled
	no	The frame cannot scroll.
SRC	URL	Specifies the URL to be loaded in the FRAME
STYLE		Provides the definition of the CSS styles used for this element. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.

The following table shows items that Internet Explorer Mobile supports.

Property	Type	Access	Comments
document	object	Read Only	Retrieves the Automation object of the active document, if any.
marginHeight	variant	Read Only	Sets or retrieves the top and bottom margin heights before displaying the text in a frame.
marginWidth	variant	Read Only	Sets or retrieves the left and right margin widths before displaying the text in a frame.
name	string	Read Only	Sets or retrieves the frame name.
noResize	boolean	Read Only	Sets or retrieves whether the user can resize the frame.
offsetHeight	Number	Read-only	Contains the height of the object in pixels, relative to the parent element.
offsetLeft	Number	Read-only	Contains the number of pixels from the left of the parent element.
offsetParent	String	Read-only	Contains a reference to the container object that defines the offsetTop and offsetLeft properties of the object.
offsetTop	Number	Read-only	Contains the number of pixels from the top of the parent element
offsetWidth	Number	Read-only	Contains the width of the object in pixels, relative to the parent element.
scrolling	string	Read Only	Sets or retrieves whether the frame can be scrolled.
src	string	Read Only	Sets or retrieves a URL to be loaded by the object.

This element has no associated events.

Method Arguments Description

Method	Arguments	Description
getAttribute	option	Syntax: `vAttrValue=frame.getAttribute(sAttrName[,iFlags])` Returns the value of the specified attribute. If the attribute is not present then a NULL is returned. sAttrName is a String containing the name of the attribute. iFlags is 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 sAttrName must exactly match those in the attribute name. 2 Returns the value exactly as it was set in script or in the source document.

getAttribute

option

Syntax:

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

Returns the value of the specified attribute. If the attribute is not present then a NULL is returned.
sAttrName is a String containing the name of the attribute.
iFlags is 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 sAttrName must exactly match those in the attribute name.

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

Windows Mobile

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