INPUT TYPE=file XHTML Element (Windows Embedded CE 6.0)

1/6/2010

The INPUT TYPE=file element creates a file upload element with a text box and Browse button.

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.

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 Embedded supports.

Attribute	Value	Description
ACCESSKEY	0…9, #, *	Gives access or focus to an active HTML element by using a keypad number.
CLASS		Associates the element with a CSS style.
DISABLED		Disables the element so that it appears dimmed and does not respond to user input.
ID		Uniquely identifies the element within a document.
NAME	String	Specifies the element name.
ONBLUR		Event that occurs when the element loses focus by the pointing device or by tabbing navigation.
ONCHANGE		Event that occurs when the element loses input focus and its value has been modified since gaining focus.
ONFOCUS		Event that occurs when the element receives focus by the pointing device or by tabbing navigation.
ONSELECT		Event that occurs when the element is selected.
READONLY		<?>
STYLE		Provides the definition of the CSS styles used for this element.
TABINDEX		Sets the order in which elements are tabbed to.
VALUE	String	Specifies the initial value for the file box.

The following table shows items that Internet Explorer Embedded supports.

Property	Type	Access	Comments
accessKey	string	Read/Write	Sets or retrieves the number associated with the accesskey attribute.
defaultValue	string	Read/Write	Sets or retrieves the initial value of the file object
disabled	boolean	Read/Write	Sets or retrieves the value that indicates whether the user can interact with the object.
form	object	Read	Retrieves a reference to the form that the object is embedded in.
maxLength	long	Read/Write	Sets or retrieves the maximum number of characters that the user can enter in a file control.
name	string	Read	Sets or retrieves the name of the input type=file object.
offsetHeight	Number	Read-only	Contains the height of the object in pixels, relative to the parent element.
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.
readOnly	boolean	Read/Write
size	long	Read	Sets or retrieves the size of the control.
type	string	Read	Always returns a file.
value	string	Read/Write	Sets or retrieves the value of the input type=file object.

The following table shows items that Internet Explorer Embedded supports.

Event	Comment
onblur	Occurs when an element loses focus either by the pointing device or by keypad navigation.
onchange	Occurs when the contents of the input type=file have changed and the user has committed the change (by leaving the input type=file control that has focus).
onfocus	Occurs when an element receives focus either by the pointing device or by keypad navigation.

The following table shows items that Internet Explorer Embedded supports.

Method	Arguments	Comments
blur		Syntax: `file.blur()` Causes the onblur event to fire.
focus		Syntax: `file.focus()` Sets focus to the checkbox.
getAttribute	option	Syntax: `vAttrValue=file.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.
select		Syntax: `file.select()` Selects the file input area and highlights it.

Windows Embedded CE

Windows Embedded CE 6.0 R3