jexer

Class TTerminalWidget

java.lang.Object

jexer.TWidget

jexer.TScrollableWidget

jexer.TTerminalWidget

All Implemented Interfaces:

java.lang.Comparable<TWidget>, Scrollable, DisplayListener

public class TTerminalWidget
extends TScrollableWidget
implements DisplayListener

TTerminalWidget exposes a ECMA-48 / ANSI X3.64 style terminal in a widget.

Field Summary

Fields inherited from class jexer.TScrollableWidget

hScroller, vScroller

Constructor Summary

Constructors

Constructor and Description
TTerminalWidget(TWidget parent, int x, int y) Public constructor spawns a shell.
TTerminalWidget(TWidget parent, int x, int y, int width, int height, java.lang.String[] command, TAction closeAction) Public constructor spawns a custom command line.
TTerminalWidget(TWidget parent, int x, int y, int width, int height, TAction closeAction) Public constructor spawns a shell.
TTerminalWidget(TWidget parent, int x, int y, java.lang.String commandLine) Public constructor spawns a custom command line.
TTerminalWidget(TWidget parent, int x, int y, java.lang.String[] command) Public constructor spawns a custom command line.
TTerminalWidget(TWidget parent, int x, int y, java.lang.String[] command, TAction closeAction) Public constructor spawns a custom command line.
TTerminalWidget(TWidget parent, int x, int y, TAction closeAction) Public constructor spawns a shell.

Method Summary

Modifier and Type	Method and Description
void	bigVerticalDecrement() Perform a big step change up.
void	bigVerticalIncrement() Perform a big step change down.
void	close() Handle widget close.
void	displayChanged() Called by emulator when fresh data has come in.
void	draw() Draw the display buffer.
int	getDisplayHeight() Function to call to obtain the display height.
int	getDisplayWidth() Function to call to obtain the display width.
java.lang.String	getTitle() Get the desired window title.
boolean	hasHiddenMouse() Returns true if this widget does not want the application-wide mouse cursor drawn over it.
boolean	isReading() See if the terminal is still running.
void	onKeypress(TKeypressEvent keypress) Handle keystrokes.
void	onMouseDown(TMouseEvent mouse) Handle mouse press events.
void	onMouseMotion(TMouseEvent mouse) Handle mouse motion events.
void	onMouseUp(TMouseEvent mouse) Handle mouse release events.
void	onResize(TResizeEvent resize) Handle window/screen resize events.
void	onShellExit() Hook for subclasses to be notified of the shell termination.
void	reflowData() Resize scrollbars for a new width/height.
void	setVerticalValue(int value) Set current value of the vertical scroll.
void	toBottom() Go to the bottom edge of the vertical scroller.
void	toTop() Go to the top edge of the vertical scroller.
void	verticalDecrement() Perform a small step change up.
void	verticalIncrement() Perform a small step change down.

Methods inherited from class jexer.TScrollableWidget

bigHorizontalDecrement, bigHorizontalIncrement, getBottomValue, getHorizontalBigChange, getHorizontalScroller, getHorizontalSmallChange, getHorizontalValue, getLeftValue, getRightValue, getTopValue, getVerticalBigChange, getVerticalScroller, getVerticalSmallChange, getVerticalValue, horizontalDecrement, horizontalIncrement, placeScrollbars, setBottomValue, setHorizontalBigChange, setHorizontalSmallChange, setHorizontalValue, setLeftValue, setRightValue, setTopValue, setVerticalBigChange, setVerticalSmallChange, toEnd, toHome, toLeft, toRight

Methods inherited from class jexer.TWidget

activate, activate, activate, activateAll, addButton, addCalendar, addCheckBox, addComboBox, addDirectoryList, addDirectoryList, addDirectoryList, addDirectoryList, addEditor, addField, addField, addField, addImage, addImage, addLabel, addLabel, addLabel, addLabel, addLabel, addLabel, addList, addList, addList, addList, addPanel, addPasswordField, addPasswordField, addPasswordField, addProgressBar, addRadioGroup, addSpinner, addSplitPane, addTable, addTable, addText, addText, addTreeViewWidget, addTreeViewWidget, compareTo, doRepaint, drawBox, drawBox, drawBoxShadow, fileOpenBox, fileOpenBox, fileOpenBox, fileOpenBox, fileSaveBox, getAbsoluteX, getAbsoluteY, getActiveChild, getApplication, getAttrXY, getChildren, getCursorAbsoluteX, getCursorAbsoluteY, getCursorX, getCursorY, getHeight, getLayoutManager, getParent, getScreen, getTheme, getWidth, getWindow, getX, getY, handleEvent, hLineXY, inputBox, inputBox, inputBox, isAbsoluteActive, isActive, isCursorVisible, isDrawable, isEnabled, isVisible, messageBox, messageBox, mouseWouldHit, onCommand, onIdle, onMenu, onMouseDoubleClick, putAll, putAttrXY, putAttrXY, putCharXY, putCharXY, putCharXY, putStringXY, putStringXY, remove, remove, remove, remove, removeAll, resetTabOrder, setActive, setCursorVisible, setCursorX, setCursorY, setDimensions, setEnabled, setHeight, setLayoutManager, setParent, setupForTWindow, setVisible, setWidth, setWindow, setX, setY, splitHorizontal, splitVertical, switchWidget, toPrettyString, toPrettyString, toString, vLineXY

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y,
                       java.lang.String commandLine)

