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)