LinkElement2::get_target Method

---

Retrieves the target window or frame.

Syntax

HRESULT get_target(
    BSTR *p
);

Parameters

p

Address of a string variable that contains the target window or frame. It can be one of the following values:

_blank	Specifies to load the link into a new blank window. This window is not named.
_parent	Specifies to load the link into the immediate parent of the document the link is in.
_self	Specifies to load the link into the same window the link was clicked in.
_top	Specifies to load the link into the full body of the window.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The default value for the target depends upon the URL and site. If the user does not leave the site, the default is _self, but if the user exits to a new site, the default is _top.

LinkElement2::put_target Method

---

Sets the window or frame to target.

Syntax

HRESULT put_target(
    BSTR v
);

Parameters

v

String that specifies the target window or frame. It can be one of the following values:

_blank	Specifies to load the link into a new blank window. This window is not named.
_parent	Specifies to load the link into the immediate parent of the document the link is in.
_self	Specifies to load the link into the same window the link was clicked in.
_top	Specifies to load the link into the full body of the window.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

If there is no frame or window that matches the specified target, a new window is opened for the link.

The default value for the target depends upon the URL and site. If the user does not leave the site, the default is _self, but if the user exits to a new site, the default is _top.