IHTMLInputImage::name Property

  • Article

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.