Window Object

SecureCRT


 

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.

Remarks

Boolean read-only property. On Linux, False may be returned even if the SecureCRT icon is flashing.

VBScript

Syntax

[ varname = ] crt.Window.Active

Python

Syntax

[ varname = ] crt.Window.Active

 

Caption

Description

Returns or sets the title or caption of SecureCRT's application window and the active session tab or tiled session window.

Remarks

Read/write string property.

VBScript

Syntax

crt.Window.Caption [ = string ]

[ varname = ] crt.Window.Caption

Python

Syntax

crt.Window.Caption [ = string ]

varname = ] crt.Window.Caption

 

State

Description

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

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

VBScript

Syntax

crt.Window.State

Python

Syntax

crt.Window.State

 

 

Methods

 

Activate

Description

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

Remarks

On Linux, calling Activate() from a script may cause the SecureCRT icon to flash instead of raising SecureCRT to the top. This is the required behavior for this operating system.

VBScript

Syntax

crt.Window.Activate

Python

Syntax

crt.Window.Activate()

 

Show

Description

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

Remarks

The state may be one of the following values:

0 - Hide

1 - Show (Normal)

2 - Minimize

3 - Maximize

VBScript

Syntax

crt.Window.Show state

Python

Syntax

crt.Window.Show(state)