###User Defined Function###
_IEFormElementSetValue

###Description###
Set the value of a specified Form Element.

###Syntax###
#include <IE.au3>
_IEFormElementSetValue ( ByRef $o_object, $s_newvalue [, $f_fireEvent = 1] )


###Parameters###
@@ParamTable@@
$o_object
	Object variable of an InternetExplorer.Application, Form Element object
$s_newvalue
	The new value to be set into the Form Element
$f_fireEvent
	[optional] specifies whether to fire an OnChange event after changing value
		0 = Do not fire OnChange or OnClick event after setting value
		1 = (Default) fire OnChange and OnClick event after setting value
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	1.
Failure:	0 and sets the @error flag to non-zero.
@error:	2 ($_IEStatus_COMError) - COM Error in Object reference
	3 ($_IEStatus_InvalidDataType) - Invalid Data Type
	4 ($_IEStatus_InvalidObjectType) - Invalid Object Type
@extended:	Contains invalid parameter number
@@End@@


###Remarks###
While all Form Elements have a value, only text oriented elements use their value attribute in an obvious fashion (type text, textarea, hidden, password and file).
The value of other form elements does not affect what is displayed in the user interface, but rather the value that is returned by the element when it is selected or activated.

See <a href="_IEFormElementOptionSelect.htm">_IEFormElementOptionSelect()</a>, <a href="_IEFormElementCheckBoxSelect.htm">_IEFormElementCheckBoxSelect()</a>, <a href="_IEFormElementRadioSelect.htm">_IEFormElementRadioSelect()</a> and <a href="_IEFormImageClick.htm">_IEFormImageClick()</a> for more information.

Note: You cannot use <a href="_IEFormElementSetValue.htm">_IEFormElementSetValue()</a> to set the value of an INPUT TYPE=FILE element.  Browser security restrictions prevent this element from being scripted.  See the example below for a workaround.


###Related###
_IEFormElementGetValue, _IEFormElementGetCollection, _IEFormElementGetObjByName, _IEFormElementOptionSelect, _IEFormElementCheckBoxSelect, _IEFormElementRadioSelect


###Example###
@@IncludeExample@@
