Window Object

 Window Object

---

 

Description

The Window object provides access to properties and methods relating to SecureCRT's window such as the window’s visible state, caption, etc.

 

Syntax

Window.Property [ = expression ]

Window.Method([arglist])

 

Remarks

SecureCRT's Window object is accessed through the top-level object’s Window property.

 

Window Object Properties and Methods

Properties	Methods
Active	Activate
Caption	Show
State

 

Properties

 

Active

Description

Returns True if SecureCRT's window is the active window, otherwise False.

Syntax

[ varname = ] crt.Window.Active

Remarks

Boolean read-only property.

 

Caption

Description

Returns or sets the title or caption of SecureCRT's application window.

Syntax

crt.Window.Caption [ = string ]

[ varname = ] crt.Window.Caption

Remarks

Read/write string property.

 

State

Description

Returns a number indicating the state of SecureCRT's application window.

Syntax

crt.Window.State

Remarks

Read-only numeric property. The state may be one of the following values depending on SecureCRT's window state:

0 - hidden

1 - visible (normal)

2 - minimized

3 - maximized

 

 

Methods

 

Activate

Description

Gives focus to the SecureCRT window, bringing the window to the top of the desktop.

Syntax

crt.Window.Activate

Remarks

On Windows 2000, calling Activate()from a script may cause SecureCRT's icon to flash in the task bar instead of raising SecureCRT to the top. This is the required behavior for these operating systems.

 

Show

Description

Shows, hides, minimizes, or maximizes SecureCRT's application window

Syntax

crt.Window.Show state

Remarks

The state may be one of the following values:

0 - Hide

1 - Show (Normal)

2 - Minimize

3 - Maximize