IHTMLInputImage::get_name Method

Retrieves the name of the frame so it can be targeted from links in other documents.

Syntax

HRESULT get_name(
    BSTR *p
);

Parameters

p

Address of a variable that receives the window or frame name, or one of these values:

window_name	String that specifies a frame.
_blank	Loads the link into a new, unnamed window.
_parent	Loads the link over the parent. If the frame has no parent, this refers to _self.
_self	Replaces the page with the specified link.
_top	Loads the link at the topmost level.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The name property on the window comes from the FRAME definition. There is no other way to persist a window name in HTML.

See Also

put_name

IHTMLInputImage::put_name Method

---

Sets the name of the frame so it can be targeted from links in other documents.

Syntax

HRESULT put_name(
    BSTR v
);

Parameters

v

String specifying the name. Either a window name or frame can be specified, or one of the following values:

window_name	String that specifies a frame.
_blank	Loads the link into a new, unnamed window.
_parent	Loads the link over the parent. If the frame has no parent, this refers to _self.
_self	Replaces the page with the specified link.
_top	Loads the link at the topmost level.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The name property on the window comes from the FRAME definition. There is no other way to persist a window name in HTML.

See Also

get_name, IHTMLInputImage

Does this content meet your programming needs? Write us!

Back to top