target property

[This documentation is preliminary and is subject to change.]

Sets or retrieves the window or frame at which to target content.

Syntax

HRESULT value = object.put_target(BSTR v);HRESULT value = object.get_target(BSTR* p);

Property values

Type: BSTR

name

The name of the target window or frame.

_blank

Load the linked document into a new blank window. This window is not named.

_media

Disabled in Windows XP SP2 and later versions; otherwise, loads the linked document into the HTML content area of the Media Bar. Available in Internet Explorer 6.

_parent

Load the linked document into the immediate parent of the document the link is in.

_search

Disabled in Internet Explorer 7, see Security and Compatibility in Internet Explorer 7 for details. Otherwise, loads the linked document into the browser search pane in Internet Explorer 5 or later.

_self

Default. Load the linked document into the window in which the link was clicked (the active window).

_top

Load the linked document into the topmost window.

Remarks

If there is no existing window or frame with the same name as specified in the IHTMLAnchorElement::target, a new window is opened with a name equal to the value of the IHTMLAnchorElement::target.

Windows Internet Explorer 8 and later. When Protected Mode is enabled and a webpage contains an anchor link with a named IHTMLAnchorElement::target, Windows Internet Explorer opens the target of the link in a new window when the target has a different integrity level than the webpage containing the link. For more information, see Understanding and Working in Protected Mode Internet Explorer.

In Internet Explorer 6, the value of the IHTMLAnchorElement::target parameter of this property specifies that a linked document loads in the content area of the IHTMLAnchorElement::target.

Metro style apps using JavaScript do not have multiple windows. To open a document within a new window by using TARGET = "new_identifier", the new identifier must identify an existing frame within the window.

 

 

Build date: 6/12/2012