summaryrefslogtreecommitdiffstats
path: root/khtml/rendering/render_text.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /khtml/rendering/render_text.h
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
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
Diffstat (limited to 'khtml/rendering/render_text.h')
-rw-r--r--khtml/rendering/render_text.h345
1 files changed, 345 insertions, 0 deletions
diff --git a/khtml/rendering/render_text.h b/khtml/rendering/render_text.h
new file mode 100644
index 000000000..c65973c99
--- /dev/null
+++ b/khtml/rendering/render_text.h
@@ -0,0 +1,345 @@
+/*
+ * This file is part of the DOM implementation for KDE.
+ *
+ * (C) 1999-2003 Lars Knoll (knoll@kde.org)
+ * (C) 2000-2003 Dirk Mueller (mueller@kde.org)
+ * (C) 2003 Apple Computer, Inc.
+ *
+ * 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.
+ *
+ */
+#ifndef RENDERTEXT_H
+#define RENDERTEXT_H
+
+#include "dom/dom_string.h"
+#include "xml/dom_stringimpl.h"
+#include "xml/dom_textimpl.h"
+#include "rendering/render_object.h"
+#include "rendering/render_line.h"
+
+#include <qptrvector.h>
+#include <assert.h>
+
+class QPainter;
+class QFontMetrics;
+
+// Define a constant for soft hyphen's unicode value.
+#define SOFT_HYPHEN 173
+
+const int cNoTruncation = -1;
+const int cFullTruncation = -2;
+
+namespace khtml
+{
+ class RenderText;
+ class RenderStyle;
+
+class InlineTextBox : public InlineBox
+{
+public:
+ InlineTextBox(RenderObject *obj)
+ :InlineBox(obj),
+ // ### necessary as some codepaths (<br>) do *not* initialize these (LS)
+ m_start(0), m_len(0), m_truncation(cNoTruncation), m_reversed(false), m_toAdd(0)
+ {
+ }
+
+ void detach(RenderArena* renderArena);
+
+ virtual void clearTruncation() { m_truncation = cNoTruncation; }
+ virtual int placeEllipsisBox(bool ltr, int blockEdge, int ellipsisWidth, bool& foundBox);
+
+ // Overloaded new operator. Derived classes must override operator new
+ // in order to allocate out of the RenderArena.
+ void* operator new(size_t sz, RenderArena* renderArena) throw();
+
+ // Overridden to prevent the normal delete from being called.
+ void operator delete(void* ptr, size_t sz);
+
+private:
+ // The normal operator new is disallowed.
+ void* operator new(size_t sz) throw();
+
+public:
+ void setSpaceAdd(int add) { m_width -= m_toAdd; m_toAdd = add; m_width += m_toAdd; }
+ int spaceAdd() { return m_toAdd; }
+
+ virtual bool isInlineTextBox() const { return true; }
+
+ void paint(RenderObject::PaintInfo& i, int tx, int ty);
+ void paintDecoration(QPainter *pt, const Font *f, int _tx, int _ty, int decoration);
+ void paintShadow(QPainter *pt, const Font* f, int _tx, int _ty, const ShadowData *shadow );
+ void paintSelection(const Font *f, RenderText *text, QPainter *p, RenderStyle* style, int tx, int ty, int startPos, int endPos, int deco);
+
+ void selectionStartEnd(int& sPos, int& ePos);
+ RenderObject::SelectionState selectionState();
+
+ // Return before, after (offset set to max), or inside the text, at @p offset
+ FindSelectionResult checkSelectionPoint(int _x, int _y, int _tx, int _ty, const Font *f, RenderText *text, int & offset, short lineheight);
+
+ bool checkVerticalPoint(int _y, int _ty, int _h, int height)
+ { if((_ty + m_y > _y + _h) || (_ty + m_y + m_baseline + height < _y)) return false; return true; }
+
+ /**
+ * determines the offset into the DOMString of the character the given
+ * coordinate points to.
+ * The returned offset is never out of range.
+ * @param _x given coordinate (relative to containing block)
+ * @param ax returns exact coordinate the offset corresponds to
+ * (relative to containing block)
+ * @return the offset (relative to the RenderText object, not to this run)
+ */
+ int offsetForPoint(int _x, int &ax) const;
+
+ /**
+ * calculates the with of the specified chunk in this text box.
+ * @param pos zero-based position within the text box up to which
+ * the width is to be determined
+ * @return the width in pixels
+ */
+ int widthFromStart(int pos) const;
+
+ /** returns the lowest possible value the caret offset may have to
+ * still point to a valid position.
+ */
+ virtual long minOffset() const;
+ /** returns the highest possible value the caret offset may have to
+ * still point to a valid position.
+ */
+ virtual long maxOffset() const;
+
+ /** returns the associated render text
+ */
+ const RenderText *renderText() const;
+ RenderText *renderText();
+
+ int m_start;
+ unsigned short m_len;
+
+ int m_truncation; // Where to truncate when text overflow is applied.
+ // We use special constants to denote no truncation (the whole run paints)
+ // and full truncation (nothing paints at all).
+
+ bool m_reversed : 1;
+ unsigned m_toAdd : 14; // for justified text
+private:
+ // this is just for QVector::bsearch. Don't use it otherwise
+ InlineTextBox(int _x, int _y)
+ :InlineBox(0)
+ {
+ m_x = _x;
+ m_y = _y;
+ m_reversed = false;
+ };
+ friend class RenderText;
+};
+
+class InlineTextBoxArray : public QPtrVector<InlineTextBox>
+{
+public:
+ InlineTextBoxArray();
+
+ InlineTextBox* first();
+
+ int findFirstMatching( Item ) const;
+ virtual int compareItems( Item, Item );
+};
+
+class RenderText : public RenderObject
+{
+ friend class InlineTextBox;
+
+public:
+ RenderText(DOM::NodeImpl* node, DOM::DOMStringImpl *_str);
+ virtual ~RenderText();
+
+ virtual bool isTextFragment() const;
+ virtual DOM::DOMStringImpl* originalString() const;
+
+ virtual const char *renderName() const { return "RenderText"; }
+
+ virtual void setStyle(RenderStyle *style);
+
+
+ virtual void paint( PaintInfo& i, int tx, int ty );
+
+ virtual void deleteInlineBoxes(RenderArena* arena=0);
+
+ DOM::DOMString data() const { return str; }
+ DOM::DOMStringImpl *string() const { return str; }
+
+ virtual InlineBox* createInlineBox(bool, bool);
+
+ virtual void layout() {assert(false);}
+
+ virtual bool nodeAtPoint(NodeInfo& info, int x, int y, int tx, int ty, HitTestAction hitTestAction, bool inBox);
+
+ // Return before, after (offset set to max), or inside the text, at @p offset
+ virtual FindSelectionResult checkSelectionPoint( int _x, int _y, int _tx, int _ty,
+ DOM::NodeImpl*& node, int & offset,
+ SelPointState & );
+
+ unsigned int length() const { if (str) return str->l; else return 0; }
+ QChar *text() const { if (str) return str->s; else return 0; }
+ unsigned int stringLength() const { return str->l; } // non virtual implementation of length()
+ virtual void position(InlineBox* box, int from, int len, bool reverse);
+
+ virtual unsigned int width(unsigned int from, unsigned int len, const Font *f) const;
+ virtual unsigned int width(unsigned int from, unsigned int len, bool firstLine = false) const;
+ virtual short width() const;
+ virtual int height() const;
+
+ // height of the contents (without paddings, margins and borders)
+ virtual short lineHeight( bool firstLine ) const;
+ virtual short baselinePosition( bool firstLine ) const;
+
+ // overrides
+ virtual void calcMinMaxWidth();
+ virtual short minWidth() const { return m_minWidth; }
+ virtual int maxWidth() const { return m_maxWidth; }
+
+ void trimmedMinMaxWidth(short& beginMinW, bool& beginWS,
+ short& endMinW, bool& endWS,
+ bool& hasBreakableChar, bool& hasBreak,
+ short& beginMaxW, short& endMaxW,
+ short& minW, short& maxW, bool& stripFrontSpaces);
+
+ bool containsOnlyWhitespace(unsigned int from, unsigned int len) const;
+
+ ushort startMin() const { return m_startMin; }
+ ushort endMin() const { return m_endMin; }
+
+ // returns the minimum x position of all runs relative to the parent.
+ // defaults to 0.
+ int minXPos() const;
+
+ virtual int inlineXPos() const;
+ virtual int inlineYPos() const;
+
+ bool hasReturn() const { return m_hasReturn; }
+
+ virtual const QFont &font();
+ virtual short verticalPositionHint( bool firstLine ) const;
+
+ bool isFixedWidthFont() const;
+
+ void setText(DOM::DOMStringImpl *text, bool force=false);
+
+ virtual SelectionState selectionState() const {return m_selectionState;}
+ virtual void setSelectionState(SelectionState s) {m_selectionState = s; }
+ virtual void caretPos(int offset, int flags, int &_x, int &_y, int &width, int &height);
+ virtual bool absolutePosition(int &/*xPos*/, int &/*yPos*/, bool f = false) const;
+ bool posOfChar(int ch, int &x, int &y);
+
+ virtual short marginLeft() const { return style()->marginLeft().minWidth(0); }
+ virtual short marginRight() const { return style()->marginRight().minWidth(0); }
+
+ virtual void repaint(Priority p=NormalPriority);
+
+ bool hasBreakableChar() const { return m_hasBreakableChar; }
+ const QFontMetrics &metrics(bool firstLine) const;
+ const Font *htmlFont(bool firstLine) const;
+
+ DOM::TextImpl *element() const
+ { return static_cast<DOM::TextImpl*>(RenderObject::element()); }
+
+ /** returns the lowest possible value the caret offset may have to
+ * still point to a valid position.
+ */
+ virtual long minOffset() const;
+
+ /** returns the highest possible value the caret offset may have to
+ * still point to a valid position.
+ */
+ virtual long maxOffset() const;
+
+ /** returns the number of inline text boxes
+ */
+ unsigned inlineTextBoxCount() const { return m_lines.count(); }
+ /** returns the array of inline text boxes for this render text.
+ */
+ const InlineTextBoxArray &inlineTextBoxes() const { return m_lines; }
+
+#ifdef ENABLE_DUMP
+ virtual void dump(QTextStream &stream, const QString &ind) const;
+#endif
+
+ /** Find the text box that includes the character at @p offset
+ * and return pos, which is the position of the char in the run.
+ * @param offset zero-based offset into DOM string
+ * @param pos returns relative position within text box
+ * @param checkFirstLetter passing @p true will also regard :first-letter
+ * boxes, if available.
+ * @return the text box, or 0 if no match has been found
+ */
+ InlineTextBox * findInlineTextBox( int offset, int &pos,
+ bool checkFirstLetter = false );
+
+protected: // members
+ InlineTextBoxArray m_lines;
+ DOM::DOMStringImpl *str; //
+
+ short m_lineHeight;
+ short m_minWidth;
+ int m_maxWidth;
+ short m_beginMinWidth;
+ short m_endMinWidth;
+
+ SelectionState m_selectionState : 3 ;
+ bool m_hasReturn : 1;
+ bool m_hasBreakableChar : 1;
+ bool m_hasBreak : 1;
+ bool m_hasBeginWS : 1;
+ bool m_hasEndWS : 1;
+
+ ushort m_startMin : 8;
+ ushort m_endMin : 8;
+};
+
+inline const RenderText* InlineTextBox::renderText() const
+{ return static_cast<RenderText*>( object() ); }
+
+inline RenderText* InlineTextBox::renderText()
+{ return static_cast<RenderText*>( object() ); }
+
+// Used to represent a text substring of an element, e.g., for text runs that are split because of
+// first letter and that must therefore have different styles (and positions in the render tree).
+// We cache offsets so that text transformations can be applied in such a way that we can recover
+// the original unaltered string from our corresponding DOM node.
+class RenderTextFragment : public RenderText
+{
+public:
+ RenderTextFragment(DOM::NodeImpl* _node, DOM::DOMStringImpl* _str,
+ int startOffset, int endOffset);
+ RenderTextFragment(DOM::NodeImpl* _node, DOM::DOMStringImpl* _str);
+ ~RenderTextFragment();
+
+ virtual bool isTextFragment() const;
+ virtual const char *renderName() const { return "RenderTextFragment"; }
+
+ uint start() const { return m_start; }
+ uint end() const { return m_end; }
+
+ DOM::DOMStringImpl* contentString() const { return m_generatedContentStr; }
+ virtual DOM::DOMStringImpl* originalString() const;
+
+private:
+ uint m_start;
+ uint m_end;
+ DOM::DOMStringImpl* m_generatedContentStr;
+};
+} // end namespace
+#endif