diff options
Diffstat (limited to 'khtml/dom/css_stylesheet.h')
| -rw-r--r-- | khtml/dom/css_stylesheet.h | 496 |
1 files changed, 0 insertions, 496 deletions
diff --git a/khtml/dom/css_stylesheet.h b/khtml/dom/css_stylesheet.h deleted file mode 100644 index d220ffa76..000000000 --- a/khtml/dom/css_stylesheet.h +++ /dev/null @@ -1,496 +0,0 @@ -/* - * This file is part of the DOM implementation for KDE. - * - * (C) 1999 Lars Knoll (knoll@kde.org) - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Library General Public - * License as published by the Free Software Foundation; either - * version 2 of the License, or (at your option) any later version. - * - * This library 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 - * Library General Public License for more details. - * - * You should have received a copy of the GNU Library General Public License - * along with this library; see the file COPYING.LIB. If not, write to - * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - * Boston, MA 02110-1301, USA. - * - * This file includes excerpts from the Document Object Model (DOM) - * Level 2 Specification (Candidate Recommendation) - * http://www.w3.org/TR/2000/CR-DOM-Level-2-20000510/ - * Copyright © 2000 W3C® (MIT, INRIA, Keio), All Rights Reserved. - * - */ -#ifndef _CSS_css_stylesheet_h_ -#define _CSS_css_stylesheet_h_ - -#include <dom/dom_string.h> -#include <dom/dom_node.h> -#include <dom/dom_misc.h> - -#include <tdelibs_export.h> - -namespace DOM { - -class StyleSheetImpl; -class MediaList; -class NodeImpl; -class DocumentImpl; - -/** - * The \c StyleSheet interface is the abstract base - * interface for any type of style sheet. It represents a single style - * sheet associated with a structured document. In HTML, the - * StyleSheet interface represents either an external style sheet, - * included via the HTML <a - * href="http://www.w3.org/TR/REC-html40/struct/links.html#h-12.3"> - * LINK </a> element, or an inline <a - * href="http://www.w3.org/TR/REC-html40/present/styles.html#h-14.2.3"> - * STYLE </a> element. In XML, this interface represents an external - * style sheet, included via a <a - * href="http://www.w3.org/TR/xml-stylesheet"> style sheet processing - * instruction </a> . - * - */ -class KHTML_EXPORT StyleSheet -{ -public: - StyleSheet(); - StyleSheet(const StyleSheet &other); - StyleSheet(StyleSheetImpl *impl); -public: - - StyleSheet & operator = (const StyleSheet &other); - - ~StyleSheet(); - - /** - * This specifies the style sheet language for this style sheet. - * The style sheet language is specified as a content type (e.g. - * "text/css"). The content type is often specified in the - * \c ownerNode . A list of registered content types can be - * found at <a - * href="ftp://ftp.isi.edu/in-notes/iana/assignments/media-types/"> - * ftp://ftp.isi.edu/in-notes/iana/assignments/media-types/ </a> . - * Also see the <a - * href="http://www.w3.org/TR/REC-html40/struct/links.html#adef-type-A"> - * type attribute definition </a> for the \c LINK - * element in HTML 4.0, and the type pseudo-attribute for the XML - * <a href="http://www.w3.org/TR/xml-stylesheet"> style sheet - * processing instruction </a> . - * - */ - DOM::DOMString type() const; - - /** - * \c false if the style sheet is applied to the - * document. \c true if it is not. Modifying this - * attribute may cause a reresolution of style for the document. - * - */ - bool disabled() const; - - /** - * see disabled - */ - void setDisabled( bool ); - - /** - * The node that associates this style sheet with the document. - * For HTML, this may be the corresponding \c LINK or - * \c STYLE element. For XML, it may be the linking - * processing instruction. For style sheets that are included by - * other style sheets, this attribute has a value of null. - * - */ - DOM::Node ownerNode() const; - - /** - * For style sheet languages that support the concept of style - * sheet inclusion, this attribute represents the including style - * sheet, if one exists. If the style sheet is a top-level style - * sheet, or the style sheet language does not support inclusion, - * the value of the attribute is null. - * - */ - StyleSheet parentStyleSheet() const; - - /** - * If the style sheet is a linked style sheet, the value of its - * attribute is its location. For inline style sheets, the value - * of this attribute is null. See the <a - * href="http://www.w3.org/TR/REC-html40/struct/links.html#adef-href"> - * href attribute definition </a> for the \c LINK - * element in HTML 4.0, and the href pseudo-attribute for the XML - * <a href="http://www.w3.org/TR/xml-stylesheet"> style sheet - * processing instruction </a> . - * - */ - DOM::DOMString href() const; - - /** - * The advisory title. The title is often specified in the - * \c ownerNode . See the <a - * href="http://www.w3.org/TR/REC-html40/struct/global.html#adef-title"> - * title attribute definition </a> for the \c LINK - * element in HTML 4.0, and the title pseudo-attribute for the XML - * <a href="http://www.w3.org/TR/xml-stylesheet"> style sheet - * processing instruction </a> . - * - */ - DOM::DOMString title() const; - - /** - * The intended destination media for style information. The media - * is often specified in the \c ownerNode . See the <a - * href="http://www.w3.org/TR/REC-html40/present/styles.html#adef-media"> - * media attribute definition </a> for the \c LINK - * element in HTML 4.0, and the media pseudo-attribute for the XML - * <a href="http://www.w3.org/TR/WD-xml-stylesheet"> style sheet - * processing instruction </a> . - * - */ - MediaList media() const; - - /** - * @internal - */ - bool isCSSStyleSheet() const; - StyleSheetImpl *handle() const { return impl; } - bool isNull() const { return !impl; } -protected: - StyleSheetImpl *impl; -}; - - -/** - * This exception is raised when a specific CSS operation is impossible - * to perform. - */ -class KHTML_EXPORT CSSException -{ -public: - CSSException(unsigned short _code) { code = _code; } - CSSException(const CSSException &other) { code = other.code; } - - CSSException & operator = (const CSSException &other) - { code = other.code; return *this; } - - virtual ~CSSException() {} - /** - * An integer indicating the type of error generated. - * - */ - unsigned short code; - - enum ExceptionCode - { - SYNTAX_ERR = 0, - INVALID_MODIFICATION_ERR = 1, - _EXCEPTION_OFFSET = 1000 - }; -}; - -class CSSStyleSheetImpl; -class CSSRule; -class CSSRuleList; - -/** - * The \c CSSStyleSheet interface is a concrete interface - * used to represent a CSS style sheet i.e. a style sheet whose - * content type is "text/css". - * - */ -class KHTML_EXPORT CSSStyleSheet : public StyleSheet -{ -public: - CSSStyleSheet(); - CSSStyleSheet(const CSSStyleSheet &other); - CSSStyleSheet(const StyleSheet &other); - CSSStyleSheet(CSSStyleSheetImpl *impl); -public: - - CSSStyleSheet & operator = (const CSSStyleSheet &other); - CSSStyleSheet & operator = (const StyleSheet &other); - - ~CSSStyleSheet(); - - /** - * If this style sheet comes from an \c \@import rule, - * the \c ownerRule attribute will contain the - * \c CSSImportRule . In that case, the \c ownerNode - * attribute in the \c StyleSheet interface - * will be \c null . If the style sheet comes from an - * element or a processing instruction, the \c ownerRule - * attribute will be \c null and the - * \c ownerNode attribute will contain the \c Node . - * - */ - CSSRule ownerRule() const; - - /** - * The list of all CSS rules contained within the style sheet. - * This includes both <a - * href="http://www.w3.org/TR/REC-CSS2/syndata.html#q8"> rule sets - * </a> and <a - * href="http://www.w3.org/TR/REC-CSS2/syndata.html#at-rules"> - * at-rules </a> . - * - */ - CSSRuleList cssRules() const; - - /** - * 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 \c \@import rule is - * inserted after a standard rule set or other at-rule. - * - * INDEX_SIZE_ERR: Raised if the specified index is not a valid - * insertion point. - * - * NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is - * readonly. - * - * @exception CSSException - * SYNTAX_ERR: Raised if the specified rule has a syntax error - * and is unparsable. - * - */ - unsigned long insertRule ( const DOM::DOMString &rule, unsigned long index ); - - /** - * 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. - * - * @return - * - * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index does not - * correspond to a rule in the style sheet's rule list. - * - * NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is - * readonly. - * - */ - void deleteRule ( unsigned long index ); -}; - - -class StyleSheetListImpl; -class StyleSheet; - -/** - * The \c StyleSheetList interface provides the - * abstraction of an ordered collection of style sheets. - * - */ -class KHTML_EXPORT StyleSheetList -{ -public: - StyleSheetList(); - StyleSheetList(const StyleSheetList &other); - StyleSheetList(StyleSheetListImpl *impl); -public: - - StyleSheetList & operator = (const StyleSheetList &other); - - ~StyleSheetList(); - - /** - * The number of \c StyleSheet in the list. The range - * of valid child stylesheet indices is \c 0 to - * \c length-1 inclusive. - * - */ - unsigned long length() const; - - /** - * Used to retrieve a style sheet by ordinal index. - * - * @param index Index into the collection - * - * @return The style sheet at the \c index position in - * the \c StyleSheetList , or \c null if - * that is not a valid index. - * - */ - StyleSheet item ( unsigned long index ); - - /** - * @internal - */ - StyleSheetListImpl *handle() const; - bool isNull() const; - -protected: - StyleSheetListImpl *impl; -}; - - -class MediaListImpl; -class CSSRule; -class CSSStyleSheet; - -/** - * The \c MediaList interface provides the abstraction of - * an ordered collection of media, without defining or constraining - * how this collection is implemented. All media are lowercase - * strings. - * - */ -class KHTML_EXPORT MediaList -{ -public: - MediaList(); - MediaList(const MediaList &other); - MediaList(MediaListImpl *impl); -public: - - MediaList & operator = (const MediaList &other); - - ~MediaList(); - - /** - * The parsable textual representation of the media list. This is a - * comma-separated list of media. - * - * @exception DOMException - * SYNTAX_ERR: Raised if the specified string value has a syntax error and - * is unparsable. - * - * NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is readonly. - */ - DOM::DOMString mediaText() const; - - /** - * see mediaText - */ - void setMediaText(const DOM::DOMString &value); - - /** - * The number of media in the list. The range of valid media is 0 to length-1 inclusive. - */ - unsigned long length() const; - - - /** - * Returns the indexth in the list. If index is greater than or equal to - * the number of media in the list, this returns null. - * - * @param index Index into the collection. - * - * @return The medium at the indexth position in the MediaList, or null if - * that is not a valid index. - */ - DOM::DOMString item(unsigned long index) const; - - /** - * Deletes the medium indicated by oldMedium from the list. - * - * @param oldMedium The medium to delete in the media list. - * - * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. - * - * NOT_FOUND_ERR: Raised if oldMedium is not in the list. - */ - void deleteMedium(const DOM::DOMString &oldMedium); - - /** - * Adds the medium newMedium to the end of the list. If the newMedium is - * already used, it is first removed. - * - * @param newMedium The new medium to add. - * - * @exception DOMException - * INVALID_CHARACTER_ERR: If the medium contains characters that are - * invalid in the underlying style language. - * - * NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. - */ - void appendMedium(const DOM::DOMString &newMedium); - - /** - * @internal - */ - MediaListImpl *handle() const; - bool isNull() const; - -protected: - MediaListImpl *impl; -}; - -class LinkStyleImpl; - -class KHTML_EXPORT LinkStyle -{ -public: - LinkStyle(); - LinkStyle(const LinkStyle &other); - - LinkStyle & operator = (const LinkStyle &other); - LinkStyle & operator = (const Node &other); - - ~LinkStyle(); - - StyleSheet sheet(); - - bool isNull() const; - -protected: - DOM::NodeImpl *node; - LinkStyleImpl *impl; -}; - -class DocumentStyleImpl; - -class KHTML_EXPORT DocumentStyle -{ -public: - DocumentStyle(); - DocumentStyle(const DocumentStyle &other); - - DocumentStyle & operator = (const DocumentStyle &other); - DocumentStyle & operator = (const Document &other); - - ~DocumentStyle(); - - // KDE 4:: make const - StyleSheetList styleSheets(); - - DOMString preferredStylesheetSet() const; - DOMString selectedStylesheetSet() const; - void setSelectedStylesheetSet( const DOMString& aString ); - - bool isNull() const { return !impl; } - -protected: - DOM::DocumentImpl *doc; - DocumentStyleImpl *impl; -}; - -} // namespace - -#endif |