diff options
Diffstat (limited to 'doc/html/qtextedit-h.html')
-rw-r--r-- | doc/html/qtextedit-h.html | 658 |
1 files changed, 658 insertions, 0 deletions
diff --git a/doc/html/qtextedit-h.html b/doc/html/qtextedit-h.html new file mode 100644 index 000000000..1133b5e71 --- /dev/null +++ b/doc/html/qtextedit-h.html @@ -0,0 +1,658 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qtextedit.h:1 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>qtextedit.h Include File</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qtextedit.h</h1> + +<p>This is the verbatim text of the qtextedit.h include file. It is provided only for illustration; the copyright remains with Trolltech. +<hr> +<pre> +/**************************************************************************** +** $Id: qt/qtextedit.h 3.3.8 edited Jan 11 14:39 $ +** +** Definition of the TQTextEdit class +** +** Created : 990101 +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of the widgets module of the TQt GUI Toolkit. +** +** This file may be used under the terms of the GNU General Public +** License versions 2.0 or 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Alternatively you may (at your option) use any +** later version of the GNU General Public License if such license has +** been publicly approved by Trolltech ASA (or its successors, if any) +** and the KDE Free TQt Foundation. +** +** Please review the following information to ensure GNU General +** Public Licensing retquirements will be met: +** http://trolltech.com/products/qt/licenses/licensing/opensource/. +** If you are unsure which license is appropriate for your use, please +** review the following information: +** http://trolltech.com/products/qt/licenses/licensing/licensingoverview +** or contact the sales department at sales@trolltech.com. +** +** This file may be used under the terms of the Q Public License as +** defined by Trolltech ASA and appearing in the file LICENSE.TQPL +** included in the packaging of this file. Licensees holding valid TQt +** Commercial licenses may use this file in accordance with the TQt +** Commercial License Agreement provided with the Software. +** +** This file is provided "AS IS" with NO WARRANTY OF ANY KIND, +** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted +** herein. +** +**********************************************************************/ + +#ifndef TQTEXTEDIT_H +#define TQTEXTEDIT_H + +#ifndef QT_H +#include "qscrollview.h" +#include "qstylesheet.h" +#include "qptrvector.h" +#include "qvaluelist.h" +#include "qptrlist.h" +#endif // QT_H + +#ifndef QT_NO_TEXTEDIT +// uncomment below to enable optimization mode - also uncomment the +// optimDoAutoScroll() private slot since moc ignores #ifdefs.. +#define QT_TEXTEDIT_OPTIMIZATION + +class TQPainter; +class TQTextDocument; +class TQTextCursor; +class TQKeyEvent; +class TQResizeEvent; +class TQMouseEvent; +class TQTimer; +class TQTextString; +class TQTextCommand; +class TQTextParagraph; +class TQTextFormat; +class TQFont; +class TQColor; +class TQTextEdit; +class TQTextBrowser; +class TQTextString; +struct TQUndoRedoInfoPrivate; +class TQPopupMenu; +class TQTextEditPrivate; +class TQSyntaxHighlighter; + +#ifdef QT_TEXTEDIT_OPTIMIZATION +class TQTextEditOptimPrivate +{ +public: + // Note: no left-tag has any value for leftTag or parent, and + // no right-tag has any formatting flags set. + enum TagType { Color = 0, Format = 1 }; + struct Tag { + TagType type:2; + bool bold:1; + bool italic:1; + bool underline:1; + int line; + int index; + Tag * leftTag; // ptr to left-tag in a left-right tag pair + Tag * parent; // ptr to parent left-tag in a nested tag + Tag * prev; + Tag * next; + TQString tag; + }; + TQTextEditOptimPrivate() + { + len = numLines = maxLineWidth = 0; + selStart.line = selStart.index = -1; + selEnd.line = selEnd.index = -1; + search.line = search.index = 0; + tags = lastTag = 0; + } + void clearTags() + { + Tag * itr = tags; + while ( tags ) { + itr = tags; + tags = tags->next; + delete itr; + } + tags = lastTag = 0; + tagIndex.clear(); + } + ~TQTextEditOptimPrivate() + { + clearTags(); + } + int len; + int numLines; + int maxLineWidth; + struct Selection { + int line; + int index; + }; + Selection selStart, selEnd, search; + Tag * tags, * lastTag; + TQMap<int, TQString> lines; + TQMap<int, Tag *> tagIndex; +}; +#endif + +class Q_EXPORT TQTextEdit : public TQScrollView +{ + friend class TQTextBrowser; + friend class TQSyntaxHighlighter; + + Q_OBJECT + Q_ENUMS( WordWrap WrapPolicy ) + Q_SETS( AutoFormatting ) + Q_PROPERTY( TextFormat textFormat READ textFormat WRITE setTextFormat ) + Q_PROPERTY( TQString text READ text WRITE setText ) + Q_PROPERTY( TQBrush paper READ paper WRITE setPaper ) + Q_PROPERTY( bool linkUnderline READ linkUnderline WRITE setLinkUnderline ) + Q_PROPERTY( TQString documentTitle READ documentTitle ) + Q_PROPERTY( int length READ length ) + Q_PROPERTY( WordWrap wordWrap READ wordWrap WRITE setWordWrap ) + Q_PROPERTY( int wrapColumnOrWidth READ wrapColumnOrWidth WRITE setWrapColumnOrWidth ) + Q_PROPERTY( WrapPolicy wrapPolicy READ wrapPolicy WRITE setWrapPolicy ) + Q_PROPERTY( bool hasSelectedText READ hasSelectedText ) + Q_PROPERTY( TQString selectedText READ selectedText ) + Q_PROPERTY( int undoDepth READ undoDepth WRITE setUndoDepth ) + Q_PROPERTY( bool overwriteMode READ isOverwriteMode WRITE setOverwriteMode ) + Q_PROPERTY( bool modified READ isModified WRITE setModified DESIGNABLE false ) + Q_PROPERTY( bool readOnly READ isReadOnly WRITE setReadOnly ) + Q_PROPERTY( bool undoRedoEnabled READ isUndoRedoEnabled WRITE setUndoRedoEnabled ) + Q_PROPERTY( int tabStopWidth READ tabStopWidth WRITE setTabStopWidth ) + Q_PROPERTY( bool tabChangesFocus READ tabChangesFocus WRITE setTabChangesFocus ) + Q_PROPERTY( AutoFormatting autoFormatting READ autoFormatting WRITE setAutoFormatting ) + +public: + enum WordWrap { + NoWrap, + WidgetWidth, + FixedPixelWidth, + FixedColumnWidth + }; + + enum WrapPolicy { + AtWordBoundary, + AtWhiteSpace = AtWordBoundary, // AtWhiteSpace is deprecated + Anywhere, + AtWordOrDocumentBoundary + }; + + enum AutoFormatting { + AutoNone = 0, + AutoBulletList = 0x00000001, + AutoAll = 0xffffffff + }; + + enum KeyboardAction { + ActionBackspace, + ActionDelete, + ActionReturn, + ActionKill, + ActionWordBackspace, + ActionWordDelete + }; + + enum CursorAction { + MoveBackward, + MoveForward, + MoveWordBackward, + MoveWordForward, + MoveUp, + MoveDown, + MoveLineStart, + MoveLineEnd, + MoveHome, + MoveEnd, + MovePgUp, + MovePgDown + }; + + enum VerticalAlignment { + AlignNormal, + AlignSuperScript, + AlignSubScript + }; + + enum TextInsertionFlags { + RedoIndentation = 0x0001, + CheckNewLines = 0x0002, + RemoveSelected = 0x0004 + }; + + TQTextEdit( const TQString& text, const TQString& context = TQString::null, + TQWidget* parent=0, const char* name=0); + TQTextEdit( TQWidget* parent=0, const char* name=0 ); + virtual ~TQTextEdit(); + void setPalette( const TQPalette & ); + + TQString text() const; + TQString text( int para ) const; + TextFormat textFormat() const; + TQString context() const; + TQString documentTitle() const; + + void getSelection( int *paraFrom, int *indexFrom, + int *paraTo, int *indexTo, int selNum = 0 ) const; + virtual bool find( const TQString &expr, bool cs, bool wo, bool forward = TRUE, + int *para = 0, int *index = 0 ); + + int paragraphs() const; + int lines() const; + int linesOfParagraph( int para ) const; + int lineOfChar( int para, int chr ); + int length() const; + TQRect paragraphRect( int para ) const; + int paragraphAt( const TQPoint &pos ) const; + int charAt( const TQPoint &pos, int *para ) const; + int paragraphLength( int para ) const; + + TQStyleSheet* styleSheet() const; +#ifndef QT_NO_MIME + TQMimeSourceFactory* mimeSourceFactory() const; +#endif + TQBrush paper() const; + bool linkUnderline() const; + + int heightForWidth( int w ) const; + + bool hasSelectedText() const; + TQString selectedText() const; + bool isUndoAvailable() const; + bool isRedoAvailable() const; + + WordWrap wordWrap() const; + int wrapColumnOrWidth() const; + WrapPolicy wrapPolicy() const; + + int tabStopWidth() const; + + TQString anchorAt( const TQPoint& pos ); + TQString anchorAt( const TQPoint& pos, AnchorAttribute a ); + + TQSize sizeHint() const; + + bool isReadOnly() const { return readonly; } + + void getCursorPosition( int *parag, int *index ) const; + + bool isModified() const; + bool italic() const; + bool bold() const; + bool underline() const; + TQString family() const; + int pointSize() const; + TQColor color() const; + TQFont font() const; + TQFont currentFont() const; + int alignment() const; + int undoDepth() const; + + // do not use, will go away + virtual bool getFormat( int para, int index, TQFont *font, TQColor *color, VerticalAlignment *verticalAlignment ); + // do not use, will go away + virtual bool getParagraphFormat( int para, TQFont *font, TQColor *color, + VerticalAlignment *verticalAlignment, int *alignment, + TQStyleSheetItem::DisplayMode *displayMode, + TQStyleSheetItem::ListStyle *listStyle, + int *listDepth ); + + + bool isOverwriteMode() const { return overWrite; } + TQColor paragraphBackgroundColor( int para ) const; + + bool isUndoRedoEnabled() const; + bool eventFilter( TQObject *o, TQEvent *e ); + bool tabChangesFocus() const; + + void setAutoFormatting( uint features ); + uint autoFormatting() const; + TQSyntaxHighlighter *syntaxHighlighter() const; + +public slots: + void setEnabled( bool ); +#ifndef QT_NO_MIME + virtual void setMimeSourceFactory( TQMimeSourceFactory* factory ); +#endif + virtual void setStyleSheet( TQStyleSheet* styleSheet ); + virtual void scrollToAnchor( const TQString& name ); + virtual void setPaper( const TQBrush& pap ); + virtual void setLinkUnderline( bool ); + + virtual void setWordWrap( WordWrap mode ); + virtual void setWrapColumnOrWidth( int ); + virtual void setWrapPolicy( WrapPolicy policy ); + + virtual void copy(); + virtual void append( const TQString& text ); + + void setText( const TQString &txt ) { setText( txt, TQString::null ); } + virtual void setText( const TQString &txt, const TQString &context ); + virtual void setTextFormat( TextFormat f ); + + virtual void selectAll( bool select = TRUE ); + virtual void setTabStopWidth( int ts ); + virtual void zoomIn( int range ); + virtual void zoomIn() { zoomIn( 1 ); } + virtual void zoomOut( int range ); + virtual void zoomOut() { zoomOut( 1 ); } + virtual void zoomTo( int size ); + + virtual void sync(); + virtual void setReadOnly( bool b ); + + virtual void undo(); + virtual void redo(); + virtual void cut(); + virtual void paste(); +#ifndef QT_NO_CLIPBOARD + virtual void pasteSubType( const TQCString &subtype ); +#endif + virtual void clear(); + virtual void del(); + virtual void indent(); + virtual void setItalic( bool b ); + virtual void setBold( bool b ); + virtual void setUnderline( bool b ); + virtual void setFamily( const TQString &f ); + virtual void setPointSize( int s ); + virtual void setColor( const TQColor &c ); + virtual void setFont( const TQFont &f ); + virtual void setVerticalAlignment( VerticalAlignment a ); + virtual void setAlignment( int a ); + + // do not use, will go away + virtual void setParagType( TQStyleSheetItem::DisplayMode dm, TQStyleSheetItem::ListStyle listStyle ); + + virtual void setCursorPosition( int parag, int index ); + virtual void setSelection( int parag_from, int index_from, int parag_to, int index_to, int selNum = 0 ); + virtual void setSelectionAttributes( int selNum, const TQColor &back, bool invertText ); + virtual void setModified( bool m ); + virtual void resetFormat(); + virtual void setUndoDepth( int d ); + virtual void setFormat( TQTextFormat *f, int flags ); + virtual void ensureCursorVisible(); + virtual void placeCursor( const TQPoint &pos, TQTextCursor *c = 0 ); + virtual void moveCursor( CursorAction action, bool select ); + virtual void doKeyboardAction( KeyboardAction action ); + virtual void removeSelectedText( int selNum = 0 ); + virtual void removeSelection( int selNum = 0 ); + virtual void setCurrentFont( const TQFont &f ); + virtual void setOverwriteMode( bool b ) { overWrite = b; } + + virtual void scrollToBottom(); + + void insert( const TQString &text, uint insertionFlags = CheckNewLines | RemoveSelected ); // ## virtual in 4.0 + + // obsolete + virtual void insert( const TQString &text, bool, bool = TRUE, bool = TRUE ); + + virtual void insertAt( const TQString &text, int para, int index ); + virtual void removeParagraph( int para ); + virtual void insertParagraph( const TQString &text, int para ); + + virtual void setParagraphBackgroundColor( int para, const TQColor &bg ); + virtual void clearParagraphBackground( int para ); + + virtual void setUndoRedoEnabled( bool b ); + void setTabChangesFocus( bool b ); // ### make virtual in 4.0 + +#ifdef QT_TEXTEDIT_OPTIMIZATION + void polish(); + void setMaxLogLines( int numLines ); + int maxLogLines(); +#endif + +signals: + void textChanged(); + void selectionChanged(); + void copyAvailable( bool ); + void undoAvailable( bool yes ); + void redoAvailable( bool yes ); + void currentFontChanged( const TQFont &f ); + void currentColorChanged( const TQColor &c ); + void currentAlignmentChanged( int a ); + void currentVerticalAlignmentChanged( VerticalAlignment a ); + void cursorPositionChanged( TQTextCursor *c ); + void cursorPositionChanged( int para, int pos ); + void returnPressed(); + void modificationChanged( bool m ); + void clicked( int parag, int index ); + void doubleClicked( int parag, int index ); + +protected: + void repaintChanged(); + void updateStyles(); + void drawContents( TQPainter *p, int cx, int cy, int cw, int ch ); + bool event( TQEvent *e ); + void keyPressEvent( TQKeyEvent *e ); + void resizeEvent( TQResizeEvent *e ); + void viewportResizeEvent( TQResizeEvent* ); + void contentsMousePressEvent( TQMouseEvent *e ); + void contentsMouseMoveEvent( TQMouseEvent *e ); + void contentsMouseReleaseEvent( TQMouseEvent *e ); + void contentsMouseDoubleClickEvent( TQMouseEvent *e ); +#ifndef QT_NO_WHEELEVENT + void contentsWheelEvent( TQWheelEvent *e ); +#endif + void imStartEvent( TQIMEvent * ); + void imComposeEvent( TQIMEvent * ); + void imEndEvent( TQIMEvent * ); +#ifndef QT_NO_DRAGANDDROP + void contentsDragEnterEvent( TQDragEnterEvent *e ); + void contentsDragMoveEvent( TQDragMoveEvent *e ); + void contentsDragLeaveEvent( TQDragLeaveEvent *e ); + void contentsDropEvent( TQDropEvent *e ); +#endif + void contentsContextMenuEvent( TQContextMenuEvent *e ); + bool focusNextPrevChild( bool next ); + TQTextDocument *document() const; + TQTextCursor *textCursor() const; + void setDocument( TQTextDocument *doc ); + virtual TQPopupMenu *createPopupMenu( const TQPoint& pos ); + virtual TQPopupMenu *createPopupMenu(); + void drawCursor( bool visible ); + + void windowActivationChange( bool ); + +protected slots: + virtual void doChangeInterval(); + void sliderReleased(); // ### make virtual in 4.0 +#if (QT_VERSION >= 0x040000) +#error "Some functions need to be changed to virtual for TQt 4.0" +#endif + +private slots: + void formatMore(); + void doResize(); + void autoScrollTimerDone(); + void blinkCursor(); + void setModified(); + void startDrag(); + void documentWidthChanged( int w ); + void clipboardChanged(); + +private: + struct Q_EXPORT UndoRedoInfo { + enum Type { Invalid, Insert, Delete, Backspace, Return, RemoveSelected, Format, Style, IME }; + + UndoRedoInfo( TQTextDocument *dc ); + ~UndoRedoInfo(); + void clear(); + bool valid() const; + + TQUndoRedoInfoPrivate *d; + int id; + int index; + int eid; + int eindex; + TQTextFormat *format; + int flags; + Type type; + TQTextDocument *doc; + TQByteArray styleInformation; + }; + +private: + void updateCursor( const TQPoint & pos ); + void handleMouseMove( const TQPoint& pos ); + void drawContents( TQPainter * ); + virtual bool linksEnabled() const { return FALSE; } + void init(); + void checkUndoRedoInfo( UndoRedoInfo::Type t ); + void updateCurrentFormat(); + bool handleReadOnlyKeyEvent( TQKeyEvent *e ); + void makeParagVisible( TQTextParagraph *p ); + void normalCopy(); + void copyToClipboard(); +#ifndef QT_NO_MIME + TQCString pickSpecial(TQMimeSource* ms, bool always_ask, const TQPoint&); + TQTextDrag *dragObject( TQWidget *parent = 0 ) const; +#endif +#ifndef QT_NO_MIMECLIPBOARD + void pasteSpecial(const TQPoint&); +#endif + void setFontInternal( const TQFont &f ); + + virtual void emitHighlighted( const TQString & ) {} + virtual void emitLinkClicked( const TQString & ) {} + + void readFormats( TQTextCursor &c1, TQTextCursor &c2, TQTextString &text, bool fillStyles = FALSE ); + void clearUndoRedo(); + void paintDocument( bool drawAll, TQPainter *p, int cx = -1, int cy = -1, int cw = -1, int ch = -1 ); + void moveCursor( CursorAction action ); + void ensureFormatted( TQTextParagraph *p ); + void placeCursor( const TQPoint &pos, TQTextCursor *c, bool link ); + void updateMicroFocusHint(); + +#ifdef QT_TEXTEDIT_OPTIMIZATION + bool checkOptimMode(); + TQString optimText() const; + void optimSetText( const TQString &str ); + void optimAppend( const TQString &str ); + void optimInsert( const TQString &str, int line, int index ); + void optimDrawContents( TQPainter * p, int cx, int cy, int cw, int ch ); + void optimMousePressEvent( TQMouseEvent * e ); + void optimMouseReleaseEvent( TQMouseEvent * e ); + void optimMouseMoveEvent( TQMouseEvent * e ); + int optimCharIndex( const TQString &str, int mx ) const; + void optimSelectAll(); + void optimRemoveSelection(); + void optimSetSelection( int startLine, int startIdx, int endLine, + int endIdx ); + bool optimHasSelection() const; + TQString optimSelectedText() const; + bool optimFind( const TQString & str, bool, bool, bool, int *, int * ); + void optimParseTags( TQString * str, int lineNo = -1, int indexOffset = 0 ); + TQTextEditOptimPrivate::Tag * optimPreviousLeftTag( int line ); + void optimSetTextFormat( TQTextDocument *, TQTextCursor *, TQTextFormat * f, + int, int, TQTextEditOptimPrivate::Tag * t ); + TQTextEditOptimPrivate::Tag * optimAppendTag( int index, const TQString & tag ); + TQTextEditOptimPrivate::Tag * optimInsertTag( int line, int index, const TQString & tag ); + void optimCheckLimit( const TQString& str ); + bool optimHasBoldMetrics( int line ); + +private slots: + void optimDoAutoScroll(); +#endif // QT_TEXTEDIT_OPTIMIZATION + +private: +#ifndef QT_NO_CLIPBOARD + void pasteSubType( const TQCString &subtype, TQMimeSource *m ); +#endif + +private: + TQTextDocument *doc; + TQTextCursor *cursor; + TQTimer *formatTimer, *scrollTimer, *changeIntervalTimer, *blinkTimer, *dragStartTimer; + TQTextParagraph *lastFormatted; + int interval; + UndoRedoInfo undoRedoInfo; + TQTextFormat *currentFormat; + int currentAlignment; + TQPoint oldMousePos, mousePos; + TQPoint dragStartPos; + TQString onLink; + WordWrap wrapMode; + WrapPolicy wPolicy; + int wrapWidth; + TQString pressedLink; + TQTextEditPrivate *d; + bool inDoubleClick : 1; + bool mousePressed : 1; + bool cursorVisible : 1; + bool blinkCursorVisible : 1; + bool readOnly : 1; + bool modified : 1; + bool mightStartDrag : 1; + bool inDnD : 1; + bool readonly : 1; + bool undoEnabled : 1; + bool overWrite : 1; + +private: // Disabled copy constructor and operator= +#if defined(Q_DISABLE_COPY) + TQTextEdit( const TQTextEdit & ); + TQTextEdit &operator=( const TQTextEdit & ); +#endif +}; + +inline TQTextDocument *TQTextEdit::document() const +{ + return doc; +} + +inline TQTextCursor *TQTextEdit::textCursor() const +{ + return cursor; +} + +inline void TQTextEdit::setCurrentFont( const TQFont &f ) +{ + TQTextEdit::setFontInternal( f ); +} + +#endif //QT_NO_TEXTEDIT +#endif //TQTEXTVIEW_H +</pre> +<!-- eof --> +<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>TQt 3.3.8</div> +</table></div></address></body> +</html> |