Public constructor spawns a custom command line.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

commandLine - the command line to execute

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y,
                       java.lang.String[] command)

Public constructor spawns a custom command line.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

command - the command line to execute

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y,
                       java.lang.String[] command,
                       TAction closeAction)

Public constructor spawns a custom command line.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

command - the command line to execute

closeAction - action to perform when the shell sxits

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y,
                       int width,
                       int height,
                       java.lang.String[] command,
                       TAction closeAction)

Public constructor spawns a custom command line.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

width - width of widget

height - height of widget

command - the command line to execute

closeAction - action to perform when the shell sxits

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y)

Public constructor spawns a shell.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y,
                       TAction closeAction)

Public constructor spawns a shell.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

closeAction - action to perform when the shell sxits

TTerminalWidget

public TTerminalWidget(TWidget parent,
                       int x,
                       int y,
                       int width,
                       int height,
                       TAction closeAction)

Public constructor spawns a shell.

Parameters:

parent - parent widget

x - column relative to parent

y - row relative to parent

width - width of widget

height - height of widget

closeAction - action to perform when the shell sxits

Method Detail

onResize

public void onResize(TResizeEvent resize)

Handle window/screen resize events.

Overrides:

onResize in class TScrollableWidget

Parameters:

resize - resize event

onKeypress

public void onKeypress(TKeypressEvent keypress)

Handle keystrokes.

Overrides:

onKeypress in class TWidget

Parameters:

keypress - keystroke event

onMouseDown

public void onMouseDown(TMouseEvent mouse)

Handle mouse press events.

Overrides:

onMouseDown in class TWidget

Parameters:

mouse - mouse button press event

onMouseUp

public void onMouseUp(TMouseEvent mouse)

Handle mouse release events.

Overrides:

onMouseUp in class TWidget

Parameters:

mouse - mouse button release event

onMouseMotion

public void onMouseMotion(TMouseEvent mouse)

Handle mouse motion events.

Overrides:

onMouseMotion in class TWidget

Parameters:

mouse - mouse motion event

draw

public void draw()

Draw the display buffer.

Overrides:

draw in class TWidget

setVerticalValue

public void setVerticalValue(int value)

Set current value of the vertical scroll.

Specified by:

setVerticalValue in interface Scrollable

Overrides:

setVerticalValue in class TScrollableWidget

Parameters:

value - the new scroll value

verticalDecrement

public void verticalDecrement()

Perform a small step change up.

Specified by:

verticalDecrement in interface Scrollable

Overrides:

verticalDecrement in class TScrollableWidget

verticalIncrement

public void verticalIncrement()

Perform a small step change down.

Specified by:

verticalIncrement in interface Scrollable

Overrides:

verticalIncrement in class TScrollableWidget

bigVerticalDecrement

public void bigVerticalDecrement()

Perform a big step change up.

Specified by:

bigVerticalDecrement in interface Scrollable

Overrides:

bigVerticalDecrement in class TScrollableWidget

bigVerticalIncrement

public void bigVerticalIncrement()

Perform a big step change down.

Specified by:

bigVerticalIncrement in interface Scrollable

Overrides:

bigVerticalIncrement in class TScrollableWidget

toTop

public void toTop()

Go to the top edge of the vertical scroller.

Specified by:

toTop in interface Scrollable

Overrides:

toTop in class TScrollableWidget

toBottom

public void toBottom()

Go to the bottom edge of the vertical scroller.

Specified by:

toBottom in interface Scrollable

Overrides:

toBottom in class TScrollableWidget

close

public void close()

Handle widget close.

Overrides:

close in class TWidget

reflowData

public void reflowData()

Resize scrollbars for a new width/height.

Overrides:

reflowData in class TScrollableWidget

getTitle

public java.lang.String getTitle()

Get the desired window title.

Returns:

the title

hasHiddenMouse

public boolean hasHiddenMouse()

Returns true if this widget does not want the application-wide mouse cursor drawn over it.

Returns:

true if this widget does not want the application-wide mouse cursor drawn over it

isReading

public boolean isReading()

See if the terminal is still running.

Returns:

if true, we are still connected to / reading from the remote side

onShellExit

public void onShellExit()

Hook for subclasses to be notified of the shell termination.

displayChanged

public void displayChanged()

Called by emulator when fresh data has come in.

Specified by:

displayChanged in interface DisplayListener

getDisplayWidth

public int getDisplayWidth()

Function to call to obtain the display width.

Specified by:

getDisplayWidth in interface DisplayListener

Returns:

the number of columns in the display

getDisplayHeight

public int getDisplayHeight()

Function to call to obtain the display height.

Specified by:

getDisplayHeight in interface DisplayListener

Returns:

the number of rows in the display