qtextobject.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:9k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QTEXTOBJECT_H
  38. #define QTEXTOBJECT_H
  39. #include <QtCore/qobject.h>
  40. #include <QtGui/qtextformat.h>
  41. QT_BEGIN_HEADER
  42. QT_BEGIN_NAMESPACE
  43. QT_MODULE(Gui)
  44. class QTextObjectPrivate;
  45. class QTextDocument;
  46. class QTextDocumentPrivate;
  47. class QTextCursor;
  48. class QTextBlock;
  49. class QTextFragment;
  50. class QTextLayout;
  51. class QTextList;
  52. class Q_GUI_EXPORT QTextObject : public QObject
  53. {
  54.     Q_OBJECT
  55. protected:
  56.     explicit QTextObject(QTextDocument *doc);
  57.     ~QTextObject();
  58.     void setFormat(const QTextFormat &format);
  59. public:
  60.     QTextFormat format() const;
  61.     int formatIndex() const;
  62.     QTextDocument *document() const;
  63.     int objectIndex() const;
  64.     QTextDocumentPrivate *docHandle() const;
  65. protected:
  66.     QTextObject(QTextObjectPrivate &p, QTextDocument *doc);
  67. private:
  68.     Q_DECLARE_PRIVATE(QTextObject)
  69.     Q_DISABLE_COPY(QTextObject)
  70.     friend class QTextDocumentPrivate;
  71. };
  72. class QTextBlockGroupPrivate;
  73. class Q_GUI_EXPORT QTextBlockGroup : public QTextObject
  74. {
  75.     Q_OBJECT
  76. protected:
  77.     explicit QTextBlockGroup(QTextDocument *doc);
  78.     ~QTextBlockGroup();
  79.     virtual void blockInserted(const QTextBlock &block);
  80.     virtual void blockRemoved(const QTextBlock &block);
  81.     virtual void blockFormatChanged(const QTextBlock &block);
  82.     QList<QTextBlock> blockList() const;
  83. protected:
  84.     QTextBlockGroup(QTextBlockGroupPrivate &p, QTextDocument *doc);
  85. private:
  86.     Q_DECLARE_PRIVATE(QTextBlockGroup)
  87.     Q_DISABLE_COPY(QTextBlockGroup)
  88.     friend class QTextDocumentPrivate;
  89. };
  90. class Q_GUI_EXPORT QTextFrameLayoutData {
  91. public:
  92.     virtual ~QTextFrameLayoutData();
  93. };
  94. class QTextFramePrivate;
  95. class Q_GUI_EXPORT QTextFrame : public QTextObject
  96. {
  97.     Q_OBJECT
  98. public:
  99.     explicit QTextFrame(QTextDocument *doc);
  100.     ~QTextFrame();
  101.     inline void setFrameFormat(const QTextFrameFormat &format);
  102.     QTextFrameFormat frameFormat() const { return QTextObject::format().toFrameFormat(); }
  103.     QTextCursor firstCursorPosition() const;
  104.     QTextCursor lastCursorPosition() const;
  105.     int firstPosition() const;
  106.     int lastPosition() const;
  107.     QTextFrameLayoutData *layoutData() const;
  108.     void setLayoutData(QTextFrameLayoutData *data);
  109.     QList<QTextFrame *> childFrames() const;
  110.     QTextFrame *parentFrame() const;
  111.     class Q_GUI_EXPORT iterator {
  112.         QTextFrame *f;
  113.         int b;
  114.         int e;
  115.         QTextFrame *cf;
  116.         int cb;
  117.         friend class QTextFrame;
  118.         friend class QTextTableCell;
  119.         friend class QTextDocumentLayoutPrivate;
  120.         iterator(QTextFrame *frame, int block, int begin, int end);
  121.     public:
  122.         iterator();
  123.         iterator(const iterator &o);
  124.         iterator &operator=(const iterator &o);
  125.         QTextFrame *parentFrame() const { return f; }
  126.         QTextFrame *currentFrame() const;
  127.         QTextBlock currentBlock() const;
  128.         bool atEnd() const { return !cf && cb == e; }
  129.         inline bool operator==(const iterator &o) const { return f == o.f && cf == o.cf && cb == o.cb; }
  130.         inline bool operator!=(const iterator &o) const { return f != o.f || cf != o.cf || cb != o.cb; }
  131.         iterator &operator++();
  132.         inline iterator operator++(int) { iterator tmp = *this; operator++(); return tmp; }
  133.         iterator &operator--();
  134.         inline iterator operator--(int) { iterator tmp = *this; operator--(); return tmp; }
  135.     };
  136.     friend class iterator;
  137.     // more Qt
  138.     typedef iterator Iterator;
  139.     iterator begin() const;
  140.     iterator end() const;
  141. protected:
  142.     QTextFrame(QTextFramePrivate &p, QTextDocument *doc);
  143. private:
  144.     friend class QTextDocumentPrivate;
  145.     Q_DECLARE_PRIVATE(QTextFrame)
  146.     Q_DISABLE_COPY(QTextFrame)
  147. };
  148. Q_DECLARE_TYPEINFO(QTextFrame::iterator, Q_MOVABLE_TYPE);
  149. inline void QTextFrame::setFrameFormat(const QTextFrameFormat &aformat)
  150. { QTextObject::setFormat(aformat); }
  151. class Q_GUI_EXPORT QTextBlockUserData {
  152. public:
  153.     virtual ~QTextBlockUserData();
  154. };
  155. class Q_GUI_EXPORT QTextBlock
  156. {
  157.     friend class QSyntaxHighlighter;
  158. public:
  159.     inline QTextBlock(QTextDocumentPrivate *priv, int b) : p(priv), n(b) {}
  160.     inline QTextBlock() : p(0), n(0) {}
  161.     inline QTextBlock(const QTextBlock &o) : p(o.p), n(o.n) {}
  162.     inline QTextBlock &operator=(const QTextBlock &o) { p = o.p; n = o.n; return *this; }
  163.     inline bool isValid() const { return p != 0 && n != 0; }
  164.     inline bool operator==(const QTextBlock &o) const { return p == o.p && n == o.n; }
  165.     inline bool operator!=(const QTextBlock &o) const { return p != o.p || n != o.n; }
  166.     inline bool operator<(const QTextBlock &o) const { return position() < o.position(); }
  167.     int position() const;
  168.     int length() const;
  169.     bool contains(int position) const;
  170.     QTextLayout *layout() const;
  171.     void clearLayout();
  172.     QTextBlockFormat blockFormat() const;
  173.     int blockFormatIndex() const;
  174.     QTextCharFormat charFormat() const;
  175.     int charFormatIndex() const;
  176.     QString text() const;
  177.     const QTextDocument *document() const;
  178.     QTextList *textList() const;
  179.     QTextBlockUserData *userData() const;
  180.     void setUserData(QTextBlockUserData *data);
  181.     int userState() const;
  182.     void setUserState(int state);
  183.     int revision() const;
  184.     void setRevision(int rev);
  185.     bool isVisible() const;
  186.     void setVisible(bool visible);
  187.     int blockNumber() const;
  188.     class Q_GUI_EXPORT iterator {
  189.         const QTextDocumentPrivate *p;
  190.         int b;
  191.         int e;
  192.         int n;
  193.         friend class QTextBlock;
  194.         iterator(const QTextDocumentPrivate *priv, int begin, int end, int f) : p(priv), b(begin), e(end), n(f) {}
  195.     public:
  196.         iterator() : p(0), b(0), e(0), n(0) {}
  197.         iterator(const iterator &o) : p(o.p), b(o.b), e(o.e), n(o.n) {}
  198.         QTextFragment fragment() const;
  199.         bool atEnd() const { return n == e; }
  200.         inline bool operator==(const iterator &o) const { return p == o.p && n == o.n; }
  201.         inline bool operator!=(const iterator &o) const { return p != o.p || n != o.n; }
  202.         iterator &operator++();
  203.         inline iterator operator++(int) { iterator tmp = *this; operator++(); return tmp; }
  204.         iterator &operator--();
  205.         inline iterator operator--(int) { iterator tmp = *this; operator--(); return tmp; }
  206.     };
  207.     // more Qt
  208.     typedef iterator Iterator;
  209.     iterator begin() const;
  210.     iterator end() const;
  211.     QTextBlock next() const;
  212.     QTextBlock previous() const;
  213.     inline QTextDocumentPrivate *docHandle() const { return p; }
  214. private:
  215.     QTextDocumentPrivate *p;
  216.     int n;
  217.     friend class QTextDocumentPrivate;
  218.     friend class QTextLayout;
  219. };
  220. Q_DECLARE_TYPEINFO(QTextBlock, Q_MOVABLE_TYPE);
  221. Q_DECLARE_TYPEINFO(QTextBlock::iterator, Q_MOVABLE_TYPE);
  222. class Q_GUI_EXPORT QTextFragment
  223. {
  224. public:
  225.     inline QTextFragment(const QTextDocumentPrivate *priv, int f, int fe) : p(priv), n(f), ne(fe) {}
  226.     inline QTextFragment() : p(0), n(0), ne(0) {}
  227.     inline QTextFragment(const QTextFragment &o) : p(o.p), n(o.n), ne(o.ne) {}
  228.     inline QTextFragment &operator=(const QTextFragment &o) { p = o.p; n = o.n; ne = o.ne; return *this; }
  229.     inline bool isValid() const { return p && n; }
  230.     inline bool operator==(const QTextFragment &o) const { return p == o.p && n == o.n; }
  231.     inline bool operator!=(const QTextFragment &o) const { return p != o.p || n != o.n; }
  232.     inline bool operator<(const QTextFragment &o) const { return position() < o.position(); }
  233.     int position() const;
  234.     int length() const;
  235.     bool contains(int position) const;
  236.     QTextCharFormat charFormat() const;
  237.     int charFormatIndex() const;
  238.     QString text() const;
  239. private:
  240.     const QTextDocumentPrivate *p;
  241.     int n;
  242.     int ne;
  243. };
  244. Q_DECLARE_TYPEINFO(QTextFragment, Q_MOVABLE_TYPE);
  245. QT_END_NAMESPACE
  246. QT_END_HEADER
  247. #endif // QTEXTOBJECT_H