001    /*
002     * Copyright (c) 2000 World Wide Web Consortium,
003     * (Massachusetts Institute of Technology, Institut National de
004     * Recherche en Informatique et en Automatique, Keio University). All
005     * Rights Reserved. This program is distributed under the W3C's Software
006     * Intellectual Property License. This program is distributed in the
007     * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
008     * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
009     * PURPOSE.
010     * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
011     */
012    
013    package org.w3c.dom.css;
014    
015    import org.w3c.dom.DOMException;
016    
017    /**
018     *  The <code>CSSPageRule</code> interface represents a @page rule within a
019     * CSS style sheet. The <code>@page</code> rule is used to specify the
020     * dimensions, orientation, margins, etc. of a page box for paged media.
021     * <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>.
022     * @since DOM Level 2
023     */
024    public interface CSSPageRule extends CSSRule {
025        /**
026         *  The parsable textual representation of the page selector for the rule.
027         */
028        public String getSelectorText();
029        /**
030         *  The parsable textual representation of the page selector for the rule.
031         * @exception DOMException
032         *   SYNTAX_ERR: Raised if the specified CSS string value has a syntax
033         *   error and is unparsable.
034         *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly.
035         */
036        public void setSelectorText(String selectorText)
037                               throws DOMException;
038    
039        /**
040         *  The declaration-block of this rule.
041         */
042        public CSSStyleDeclaration getStyle();
043    
044    }