Java tutorial
/* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /* * This file is available under and governed by the GNU General Public * License version 2 only, as published by the Free Software Foundation. * However, the following notice accompanied the original version of this * file and, per its terms, should not be removed: * * Copyright (c) 2000 World Wide Web Consortium, * (Massachusetts Institute of Technology, Institut National de * Recherche en Informatique et en Automatique, Keio University). All * Rights Reserved. This program is distributed under the W3C's Software * Intellectual Property License. This program is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY; without even * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. * See W3C License http://www.w3.org/Consortium/Legal/ for more details. */ package org.w3c.dom.css; import org.w3c.dom.DOMException; import org.w3c.dom.stylesheets.StyleSheet; /** * The <code>CSSStyleSheet</code> interface is a concrete interface used to * represent a CSS style sheet i.e., a style sheet whose content type is * "text/css". * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>. * @since 1.4, DOM Level 2 */ public interface CSSStyleSheet extends StyleSheet { /** * If this style sheet comes from an <code>@import</code> rule, the * <code>ownerRule</code> attribute will contain the * <code>CSSImportRule</code>. In that case, the <code>ownerNode</code> * attribute in the <code>StyleSheet</code> interface will be * <code>null</code>. If the style sheet comes from an element or a * processing instruction, the <code>ownerRule</code> attribute will be * <code>null</code> and the <code>ownerNode</code> attribute will * contain the <code>Node</code>. */ public CSSRule getOwnerRule(); /** * The list of all CSS rules contained within the style sheet. This * includes both rule sets and at-rules. */ public CSSRuleList getCssRules(); /** * Used to insert a new rule into the style sheet. The new rule now * becomes part of the cascade. * @param rule The parsable text representing the rule. For rule sets * this contains both the selector and the style declaration. For * at-rules, this specifies both the at-identifier and the rule * content. * @param index The index within the style sheet's rule list of the rule * before which to insert the specified rule. If the specified index * is equal to the length of the style sheet's rule collection, the * rule will be added to the end of the style sheet. * @return The index within the style sheet's rule collection of the * newly inserted rule. * @exception DOMException * HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at the * specified index e.g. if an <code>@import</code> rule is inserted * after a standard rule set or other at-rule. * <br>INDEX_SIZE_ERR: Raised if the specified index is not a valid * insertion point. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is * readonly. * <br>SYNTAX_ERR: Raised if the specified rule has a syntax error and * is unparsable. */ public int insertRule(String rule, int index) throws DOMException; /** * Used to delete a rule from the style sheet. * @param index The index within the style sheet's rule list of the rule * to remove. * @exception DOMException * INDEX_SIZE_ERR: Raised if the specified index does not correspond to * a rule in the style sheet's rule list. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is * readonly. */ public void deleteRule(int index) throws DOMException; }