###User Defined Function###
_IEDocInsertHTML

###Description###
Inserts HTML Text in or around an element.

###Syntax###
#include <IE.au3>
_IEDocInsertHTML ( ByRef $o_object, $s_string [, $s_where = "beforeend"] )


###Parameters###
@@ParamTable@@
$o_object
	Object variable pointing to a document element.
$s_string
	The string containing the HTML text to insert.
$s_where
	[optional] specifies the string insertion point
		"beforebegin" = Inserts string immediately before the object.
		"afterbegin" = Inserts string after the start of the object but before all other content in the object.
		"beforeend" = (Default) Inserts string immediately before the end of the object but after all other content in the object.
		"afterend" = Inserts string immediately after the end of the object.
@@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
	5 ($_IEStatus_InvalidValue) - Invalid Value
@extended:	Contains invalid parameter number
@@End@@


###Remarks###
The innerHTML, outerHTML, innerText and outerText features of <a href="_IEPropertySet.htm">_IEPropertySet()</a> can be used to dynamically manipulate inserted content.


###Related###
_IEDocInsertText, _IEPropertyGet, _IEPropertySet, _IEBodyReadHTML, _IEBodyWriteHTML, _IEDocReadHTML, _IEHeadInsertEventScript


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