WINFIRST() Function - Get Window Context ID

Syntax

WINFIRST(sysgui{,ERR=lineref})

Description

The WINFIRST() function returns a window context ID that can be used by the WININFO() function to obtain information about the referenced window. To query the current window context for a given SYSGUI channel, use either the CTRL() function or the FIN() function.

Parameter

Description

sysgui

Valid SYSGUI channel.

ERR=lineref

Branch to be taken if an error occurs during execution.

If the identified channel does not contain any windows, WINFIRST() generates an !ERROR=2.

Example

let sysgui=unt
open(sysgui)"X0"
let win=winfirst(sysgui,err=nowindows)
let winfo$=wininfo(sysgui,win)

See Also

Functions - Alphabetical Listing