IHTMLEmbedElement

IHTMLEmbedElement


This interface provides access to the EMBED object.

IHTMLEmbedElement Methods
put_hidden   get_hidden   get_palette  
get_pluginspage   put_src   get_src  
put_units   get_units   put_name  
get_name   put_width   get_width  
put_height   get_height  

IHTMLEmbedElement::put_hidden

HRESULT put_hidden(
    BSTR v
);

Hides or shows the embedded element.

v
String specifying if the embedded element is hidden. TRUE hides the embedded element, and FALSE shows it.

See also get_hidden

IHTMLEmbedElement::get_hidden

HRESULT get_hidden(
    BSTR *p
);

Determines whether the embedded element is currently hidden or shown.

p
Address of a string variable that receives the status.

See also put_hidden

IHTMLEmbedElement::get_palette

HRESULT get_palette(
    BSTR *p
);

Retrieves the palette used for the embedded document.

p
Address of a string variable that receives the palette.

IHTMLEmbedElement::get_pluginspage

HRESULT get_pluginspage(
    BSTR *p
);

Retrieves the plug-ins supporting this embedded document.

p
Address of a string variable that receives the plug-ins.

IHTMLEmbedElement::put_src

HRESULT put_src(
    BSTR v
);

Sets the URL of the embedded document.

v
String specifying the URL.

See also get_src

IHTMLEmbedElement::get_src

HRESULT get_src(
    BSTR *p
);

Retrieves the URL of the embedded document.

p
Address of a string variable that receives the URL.

See also put_src

IHTMLEmbedElement::put_units

HRESULT put_units(
    BSTR v
);

Sets the units that the height and width are calculated in.

v
String value that contains the units. Can be either "pixels" or "ems".

See also get_units

IHTMLEmbedElement::get_units

HRESULT get_units(
    BSTR *p
);

Retrieves the current units used to caculate the height and width.

p
Address of a string variable that contains the unit type. Can be either "pixels" or "ems".

See also put_units

IHTMLEmbedElement::put_name

HRESULT put_name(
    BSTR v
);

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

v
String specifying the name. It can be the name of a window or frame, 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 top-most level.

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

IHTMLEmbedElement::get_name

HRESULT get_name(
    BSTR *p
);

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

p
Address of a string 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 top-most level.

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

IHTMLEmbedElement::put_width

HRESULT put_width(
    VARIANT v
);

Sets the calculated width of the element, in pixels.

v
VARIANT structure that contains a value specifying the width.

This property is an integer value. Although an HTML author can specify the width as a percentage, this property always specifies the width in pixels.

See also get_width

IHTMLEmbedElement::get_width

HRESULT get_width(
    VARIANT *p
);

Retrieves the calculated width of the element, in pixels.

p
Address of a VARIANT structure that receives the width.

This property is an integer value. Although an HTML author can specify the width as a percentage, this property always specifies the width in pixels.

See also put_width

IHTMLEmbedElement::put_height

HRESULT put_height(
    VARIANT v
);

Sets the calculated height of the element, in pixels.

v
VARIANT structure that contains the value specifying the height.

If the value of the corresponding HTML attribute was set using a percentage, this property specifies the height in pixels represented by that percentage.

See also get_height

IHTMLEmbedElement::get_height

HRESULT get_height(
    VARIANT *p
);

Retrieves the calculated height of the element, in pixels.

p
Address of a VARIANT structure that receives the height.

If the value of the corresponding HTML attribute was set using a percentage, this property specifies the height in pixels represented by that percentage.

See also put_height

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.