IHTMLInputImage::name Property

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

Syntax


HRESULT IHTMLInputImage::get_name(BSTR *p);HRESULT IHTMLInputImage::put_name(BSTR v);

Parameters

p
Pointer to a variable of type BSTR that receives the window or frame name, or one of the values listed in Possible Values.
v
BSTR that specifies the window or frame name, or one of the values listed in Possible Values.

Possible Values

_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.
window_name String that specifies a frame.

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.

Show: