TeSSH

MAKEWINDOW

Syntax: #MAKEW name action options

Related: #WINDOW

Create a new child window for the current server session. "name" is the name of the window, and "action" is either: OPEN, CLOSE, or REDIRECT. OPEN will create a new window and open it. CLOSE will close an existing window. REDIRECT will start redirecting all server output to the specified window. If the window did not yet exist, the Redirect action will call Open first.

Several special "names" can be used: _top refers to the parent server window, _previous refers to the previous window that had focus before this window was created.

Options is a database variable or string list of options to control the window creation. The format is: option1=value1|option2=value2...

scrolling=yes|no

determines if the window text will scroll

internal

docks the new window within the current server window. See the Align option to control this. The Floating,Left,Top,Width,Height options are ignored for this option.

floating

sets the window to be "stay on top". Ignored for Internal windows.

align=left|right|top|bottom

determines which edge of the main server window an Internal window is docked. Left is current ignored and functions the same as Right.

top=value

sets the position of the top edge of the window. See below for description of value coordinates.

left=value

sets the position of the left edge of the window. See below for description of value coordinates.

width=value

sets the width of the window. See below for description of value coordinates.

height=value

sets the height of the window. See below for description of value coordinates.

title=string

sets the caption of the window to the given string

persistant

the position and size of the window are saved when the window is closed and restored the next time the window is opened

force

for persistant windows, ignore the saved values from the user and use the specified Left,Top,Width,Height values

Coordinate values

The coordinate values used in the options can be a simple number of pixels, or can be of the format xxx% to represent a percentage of the screen, or xxxC to represent a certain number of characters. For example, height=10c is the height of 10 characters on the screen. height=50% would use half the height of the screen.

MAKEWINDOW examples

#MAKEWINDOW Tells open "scrolling=yes|left=50%|top=0|width=50%|height=30%|persistant

This would create a new window called "Tells", placed in the upper right portion of the screen.

Starts redirecting all server output to the new Tells window.

This redirects the server text back to the original window.