/usr/include/ksysguard/KTextEditVT.h is in kde-workspace-dev 4:4.8.4-6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | /*
KSysGuard, the KDE System Guard
Copyright (c) 2008 John Tapsell <tapsell@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.
*/
#ifndef _KTextEditVT_h_
#define _KTextEditVT_h_
#include <QtGui/QTextEdit>
#include <kdemacros.h>
/*
* \class KTextEditVT
* \brief The KTextEditVT class provides a widget that is used to edit and display
* both plain and rich text with the additional function of being able to
* programmatically append VT100 formatted text. For example to display the output
* from console programs.
*
* This class can be used to display the output of VT100 formatted text with
* ANSI escape code - for example output from the command 'ls --color'.
*
* Only a very limited number of ansi escapes sequences will have an affect. Unrecognised
* ansi escape sequences will be ignored and not displayed. Patches are welcome to support
* more of the sequences.
*
* This output can be then be inserted at the current cursor position by calling
* insertVTText(string);
*
* For example:
*
* \code
* insertVTText(QString("Hi") + QChar(08) + "ello");
* \endcode
*
* will insert the text "Hello" at the current character position.
* (Character 08 is the literal backspace character. Treated as equivalent to character 127)
*/
class KDE_EXPORT KTextEditVT : public QTextEdit
{
Q_OBJECT
Q_PROPERTY( bool parseAnsiEscapeCodes READ parseAnsiEscapeCodes WRITE setParseAnsiEscapeCodes )
public:
KTextEditVT(QWidget* parent);
/** Whether to parse ANSI display code. If turned off the escape sequence will be shown literally. */
bool parseAnsiEscapeCodes() const;
public Q_SLOTS:
/** Set whether to parse ANSI display code. If turned off the escape sequence will be shown literally. */
void setParseAnsiEscapeCodes(bool displayall);
/** Insert the given string at the current position based on the current state.
* This is interpreted in a VT100 encoding. Backspace and delete will delete the previous character,
* escape sequences can move the cursor and set the current color etc.
*
* This just calls insertVTChar for each character in the string
*/
void insertVTText(const QByteArray & string);
/** Insert the given string at the current position based on the current state.
* This is interpreted in a VT100 encoding. Backspace and delete will delete the previous character,
* escape sequences can move the cursor and set the current color etc.
*
* This just calls insertVTChar for each character in the string
*/
void insertVTText(const QString & string);
/** Insert the given character at the current position based on the current state.
* This is interpreted in a VT100 encoding. Backspace and delete will delete the previous character,
* escape sequences can move the cursor and set the current color etc.
*/
void insertVTChar(const QChar & c);
private:
bool mParseAnsi;
bool escape_sequence;
bool escape_CSI;
bool escape_OSC;
int escape_number1;
int escape_number2;
bool escape_number_seperator;
QChar escape_code;
};
#endif
|