Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 431 insertions, 0 deletions

diff --git a/khtml/dom/html_image.h b/khtml/dom/html_image.h
new file mode 100644
index 000000000..9f30aaa14
--- /dev/null
+++ b/khtml/dom/html_image.h
@@ -0,0 +1,431 @@
+/*
+ * 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 1 Specification (Recommendation)
+ * http://www.w3.org/TR/REC-DOM-Level-1/
+ * Copyright © World Wide Web Consortium , (Massachusetts Institute of
+ * Technology , Institut National de Recherche en Informatique et en
+ * Automatique , Keio University ). All Rights Reserved.
+ *
+ */
+#ifndef HTML_IMAGE_H
+#define HTML_IMAGE_H
+
+#include <dom/html_element.h>
+
+#include <kdemacros.h>
+
+namespace DOM {
+
+class HTMLAreaElementImpl;
+class DOMString;
+
+/**
+ * Client-side image map area definition. See the <a
+ * href="http://www.w3.org/TR/REC-html40/struct/objects.html#edef-AREA">
+ * AREA element definition </a> in HTML 4.0.
+ *
+ */
+class KHTML_EXPORT HTMLAreaElement : public HTMLElement
+{
+public:
+    HTMLAreaElement();
+    HTMLAreaElement(const HTMLAreaElement &other);
+    HTMLAreaElement(const Node &other) : HTMLElement()
+         {(*this)=other;}
+protected:
+    HTMLAreaElement(HTMLAreaElementImpl *impl);
+public:
+
+    HTMLAreaElement & operator = (const HTMLAreaElement &other);
+    HTMLAreaElement & operator = (const Node &other);
+
+    ~HTMLAreaElement();
+
+    /**
+     * A single character access key to give access to the form
+     * control. See the <a
+     * href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-accesskey">
+     * accesskey attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString accessKey() const;
+
+    /**
+     * see accessKey
+     */
+    void setAccessKey( const DOMString & );
+
+    /**
+     * Alternate text for user agents not rendering the normal content
+     * of this element. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-alt">
+     * alt attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString alt() const;
+
+    /**
+     * see alt
+     */
+    void setAlt( const DOMString & );
+
+    /**
+     * Comma-separated list of lengths, defining an active region
+     * geometry. See also \c shape for the shape of the
+     * region. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords">
+     * coords attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString coords() const;
+
+    /**
+     * see coords
+     */
+    void setCoords( const DOMString & );
+
+    /**
+     * The URI of the linked resource. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/links.html#adef-href">
+     * href attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString href() const;
+
+    /**
+     * see href
+     */
+    void setHref( const DOMString & );
+
+    /**
+     * Specifies that this area is inactive, i.e., has no associated
+     * action. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-nohref">
+     * nohref attribute definition </a> in HTML 4.0.
+     *
+     */
+    bool noHref() const;
+
+    /**
+     * see noHref
+     */
+    void setNoHref( bool );
+
+    /**
+     * The shape of the active area. The coordinates are given by
+     * \c coords . See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-shape">
+     * shape attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString shape() const;
+
+    /**
+     * see shape
+     */
+    void setShape( const DOMString & );
+
+    /**
+     * Index that represents the element's position in the tabbing
+     * order. See the <a
+     * href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-tabindex">
+     * tabindex attribute definition </a> in HTML 4.0.
+     *
+     */
+    long tabIndex() const;
+
+    /**
+     * see tabIndex
+     */
+    void setTabIndex( long );
+
+    /**
+     * Frame to render the resource in. See the <a
+     * href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">
+     * target attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString target() const;
+
+    /**
+     * see target
+     */
+    void setTarget( const DOMString & );
+};
+
+// --------------------------------------------------------------------------
+
+class HTMLImageElementImpl;
+
+/**
+ * Embedded image. See the <a
+ * href="http://www.w3.org/TR/REC-html40/struct/objects.html#edef-IMG">
+ * IMG element definition </a> in HTML 4.0.
+ *
+ */
+class KHTML_EXPORT HTMLImageElement : public HTMLElement
+{
+public:
+    HTMLImageElement();
+    HTMLImageElement(const HTMLImageElement &other);
+    HTMLImageElement(const Node &other) : HTMLElement()
+         {(*this)=other;}
+protected:
+    HTMLImageElement(HTMLImageElementImpl *impl);
+public:
+
+    HTMLImageElement & operator = (const HTMLImageElement &other);
+    HTMLImageElement & operator = (const Node &other);
+
+    ~HTMLImageElement();
+
+    /**
+     * The name of the element (for backwards compatibility).
+     *
+     */
+    DOMString name() const;
+
+    /**
+     * see name
+     */
+    void setName( const DOMString & );
+
+    /**
+     * Aligns this object (vertically or horizontally) with respect to
+     * its surrounding text. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-align-IMG">
+     * align attribute definition </a> in HTML 4.0. This attribute is
+     * deprecated in HTML 4.0.
+     *
+     */
+    DOMString align() const;
+
+    /**
+     * see align
+     */
+    void setAlign( const DOMString & );
+
+    /**
+     * Alternate text for user agents not rendering the normal content
+     * of this element. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-alt">
+     * alt attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString alt() const;
+
+    /**
+     * see alt
+     */
+    void setAlt( const DOMString & );
+
+    /**
+     * Width of border around image. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-border-IMG">
+     * border attribute definition </a> in HTML 4.0. This attribute is
+     * deprecated in HTML 4.0.
+     *
+     */
+    DOMString getBorder() const;
+
+     /**
+      * see border
+      */
+    void setBorder( const DOMString& );
+
+
+    /**
+     * @deprecated
+     */
+    long border() const KDE_DEPRECATED;
+
+    /**
+     * @deprecated
+     */
+    void setBorder( long ) KDE_DEPRECATED;
+
+    /**
+     * Override height. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-height-IMG">
+     * height attribute definition </a> in HTML 4.0.
+     *
+     */
+    long height() const;
+
+    /**
+     * see height
+     */
+    void setHeight( long );
+
+    /**
+     * Horizontal space to the left and right of this image. See the
+     * <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-hspace">
+     * hspace attribute definition </a> in HTML 4.0. This attribute is
+     * deprecated in HTML 4.0.
+     *
+     */
+    long hspace() const;
+
+    /**
+     * see hspace
+     */
+    void setHspace( long );
+
+    /**
+     * Use server-side image map. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-ismap">
+     * ismap attribute definition </a> in HTML 4.0.
+     *
+     */
+    bool isMap() const;
+
+    /**
+     * see isMap
+     */
+    void setIsMap( bool );
+
+    /**
+     * URI designating a long description of this image or frame. See
+     * the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-longdesc-IMG">
+     * longdesc attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString longDesc() const;
+
+    /**
+     * see longDesc
+     */
+    void setLongDesc( const DOMString & );
+
+    /**
+     * URI designating the source of this image. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-src-IMG">
+     * src attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString src() const;
+
+    /**
+     * see src
+     */
+    void setSrc( const DOMString & );
+
+    /**
+     * Use client-side image map. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-usemap">
+     * usemap attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString useMap() const;
+
+    /**
+     * see useMap
+     */
+    void setUseMap( const DOMString & );
+
+    /**
+     * Vertical space above and below this image. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-vspace">
+     * vspace attribute definition </a> in HTML 4.0. This attribute is
+     * deprecated in HTML 4.0.
+     *
+     */
+    long vspace() const;
+
+    /**
+     * see vspace
+     */
+    void setVspace( long );
+
+    /**
+     * Override width. See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-width-IMG">
+     * width attribute definition </a> in HTML 4.0.
+     *
+     */
+    long width() const;
+
+    /**
+     * see width
+     */
+    void setWidth( long );
+
+    /**
+     * Nonstandard extension to DOM::ImgElement
+     */
+    long x() const;
+    long y() const;
+};
+
+// --------------------------------------------------------------------------
+
+class HTMLMapElementImpl;
+class HTMLCollection;
+class DOMString;
+
+/**
+ * Client-side image map. See the <a
+ * href="http://www.w3.org/TR/REC-html40/struct/objects.html#edef-MAP">
+ * MAP element definition </a> in HTML 4.0.
+ *
+ */
+class KHTML_EXPORT HTMLMapElement : public HTMLElement
+{
+public:
+    HTMLMapElement();
+    HTMLMapElement(const HTMLMapElement &other);
+    HTMLMapElement(const Node &other) : HTMLElement()
+         {(*this)=other;}
+protected:
+    HTMLMapElement(HTMLMapElementImpl *impl);
+public:
+
+    HTMLMapElement & operator = (const HTMLMapElement &other);
+    HTMLMapElement & operator = (const Node &other);
+
+    ~HTMLMapElement();
+
+    /**
+     * The list of areas defined for the image map.
+     *
+     */
+    HTMLCollection areas() const;
+
+    /**
+     * Names the map (for use with \c usemap ). See the <a
+     * href="http://www.w3.org/TR/REC-html40/struct/objects.html#adef-name-MAP">
+     * name attribute definition </a> in HTML 4.0.
+     *
+     */
+    DOMString name() const;
+
+    /**
+     * see name
+     */
+    void setName( const DOMString & );
+};
+
+} //namespace
+
+#endif