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
013package org.w3c.dom.css;
014
015import 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 */
024public 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}