Click to return to the Reusing Browser Technology home page    
IHTMLInputImage::get_lows...     IHTMLInputImage::get_onab...     IHTMLInputImage Interface    
Web Workshop  |  Reusing Browser Technology

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 code 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.

Windows CE

Windows CE Use version 2.12 and later
Minimum availability Internet Explorer 4.0

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 that specifies 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 code 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.

Windows CE

Windows CE Use version 2.12 and later
Minimum availability Internet Explorer 4.0


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.