content Property (IHTMLMetaElement)

content Property

IHTMLMetaElement::content Property

Sets or retrieves meta-information to associate with IHTMLMetaElement::httpEquiv or IHTMLMetaElement::name.

Syntax

HRESULT IHTMLMetaElement::get_content(BSTR *p);
HRESULT IHTMLMetaElement::put_content(BSTR v);

Parameters

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

Possible Values

description Meta-information.
refresh Integer consisting of the number of seconds to elapse before the document is refreshed. This value requires the IHTMLMetaElement::httpEquiv to be set with the refresh value.
url Location that is loaded when the document is refreshed. This value requires the IHTMLMetaElement::httpEquiv to be set with the refresh value.
mimetype MIME type used for the charset value.
charset Character set of the document. This value requires the mimetype value to be set with a valid MIME type, and the IHTMLMetaElement::httpEquiv to be set with the refresh value.
noopen Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2) and later. Hides the Open or Run button on the File Download dialog box. This value requires the IHTMLMetaElement::name attribute to be set with the DownloadOptions value.
nosave Internet Explorer 6 for Windows XP SP2 and later. Hides the Save button on the File Download dialog box. This value requires the IHTMLMetaElement::name attribute to be set with the DownloadOptions value.
x-ua-compatible Windows Internet Explorer 8 and later. A semi-colon delimited list of document compatibility modes supported by the Web page. This value requires the IHTMLMetaElement::httpEquiv to be set with the x-ua-compatible value.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Developers using the httpEquiv and content attributes to refresh web pages from alternate URL's should treat the value of content as untrusted data. For more information, please see Security Considerations: Dynamic HTML.

As of Internet Explorer 8, httpEquiv also supports a value of x-ua-compatible, which allows content to specify the document compatibility modes supported by a Web page, using a string containing one or more of the following values.
Value Description
IE=8 Web page supports IE8 mode, which is also called "IE8 standards mode."
IE=7 Web page supports IE7 mode, which is also called "IE7 standards mode."
IE=5 Web page supports IE5 mode, which is also called "quirks mode."
IE=EmulateIE8 If the Web page specifies a standards-based DOCTYPE directive, the page supports IE8 mode; otherwise, it supports IE5 mode ("quirks mode").
IE=EmulateIE7 If the Web page specifies a standards-based DOCTYPE directive, the page supports IE7 mode; otherwise, it supports IE5 mode ("quirks mode").
IE=Edge Web page supports the highest mode available to the version of Internet Explorer used to display the page. This option is generally intended for testing purposes.
Internet Explorer displays the page in the highest mode supported by the page. For more information, see Defining Document Compatibility.

description	Meta-information.
refresh	Integer consisting of the number of seconds to elapse before the document is refreshed. This value requires the IHTMLMetaElement::httpEquiv to be set with the `refresh` value.
url	Location that is loaded when the document is refreshed. This value requires the IHTMLMetaElement::httpEquiv to be set with the `refresh` value.
mimetype	MIME type used for the charset value.
charset	Character set of the document. This value requires the mimetype value to be set with a valid MIME type, and the IHTMLMetaElement::httpEquiv to be set with the `refresh` value.
noopen	Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2) and later. Hides the Open or Run button on the File Download dialog box. This value requires the IHTMLMetaElement::name attribute to be set with the `DownloadOptions` value.
nosave	Internet Explorer 6 for Windows XP SP2 and later. Hides the Save button on the File Download dialog box. This value requires the IHTMLMetaElement::name attribute to be set with the `DownloadOptions` value.
x-ua-compatible	Windows Internet Explorer 8 and later. A semi-colon delimited list of document compatibility modes supported by the Web page. This value requires the IHTMLMetaElement::httpEquiv to be set with the `x-ua-compatible` value.

Value	Description
`IE=8`	Web page supports IE8 mode, which is also called "IE8 standards mode."
`IE=7`	Web page supports IE7 mode, which is also called "IE7 standards mode."
`IE=5`	Web page supports IE5 mode, which is also called "quirks mode."
`IE=EmulateIE8`	If the Web page specifies a standards-based DOCTYPE directive, the page supports IE8 mode; otherwise, it supports IE5 mode ("quirks mode").
`IE=EmulateIE7`	If the Web page specifies a standards-based DOCTYPE directive, the page supports IE7 mode; otherwise, it supports IE5 mode ("quirks mode").
`IE=Edge`	Web page supports the highest mode available to the version of Internet Explorer used to display the page. This option is generally intended for testing purposes.