Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

HtmlElement::InsertAdjacentElement Method

Insert a new element into the Document Object Model (DOM).

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
HtmlElement^ InsertAdjacentElement(
	HtmlElementInsertionOrientation orient, 
	HtmlElement^ newElement
)

Parameters

orient
Type: System.Windows.Forms::HtmlElementInsertionOrientation

Where to insert this element in relation to the current element.

newElement
Type: System.Windows.Forms::HtmlElement

The new element to insert.

Return Value

Type: System.Windows.Forms::HtmlElement
The HtmlElement that was just inserted. If insertion failed, this will return nullptr.

Do not call this method until after the DocumentCompleted event on the WebBrowser control has occurred. Calling this method before then can result in an exception, as the document will not have finished loading.

Whether a value of HtmlElementInsertionOrientation is valid will depend on the type of the element. For example, AfterBegin is valid if the element is a DIV, but not if it is a SCRIPT or IMG element, neither of which can contain child elements.

The following code example inserts a DIV element into the top of every page that users view outside of the ADatum.com server. The example requires that your form contains a WebBrowser control named WebBrowser1. Your sample must also import the namespace System.Text.RegularExpressions.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft