IHTMLElement::setAttribute


		Contents Index Topic Contents
	Previous Topic: IHTMLElement Next Topic: IHTMLElement::getAttribute

IHTMLElement::setAttribute
HRESULT setAttribute(
    BSTR strAttributeName,
    VARIANT AttributeValue,
    VARIANT_BOOL fCaseSensitive
);
Sets the value of the given attribute. If the attribute is not already present, the method adds the attribute to the element and sets the value.

Returns S_OK if successful, or an error value otherwise.

strAttributeName
String specifying the name of the attribute to set.
AttributeValue
VARIANT structure containing a string, number, or Boolean value to assign to the attribute.
fCaseSensitive
Boolean value specifying whether to use a case-sensitive search to locate the attribute. If TRUE, the uppercase and lowercase letters in strAttributeName must match exactly those in the attribute name.

Be careful when spelling attribute names. If fCaseSensitive is TRUE and strAttributeName does not have the same uppercase and lowercase letters as the attribute, this method creates a new attribute.
If two or more attributes have the same name (differing only in uppercase and lowercase letters) and fCaseSensitive is FALSE, this method assigns values only to the first attribute (the first to be created with this name). All other attributes of the same name are ignored.
See also getAttribute

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