|
|
|
@ -70,7 +70,7 @@ class ScreenWindow;
|
|
|
|
* A widget which displays output from a terminal emulation and sends input keypresses and mouse activity
|
|
|
|
* A widget which displays output from a terminal emulation and sends input keypresses and mouse activity
|
|
|
|
* to the terminal.
|
|
|
|
* to the terminal.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* When the terminal emulation receives new output from the program running in the terminal,
|
|
|
|
* When the terminal emulation receives new output from the program running in the terminal,
|
|
|
|
* it will update the display by calling updateImage().
|
|
|
|
* it will update the display by calling updateImage().
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* TODO More documentation
|
|
|
|
* TODO More documentation
|
|
|
|
@ -102,25 +102,25 @@ public:
|
|
|
|
/** Sets the opacity of the terminal display. */
|
|
|
|
/** Sets the opacity of the terminal display. */
|
|
|
|
void setOpacity(qreal opacity);
|
|
|
|
void setOpacity(qreal opacity);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* This enum describes the location where the scroll bar is positioned in the display widget.
|
|
|
|
* This enum describes the location where the scroll bar is positioned in the display widget.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
enum ScrollBarPosition
|
|
|
|
enum ScrollBarPosition
|
|
|
|
{
|
|
|
|
{
|
|
|
|
/** Do not show the scroll bar. */
|
|
|
|
/** Do not show the scroll bar. */
|
|
|
|
NoScrollBar=0,
|
|
|
|
NoScrollBar=0,
|
|
|
|
/** Show the scroll bar on the left side of the display. */
|
|
|
|
/** Show the scroll bar on the left side of the display. */
|
|
|
|
ScrollBarLeft=1,
|
|
|
|
ScrollBarLeft=1,
|
|
|
|
/** Show the scroll bar on the right side of the display. */
|
|
|
|
/** Show the scroll bar on the right side of the display. */
|
|
|
|
ScrollBarRight=2
|
|
|
|
ScrollBarRight=2
|
|
|
|
};
|
|
|
|
};
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Specifies whether the terminal display has a vertical scroll bar, and if so whether it
|
|
|
|
* Specifies whether the terminal display has a vertical scroll bar, and if so whether it
|
|
|
|
* is shown on the left or right side of the display.
|
|
|
|
* is shown on the left or right side of the display.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setScrollBarPosition(ScrollBarPosition position);
|
|
|
|
void setScrollBarPosition(ScrollBarPosition position);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the current position and range of the display's scroll bar.
|
|
|
|
* Sets the current position and range of the display's scroll bar.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* @param cursor The position of the scroll bar's thumb.
|
|
|
|
* @param cursor The position of the scroll bar's thumb.
|
|
|
|
@ -133,7 +133,7 @@ public:
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void scrollToEnd();
|
|
|
|
void scrollToEnd();
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns the display's filter chain. When the image for the display is updated,
|
|
|
|
* Returns the display's filter chain. When the image for the display is updated,
|
|
|
|
* the text is passed through each filter in the chain. Each filter can define
|
|
|
|
* the text is passed through each filter in the chain. Each filter can define
|
|
|
|
* hotspots which correspond to certain strings (such as URLs or particular words).
|
|
|
|
* hotspots which correspond to certain strings (such as URLs or particular words).
|
|
|
|
@ -146,11 +146,11 @@ public:
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
FilterChain* filterChain() const;
|
|
|
|
FilterChain* filterChain() const;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Updates the filters in the display's filter chain. This will cause
|
|
|
|
* Updates the filters in the display's filter chain. This will cause
|
|
|
|
* the hotspots to be updated to match the current image.
|
|
|
|
* the hotspots to be updated to match the current image.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* WARNING: This function can be expensive depending on the
|
|
|
|
* WARNING: This function can be expensive depending on the
|
|
|
|
* image size and number of filters in the filterChain()
|
|
|
|
* image size and number of filters in the filterChain()
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* TODO - This API does not really allow efficient usage. Revise it so
|
|
|
|
* TODO - This API does not really allow efficient usage. Revise it so
|
|
|
|
@ -159,10 +159,10 @@ public:
|
|
|
|
* eg:
|
|
|
|
* eg:
|
|
|
|
* - Area of interest may be known ( eg. mouse cursor hovering
|
|
|
|
* - Area of interest may be known ( eg. mouse cursor hovering
|
|
|
|
* over an area )
|
|
|
|
* over an area )
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void processFilters();
|
|
|
|
void processFilters();
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns a list of menu actions created by the filters for the content
|
|
|
|
* Returns a list of menu actions created by the filters for the content
|
|
|
|
* at the given @p position.
|
|
|
|
* at the given @p position.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
@ -179,9 +179,9 @@ public:
|
|
|
|
void setCtrlDrag(bool enable) { _ctrlDrag=enable; }
|
|
|
|
void setCtrlDrag(bool enable) { _ctrlDrag=enable; }
|
|
|
|
bool ctrlDrag() { return _ctrlDrag; }
|
|
|
|
bool ctrlDrag() { return _ctrlDrag; }
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* This enum describes the methods for selecting text when
|
|
|
|
* This enum describes the methods for selecting text when
|
|
|
|
* the user triple-clicks within the display.
|
|
|
|
* the user triple-clicks within the display.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
enum TripleClickMode
|
|
|
|
enum TripleClickMode
|
|
|
|
{
|
|
|
|
{
|
|
|
|
@ -190,7 +190,7 @@ public:
|
|
|
|
/** Select from the current cursor position to the end of the line. */
|
|
|
|
/** Select from the current cursor position to the end of the line. */
|
|
|
|
SelectForwardsFromCursor
|
|
|
|
SelectForwardsFromCursor
|
|
|
|
};
|
|
|
|
};
|
|
|
|
/** Sets how the text is selected when the user triple clicks within the display. */
|
|
|
|
/** Sets how the text is selected when the user triple clicks within the display. */
|
|
|
|
void setTripleClickMode(TripleClickMode mode) { _tripleClickMode = mode; }
|
|
|
|
void setTripleClickMode(TripleClickMode mode) { _tripleClickMode = mode; }
|
|
|
|
/** See setTripleClickSelectionMode() */
|
|
|
|
/** See setTripleClickSelectionMode() */
|
|
|
|
TripleClickMode tripleClickMode() { return _tripleClickMode; }
|
|
|
|
TripleClickMode tripleClickMode() { return _tripleClickMode; }
|
|
|
|
@ -208,22 +208,22 @@ public:
|
|
|
|
{
|
|
|
|
{
|
|
|
|
/** A rectangular block which covers the entire area of the cursor character. */
|
|
|
|
/** A rectangular block which covers the entire area of the cursor character. */
|
|
|
|
BlockCursor,
|
|
|
|
BlockCursor,
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* A single flat line which occupies the space at the bottom of the cursor
|
|
|
|
* A single flat line which occupies the space at the bottom of the cursor
|
|
|
|
* character's area.
|
|
|
|
* character's area.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
UnderlineCursor,
|
|
|
|
UnderlineCursor,
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* An cursor shaped like the capital letter 'I', similar to the IBeam
|
|
|
|
* An cursor shaped like the capital letter 'I', similar to the IBeam
|
|
|
|
* cursor used in Qt/KDE text editors.
|
|
|
|
* cursor used in Qt/KDE text editors.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
IBeamCursor
|
|
|
|
IBeamCursor
|
|
|
|
};
|
|
|
|
};
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the shape of the keyboard cursor. This is the cursor drawn
|
|
|
|
* Sets the shape of the keyboard cursor. This is the cursor drawn
|
|
|
|
* at the position in the terminal where keyboard input will appear.
|
|
|
|
* at the position in the terminal where keyboard input will appear.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* In addition the terminal display widget also has a cursor for
|
|
|
|
* In addition the terminal display widget also has a cursor for
|
|
|
|
* the mouse pointer, which can be set using the QWidget::setCursor()
|
|
|
|
* the mouse pointer, which can be set using the QWidget::setCursor()
|
|
|
|
* method.
|
|
|
|
* method.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
@ -236,7 +236,7 @@ public:
|
|
|
|
KeyboardCursorShape keyboardCursorShape() const;
|
|
|
|
KeyboardCursorShape keyboardCursorShape() const;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the color used to draw the keyboard cursor.
|
|
|
|
* Sets the color used to draw the keyboard cursor.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* The keyboard cursor defaults to using the foreground color of the character
|
|
|
|
* The keyboard cursor defaults to using the foreground color of the character
|
|
|
|
* underneath it.
|
|
|
|
* underneath it.
|
|
|
|
@ -250,10 +250,10 @@ public:
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setKeyboardCursorColor(bool useForegroundColor , const QColor& color);
|
|
|
|
void setKeyboardCursorColor(bool useForegroundColor , const QColor& color);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns the color of the keyboard cursor, or an invalid color if the keyboard
|
|
|
|
* Returns the color of the keyboard cursor, or an invalid color if the keyboard
|
|
|
|
* cursor color is set to change according to the foreground color of the character
|
|
|
|
* cursor color is set to change according to the foreground color of the character
|
|
|
|
* underneath it.
|
|
|
|
* underneath it.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
QColor keyboardCursorColor() const;
|
|
|
|
QColor keyboardCursorColor() const;
|
|
|
|
|
|
|
|
|
|
|
|
@ -278,19 +278,19 @@ public:
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
int fontHeight() { return _fontHeight; }
|
|
|
|
int fontHeight() { return _fontHeight; }
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns the width of the characters in the display.
|
|
|
|
* Returns the width of the characters in the display.
|
|
|
|
* This assumes the use of a fixed-width font.
|
|
|
|
* This assumes the use of a fixed-width font.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
int fontWidth() { return _fontWidth; }
|
|
|
|
int fontWidth() { return _fontWidth; }
|
|
|
|
|
|
|
|
|
|
|
|
void setSize(int cols, int lins);
|
|
|
|
void setSize(int cols, int lins);
|
|
|
|
void setFixedSize(int cols, int lins);
|
|
|
|
void setFixedSize(int cols, int lins);
|
|
|
|
|
|
|
|
|
|
|
|
// reimplemented
|
|
|
|
// reimplemented
|
|
|
|
QSize sizeHint() const;
|
|
|
|
QSize sizeHint() const;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets which characters, in addition to letters and numbers,
|
|
|
|
* Sets which characters, in addition to letters and numbers,
|
|
|
|
* are regarded as being part of a word for the purposes
|
|
|
|
* are regarded as being part of a word for the purposes
|
|
|
|
* of selecting words in the display by double clicking on them.
|
|
|
|
* of selecting words in the display by double clicking on them.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
@ -301,26 +301,26 @@ public:
|
|
|
|
* of a word ( in addition to letters and numbers ).
|
|
|
|
* of a word ( in addition to letters and numbers ).
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setWordCharacters(const QString& wc);
|
|
|
|
void setWordCharacters(const QString& wc);
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns the characters which are considered part of a word for the
|
|
|
|
* Returns the characters which are considered part of a word for the
|
|
|
|
* purpose of selecting words in the display with the mouse.
|
|
|
|
* purpose of selecting words in the display with the mouse.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* @see setWordCharacters()
|
|
|
|
* @see setWordCharacters()
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
QString wordCharacters() { return _wordCharacters; }
|
|
|
|
QString wordCharacters() { return _wordCharacters; }
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the type of effect used to alert the user when a 'bell' occurs in the
|
|
|
|
* Sets the type of effect used to alert the user when a 'bell' occurs in the
|
|
|
|
* terminal session.
|
|
|
|
* terminal session.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* The terminal session can trigger the bell effect by calling bell() with
|
|
|
|
* The terminal session can trigger the bell effect by calling bell() with
|
|
|
|
* the alert message.
|
|
|
|
* the alert message.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setBellMode(int mode);
|
|
|
|
void setBellMode(int mode);
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns the type of effect used to alert the user when a 'bell' occurs in
|
|
|
|
* Returns the type of effect used to alert the user when a 'bell' occurs in
|
|
|
|
* the terminal session.
|
|
|
|
* the terminal session.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* See setBellMode()
|
|
|
|
* See setBellMode()
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
int bellMode() { return _bellMode; }
|
|
|
|
int bellMode() { return _bellMode; }
|
|
|
|
@ -331,23 +331,23 @@ public:
|
|
|
|
* session.
|
|
|
|
* session.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
enum BellMode
|
|
|
|
enum BellMode
|
|
|
|
{
|
|
|
|
{
|
|
|
|
/** A system beep. */
|
|
|
|
/** A system beep. */
|
|
|
|
SystemBeepBell=0,
|
|
|
|
SystemBeepBell=0,
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* KDE notification. This may play a sound, show a passive popup
|
|
|
|
* KDE notification. This may play a sound, show a passive popup
|
|
|
|
* or perform some other action depending on the user's settings.
|
|
|
|
* or perform some other action depending on the user's settings.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
NotifyBell=1,
|
|
|
|
NotifyBell=1,
|
|
|
|
/** A silent, visual bell (eg. inverting the display's colors briefly) */
|
|
|
|
/** A silent, visual bell (eg. inverting the display's colors briefly) */
|
|
|
|
VisualBell=2,
|
|
|
|
VisualBell=2,
|
|
|
|
/** No bell effects */
|
|
|
|
/** No bell effects */
|
|
|
|
NoBell=3
|
|
|
|
NoBell=3
|
|
|
|
};
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
void setSelection(const QString &t);
|
|
|
|
void setSelection(const QString &t);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Reimplemented. Has no effect. Use setVTFont() to change the font
|
|
|
|
* Reimplemented. Has no effect. Use setVTFont() to change the font
|
|
|
|
* used to draw characters in the display.
|
|
|
|
* used to draw characters in the display.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
@ -356,9 +356,9 @@ public:
|
|
|
|
/** Returns the font used to draw characters in the display */
|
|
|
|
/** Returns the font used to draw characters in the display */
|
|
|
|
QFont getVTFont() { return font(); }
|
|
|
|
QFont getVTFont() { return font(); }
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the font used to draw the display. Has no effect if @p font
|
|
|
|
* Sets the font used to draw the display. Has no effect if @p font
|
|
|
|
* is larger than the size of the display itself.
|
|
|
|
* is larger than the size of the display itself.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setVTFont(const QFont& font);
|
|
|
|
void setVTFont(const QFont& font);
|
|
|
|
|
|
|
|
|
|
|
|
@ -367,7 +367,7 @@ public:
|
|
|
|
* is enabled or not. Defaults to enabled.
|
|
|
|
* is enabled or not. Defaults to enabled.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
static void setAntialias( bool antialias ) { _antialiasText = antialias; }
|
|
|
|
static void setAntialias( bool antialias ) { _antialiasText = antialias; }
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns true if anti-aliasing of text in the terminal is enabled.
|
|
|
|
* Returns true if anti-aliasing of text in the terminal is enabled.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
static bool antialias() { return _antialiasText; }
|
|
|
|
static bool antialias() { return _antialiasText; }
|
|
|
|
@ -381,20 +381,20 @@ public:
|
|
|
|
* Returns true if characters with intense colors are rendered in bold.
|
|
|
|
* Returns true if characters with intense colors are rendered in bold.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
bool getBoldIntense() { return _boldIntense; }
|
|
|
|
bool getBoldIntense() { return _boldIntense; }
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets whether or not the current height and width of the
|
|
|
|
* Sets whether or not the current height and width of the
|
|
|
|
* terminal in lines and columns is displayed whilst the widget
|
|
|
|
* terminal in lines and columns is displayed whilst the widget
|
|
|
|
* is being resized.
|
|
|
|
* is being resized.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setTerminalSizeHint(bool on) { _terminalSizeHint=on; }
|
|
|
|
void setTerminalSizeHint(bool on) { _terminalSizeHint=on; }
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns whether or not the current height and width of
|
|
|
|
* Returns whether or not the current height and width of
|
|
|
|
* the terminal in lines and columns is displayed whilst the widget
|
|
|
|
* the terminal in lines and columns is displayed whilst the widget
|
|
|
|
* is being resized.
|
|
|
|
* is being resized.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
bool terminalSizeHint() { return _terminalSizeHint; }
|
|
|
|
bool terminalSizeHint() { return _terminalSizeHint; }
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets whether the terminal size display is shown briefly
|
|
|
|
* Sets whether the terminal size display is shown briefly
|
|
|
|
* after the widget is first shown.
|
|
|
|
* after the widget is first shown.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
@ -425,36 +425,36 @@ public:
|
|
|
|
ScreenWindow* screenWindow() const;
|
|
|
|
ScreenWindow* screenWindow() const;
|
|
|
|
|
|
|
|
|
|
|
|
static bool HAVE_TRANSPARENCY;
|
|
|
|
static bool HAVE_TRANSPARENCY;
|
|
|
|
|
|
|
|
|
|
|
|
void setMotionAfterPasting(MotionAfterPasting action);
|
|
|
|
void setMotionAfterPasting(MotionAfterPasting action);
|
|
|
|
int motionAfterPasting();
|
|
|
|
int motionAfterPasting();
|
|
|
|
|
|
|
|
|
|
|
|
// maps a point on the widget to the position ( ie. line and column )
|
|
|
|
// maps a point on the widget to the position ( ie. line and column )
|
|
|
|
// of the character at that point.
|
|
|
|
// of the character at that point.
|
|
|
|
void getCharacterPosition(const QPoint& widgetPoint,int& line,int& column) const;
|
|
|
|
void getCharacterPosition(const QPoint& widgetPoint,int& line,int& column) const;
|
|
|
|
|
|
|
|
|
|
|
|
public slots:
|
|
|
|
public slots:
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Causes the terminal display to fetch the latest character image from the associated
|
|
|
|
* Causes the terminal display to fetch the latest character image from the associated
|
|
|
|
* terminal screen ( see setScreenWindow() ) and redraw the display.
|
|
|
|
* terminal screen ( see setScreenWindow() ) and redraw the display.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void updateImage();
|
|
|
|
void updateImage();
|
|
|
|
|
|
|
|
|
|
|
|
/** Essentially calles processFilters().
|
|
|
|
/** Essentially calles processFilters().
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void updateFilters();
|
|
|
|
void updateFilters();
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Causes the terminal display to fetch the latest line status flags from the
|
|
|
|
* Causes the terminal display to fetch the latest line status flags from the
|
|
|
|
* associated terminal screen ( see setScreenWindow() ).
|
|
|
|
* associated terminal screen ( see setScreenWindow() ).
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void updateLineProperties();
|
|
|
|
void updateLineProperties();
|
|
|
|
|
|
|
|
|
|
|
|
/** Copies the selected text to the clipboard. */
|
|
|
|
/** Copies the selected text to the clipboard. */
|
|
|
|
void copyClipboard();
|
|
|
|
void copyClipboard();
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Pastes the content of the clipboard into the
|
|
|
|
* Pastes the content of the clipboard into the
|
|
|
|
* display.
|
|
|
|
* display.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void pasteClipboard();
|
|
|
|
void pasteClipboard();
|
|
|
|
@ -464,26 +464,26 @@ public slots:
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void pasteSelection();
|
|
|
|
void pasteSelection();
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Changes whether the flow control warning box should be shown when the flow control
|
|
|
|
* Changes whether the flow control warning box should be shown when the flow control
|
|
|
|
* stop key (Ctrl+S) are pressed.
|
|
|
|
* stop key (Ctrl+S) are pressed.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setFlowControlWarningEnabled(bool enabled);
|
|
|
|
void setFlowControlWarningEnabled(bool enabled);
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Returns true if the flow control warning box is enabled.
|
|
|
|
* Returns true if the flow control warning box is enabled.
|
|
|
|
* See outputSuspended() and setFlowControlWarningEnabled()
|
|
|
|
* See outputSuspended() and setFlowControlWarningEnabled()
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
bool flowControlWarningEnabled() const
|
|
|
|
bool flowControlWarningEnabled() const
|
|
|
|
{ return _flowControlWarningEnabled; }
|
|
|
|
{ return _flowControlWarningEnabled; }
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Causes the widget to display or hide a message informing the user that terminal
|
|
|
|
* Causes the widget to display or hide a message informing the user that terminal
|
|
|
|
* output has been suspended (by using the flow control key combination Ctrl+S)
|
|
|
|
* output has been suspended (by using the flow control key combination Ctrl+S)
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* @param suspended True if terminal output has been suspended and the warning message should
|
|
|
|
* @param suspended True if terminal output has been suspended and the warning message should
|
|
|
|
* be shown or false to indicate that terminal output has been resumed and that
|
|
|
|
* be shown or false to indicate that terminal output has been resumed and that
|
|
|
|
* the warning message should disappear.
|
|
|
|
* the warning message should disappear.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void outputSuspended(bool suspended);
|
|
|
|
void outputSuspended(bool suspended);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
@ -493,7 +493,7 @@ public slots:
|
|
|
|
* If this is set to true, mouse signals will be emitted by the view when the user clicks, drags
|
|
|
|
* If this is set to true, mouse signals will be emitted by the view when the user clicks, drags
|
|
|
|
* or otherwise moves the mouse inside the view.
|
|
|
|
* or otherwise moves the mouse inside the view.
|
|
|
|
* The user interaction needed to create selections will also change, and the user will be required
|
|
|
|
* The user interaction needed to create selections will also change, and the user will be required
|
|
|
|
* to hold down the shift key to create a selection or perform other mouse activities inside the
|
|
|
|
* to hold down the shift key to create a selection or perform other mouse activities inside the
|
|
|
|
* view area - since the program running in the terminal is being allowed to handle normal mouse
|
|
|
|
* view area - since the program running in the terminal is being allowed to handle normal mouse
|
|
|
|
* events itself.
|
|
|
|
* events itself.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
@ -501,28 +501,28 @@ public slots:
|
|
|
|
* or false otherwise.
|
|
|
|
* or false otherwise.
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setUsesMouse(bool usesMouse);
|
|
|
|
void setUsesMouse(bool usesMouse);
|
|
|
|
|
|
|
|
|
|
|
|
/** See setUsesMouse() */
|
|
|
|
/** See setUsesMouse() */
|
|
|
|
bool usesMouse() const;
|
|
|
|
bool usesMouse() const;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Shows a notification that a bell event has occurred in the terminal.
|
|
|
|
* Shows a notification that a bell event has occurred in the terminal.
|
|
|
|
* TODO: More documentation here
|
|
|
|
* TODO: More documentation here
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void bell(const QString& message);
|
|
|
|
void bell(const QString& message);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the background of the display to the specified color.
|
|
|
|
* Sets the background of the display to the specified color.
|
|
|
|
* @see setColorTable(), setForegroundColor()
|
|
|
|
* @see setColorTable(), setForegroundColor()
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setBackgroundColor(const QColor& color);
|
|
|
|
void setBackgroundColor(const QColor& color);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Sets the text of the display to the specified color.
|
|
|
|
* Sets the text of the display to the specified color.
|
|
|
|
* @see setColorTable(), setBackgroundColor()
|
|
|
|
* @see setColorTable(), setBackgroundColor()
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void setForegroundColor(const QColor& color);
|
|
|
|
void setForegroundColor(const QColor& color);
|
|
|
|
|
|
|
|
|
|
|
|
void selectionChanged();
|
|
|
|
void selectionChanged();
|
|
|
|
|
|
|
|
|
|
|
|
signals:
|
|
|
|
signals:
|
|
|
|
@ -532,7 +532,7 @@ signals:
|
|
|
|
*/
|
|
|
|
*/
|
|
|
|
void keyPressedSignal(QKeyEvent *e);
|
|
|
|
void keyPressedSignal(QKeyEvent *e);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* A mouse event occurred.
|
|
|
|
* A mouse event occurred.
|
|
|
|
* @param button The mouse button (0 for left button, 1 for middle button, 2 for right button, 3 for release)
|
|
|
|
* @param button The mouse button (0 for left button, 1 for middle button, 2 for right button, 3 for release)
|
|
|
|
* @param column The character column where the event occurred
|
|
|
|
* @param column The character column where the event occurred
|
|
|
|
@ -543,7 +543,7 @@ signals:
|
|
|
|
void changedFontMetricSignal(int height, int width);
|
|
|
|
void changedFontMetricSignal(int height, int width);
|
|
|
|
void changedContentSizeSignal(int height, int width);
|
|
|
|
void changedContentSizeSignal(int height, int width);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* Emitted when the user right clicks on the display, or right-clicks with the Shift
|
|
|
|
* Emitted when the user right clicks on the display, or right-clicks with the Shift
|
|
|
|
* key held down if usesMouse() is true.
|
|
|
|
* key held down if usesMouse() is true.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
@ -552,9 +552,9 @@ signals:
|
|
|
|
void configureRequest(const QPoint& position);
|
|
|
|
void configureRequest(const QPoint& position);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
/**
|
|
|
|
* When a shortcut which is also a valid terminal key sequence is pressed while
|
|
|
|
* When a shortcut which is also a valid terminal key sequence is pressed while
|
|
|
|
* the terminal widget has focus, this signal is emitted to allow the host to decide
|
|
|
|
* the terminal widget has focus, this signal is emitted to allow the host to decide
|
|
|
|
* whether the shortcut should be overridden.
|
|
|
|
* whether the shortcut should be overridden.
|
|
|
|
* When the shortcut is overridden, the key sequence will be sent to the terminal emulation instead
|
|
|
|
* When the shortcut is overridden, the key sequence will be sent to the terminal emulation instead
|
|
|
|
* and the action associated with the shortcut will not be triggered.
|
|
|
|
* and the action associated with the shortcut will not be triggered.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
@ -564,13 +564,14 @@ signals:
|
|
|
|
|
|
|
|
|
|
|
|
void isBusySelecting(bool);
|
|
|
|
void isBusySelecting(bool);
|
|
|
|
void sendStringToEmu(const char*);
|
|
|
|
void sendStringToEmu(const char*);
|
|
|
|
|
|
|
|
|
|
|
|
// qtermwidget signals
|
|
|
|
// qtermwidget signals
|
|
|
|
void copyAvailable(bool);
|
|
|
|
void copyAvailable(bool);
|
|
|
|
void termGetFocus();
|
|
|
|
void termGetFocus();
|
|
|
|
void termLostFocus();
|
|
|
|
void termLostFocus();
|
|
|
|
|
|
|
|
|
|
|
|
void notifyBell(const QString&);
|
|
|
|
void notifyBell(const QString&);
|
|
|
|
|
|
|
|
void usesMouseChanged();
|
|
|
|
|
|
|
|
|
|
|
|
protected:
|
|
|
|
protected:
|
|
|
|
virtual bool event( QEvent * );
|
|
|
|
virtual bool event( QEvent * );
|
|
|
|
@ -593,7 +594,7 @@ protected:
|
|
|
|
virtual void wheelEvent( QWheelEvent* );
|
|
|
|
virtual void wheelEvent( QWheelEvent* );
|
|
|
|
|
|
|
|
|
|
|
|
virtual bool focusNextPrevChild( bool next );
|
|
|
|
virtual bool focusNextPrevChild( bool next );
|
|
|
|
|
|
|
|
|
|
|
|
// drag and drop
|
|
|
|
// drag and drop
|
|
|
|
virtual void dragEnterEvent(QDragEnterEvent* event);
|
|
|
|
virtual void dragEnterEvent(QDragEnterEvent* event);
|
|
|
|
virtual void dropEvent(QDropEvent* event);
|
|
|
|
virtual void dropEvent(QDropEvent* event);
|
|
|
|
@ -609,7 +610,7 @@ protected:
|
|
|
|
// classifies the 'ch' into one of three categories
|
|
|
|
// classifies the 'ch' into one of three categories
|
|
|
|
// and returns a character to indicate which category it is in
|
|
|
|
// and returns a character to indicate which category it is in
|
|
|
|
//
|
|
|
|
//
|
|
|
|
// - A space (returns ' ')
|
|
|
|
// - A space (returns ' ')
|
|
|
|
// - Part of a word (returns 'a')
|
|
|
|
// - Part of a word (returns 'a')
|
|
|
|
// - Other characters (returns the input character)
|
|
|
|
// - Other characters (returns the input character)
|
|
|
|
QChar charClass(QChar ch) const;
|
|
|
|
QChar charClass(QChar ch) const;
|
|
|
|
@ -627,7 +628,7 @@ protected slots:
|
|
|
|
void scrollBarPositionChanged(int value);
|
|
|
|
void scrollBarPositionChanged(int value);
|
|
|
|
void blinkEvent();
|
|
|
|
void blinkEvent();
|
|
|
|
void blinkCursorEvent();
|
|
|
|
void blinkCursorEvent();
|
|
|
|
|
|
|
|
|
|
|
|
//Renables bell noises and visuals. Used to disable further bells for a short period of time
|
|
|
|
//Renables bell noises and visuals. Used to disable further bells for a short period of time
|
|
|
|
//after emitting the first in a sequence of bell events.
|
|
|
|
//after emitting the first in a sequence of bell events.
|
|
|
|
void enableBell();
|
|
|
|
void enableBell();
|
|
|
|
@ -641,14 +642,19 @@ private:
|
|
|
|
|
|
|
|
|
|
|
|
// -- Drawing helpers --
|
|
|
|
// -- Drawing helpers --
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// determine the width of this text
|
|
|
|
|
|
|
|
int textWidth(int startColumn, int length, int line) const;
|
|
|
|
|
|
|
|
// determine the area that encloses this series of characters
|
|
|
|
|
|
|
|
QRect calculateTextArea(int topLeftX, int topLeftY, int startColumn, int line, int length);
|
|
|
|
|
|
|
|
|
|
|
|
// divides the part of the display specified by 'rect' into
|
|
|
|
// divides the part of the display specified by 'rect' into
|
|
|
|
// fragments according to their colors and styles and calls
|
|
|
|
// fragments according to their colors and styles and calls
|
|
|
|
// drawTextFragment() to draw the fragments
|
|
|
|
// drawTextFragment() to draw the fragments
|
|
|
|
void drawContents(QPainter &paint, const QRect &rect);
|
|
|
|
void drawContents(QPainter &paint, const QRect &rect);
|
|
|
|
// draws a section of text, all the text in this section
|
|
|
|
// draws a section of text, all the text in this section
|
|
|
|
// has a common color and style
|
|
|
|
// has a common color and style
|
|
|
|
void drawTextFragment(QPainter& painter, const QRect& rect,
|
|
|
|
void drawTextFragment(QPainter& painter, const QRect& rect,
|
|
|
|
const QString& text, const Character* style);
|
|
|
|
const QString& text, const Character* style);
|
|
|
|
// draws the background for a text fragment
|
|
|
|
// draws the background for a text fragment
|
|
|
|
// if useOpacitySetting is true then the color's alpha value will be set to
|
|
|
|
// if useOpacitySetting is true then the color's alpha value will be set to
|
|
|
|
// the display's transparency (set with setOpacity()), otherwise the background
|
|
|
|
// the display's transparency (set with setOpacity()), otherwise the background
|
|
|
|
@ -656,13 +662,13 @@ private:
|
|
|
|
void drawBackground(QPainter& painter, const QRect& rect, const QColor& color,
|
|
|
|
void drawBackground(QPainter& painter, const QRect& rect, const QColor& color,
|
|
|
|
bool useOpacitySetting);
|
|
|
|
bool useOpacitySetting);
|
|
|
|
// draws the cursor character
|
|
|
|
// draws the cursor character
|
|
|
|
void drawCursor(QPainter& painter, const QRect& rect , const QColor& foregroundColor,
|
|
|
|
void drawCursor(QPainter& painter, const QRect& rect , const QColor& foregroundColor,
|
|
|
|
const QColor& backgroundColor , bool& invertColors);
|
|
|
|
const QColor& backgroundColor , bool& invertColors);
|
|
|
|
// draws the characters or line graphics in a text fragment
|
|
|
|
// draws the characters or line graphics in a text fragment
|
|
|
|
void drawCharacters(QPainter& painter, const QRect& rect, const QString& text,
|
|
|
|
void drawCharacters(QPainter& painter, const QRect& rect, const QString& text,
|
|
|
|
const Character* style, bool invertCharacterColor);
|
|
|
|
const Character* style, bool invertCharacterColor);
|
|
|
|
// draws a string of line graphics
|
|
|
|
// draws a string of line graphics
|
|
|
|
void drawLineCharString(QPainter& painter, int x, int y,
|
|
|
|
void drawLineCharString(QPainter& painter, int x, int y,
|
|
|
|
const QString& str, const Character* attributes);
|
|
|
|
const QString& str, const Character* attributes);
|
|
|
|
|
|
|
|
|
|
|
|
// draws the preedit string for input methods
|
|
|
|
// draws the preedit string for input methods
|
|
|
|
@ -670,7 +676,7 @@ private:
|
|
|
|
|
|
|
|
|
|
|
|
// --
|
|
|
|
// --
|
|
|
|
|
|
|
|
|
|
|
|
// maps an area in the character image to an area on the widget
|
|
|
|
// maps an area in the character image to an area on the widget
|
|
|
|
QRect imageToWidget(const QRect& imageArea) const;
|
|
|
|
QRect imageToWidget(const QRect& imageArea) const;
|
|
|
|
|
|
|
|
|
|
|
|
// the area where the preedit string for input methods will be draw
|
|
|
|
// the area where the preedit string for input methods will be draw
|
|
|
|
@ -680,8 +686,8 @@ private:
|
|
|
|
// current size in columns and lines
|
|
|
|
// current size in columns and lines
|
|
|
|
void showResizeNotification();
|
|
|
|
void showResizeNotification();
|
|
|
|
|
|
|
|
|
|
|
|
// scrolls the image by a number of lines.
|
|
|
|
// scrolls the image by a number of lines.
|
|
|
|
// 'lines' may be positive ( to scroll the image down )
|
|
|
|
// 'lines' may be positive ( to scroll the image down )
|
|
|
|
// or negative ( to scroll the image up )
|
|
|
|
// or negative ( to scroll the image up )
|
|
|
|
// 'region' is the part of the image to scroll - currently only
|
|
|
|
// 'region' is the part of the image to scroll - currently only
|
|
|
|
// the top, bottom and height of 'region' are taken into account,
|
|
|
|
// the top, bottom and height of 'region' are taken into account,
|
|
|
|
@ -692,7 +698,7 @@ private:
|
|
|
|
void propagateSize();
|
|
|
|
void propagateSize();
|
|
|
|
void updateImageSize();
|
|
|
|
void updateImageSize();
|
|
|
|
void makeImage();
|
|
|
|
void makeImage();
|
|
|
|
|
|
|
|
|
|
|
|
void paintFilters(QPainter& painter);
|
|
|
|
void paintFilters(QPainter& painter);
|
|
|
|
|
|
|
|
|
|
|
|
// returns a region covering all of the areas of the widget which contain
|
|
|
|
// returns a region covering all of the areas of the widget which contain
|
|
|
|
@ -708,7 +714,7 @@ private:
|
|
|
|
bool handleShortcutOverrideEvent(QKeyEvent* event);
|
|
|
|
bool handleShortcutOverrideEvent(QKeyEvent* event);
|
|
|
|
|
|
|
|
|
|
|
|
// the window onto the terminal screen which this display
|
|
|
|
// the window onto the terminal screen which this display
|
|
|
|
// is currently showing.
|
|
|
|
// is currently showing.
|
|
|
|
QPointer<ScreenWindow> _screenWindow;
|
|
|
|
QPointer<ScreenWindow> _screenWindow;
|
|
|
|
|
|
|
|
|
|
|
|
bool _allowBell;
|
|
|
|
bool _allowBell;
|
|
|
|
@ -726,7 +732,7 @@ private:
|
|
|
|
|
|
|
|
|
|
|
|
int _lines; // the number of lines that can be displayed in the widget
|
|
|
|
int _lines; // the number of lines that can be displayed in the widget
|
|
|
|
int _columns; // the number of columns that can be displayed in the widget
|
|
|
|
int _columns; // the number of columns that can be displayed in the widget
|
|
|
|
|
|
|
|
|
|
|
|
int _usedLines; // the number of lines that are actually being used, this will be less
|
|
|
|
int _usedLines; // the number of lines that are actually being used, this will be less
|
|
|
|
// than 'lines' if the character image provided with setImage() is smaller
|
|
|
|
// than 'lines' if the character image provided with setImage() is smaller
|
|
|
|
// than the maximum image size which can be displayed
|
|
|
|
// than the maximum image size which can be displayed
|
|
|
|
@ -734,7 +740,7 @@ private:
|
|
|
|
int _usedColumns; // the number of columns that are actually being used, this will be less
|
|
|
|
int _usedColumns; // the number of columns that are actually being used, this will be less
|
|
|
|
// than 'columns' if the character image provided with setImage() is smaller
|
|
|
|
// than 'columns' if the character image provided with setImage() is smaller
|
|
|
|
// than the maximum image size which can be displayed
|
|
|
|
// than the maximum image size which can be displayed
|
|
|
|
|
|
|
|
|
|
|
|
int _contentHeight;
|
|
|
|
int _contentHeight;
|
|
|
|
int _contentWidth;
|
|
|
|
int _contentWidth;
|
|
|
|
Character* _image; // [lines][columns]
|
|
|
|
Character* _image; // [lines][columns]
|
|
|
|
@ -793,14 +799,14 @@ private:
|
|
|
|
|
|
|
|
|
|
|
|
//widgets related to the warning message that appears when the user presses Ctrl+S to suspend
|
|
|
|
//widgets related to the warning message that appears when the user presses Ctrl+S to suspend
|
|
|
|
//terminal output - informing them what has happened and how to resume output
|
|
|
|
//terminal output - informing them what has happened and how to resume output
|
|
|
|
QLabel* _outputSuspendedLabel;
|
|
|
|
QLabel* _outputSuspendedLabel;
|
|
|
|
|
|
|
|
|
|
|
|
uint _lineSpacing;
|
|
|
|
uint _lineSpacing;
|
|
|
|
|
|
|
|
|
|
|
|
bool _colorsInverted; // true during visual bell
|
|
|
|
bool _colorsInverted; // true during visual bell
|
|
|
|
|
|
|
|
|
|
|
|
QSize _size;
|
|
|
|
QSize _size;
|
|
|
|
|
|
|
|
|
|
|
|
QRgb _blendColor;
|
|
|
|
QRgb _blendColor;
|
|
|
|
|
|
|
|
|
|
|
|
// list of filters currently applied to the display. used for links and
|
|
|
|
// list of filters currently applied to the display. used for links and
|
|
|
|
@ -812,7 +818,7 @@ private:
|
|
|
|
|
|
|
|
|
|
|
|
// custom cursor color. if this is invalid then the foreground
|
|
|
|
// custom cursor color. if this is invalid then the foreground
|
|
|
|
// color of the character under the cursor is used
|
|
|
|
// color of the character under the cursor is used
|
|
|
|
QColor _cursorColor;
|
|
|
|
QColor _cursorColor;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
MotionAfterPasting mMotionAfterPasting;
|
|
|
|
MotionAfterPasting mMotionAfterPasting;
|
|
|
|
|
Alf Gaida
9 years ago