insertRule method

Inserts a new rule into the style sheet.

Syntax

 retVal = object.insertRule(bstrRule, lIndex);

Parameters

• bstrRule [in]
  Type: BSTR

  The text that represents the rule, which must be able to be parsed. For rule sets, this specifies both the selector and the style declaration. For at-rules, this specifies both the at-identifier ("@rule_name") and the rule content.

• lIndex [in]
  Type: long

  The index within the style sheet's rule list of the rule before which to insert the specified rule. If the specified index equals the length of the style sheet's rule list, the rule will be added to the end of the style sheet.

Standards information

• Document Object Model (DOM) Level 2 Style Specification, Section 2.2

Remarks

After the new rule has been inserted, it becomes part of the cascade.

See also

Reference

IHTMLStyleSheet4::cssRules

IHTMLStyleSheet4::deleteRule