WINNEXT() Function - Get Next Window Context ID

Syntax

WINNEXT(sysgui,context{,ERR=lineref})

Description

The WINNEXT() function returns the next context ID of each of the top-level windows in sequence by way of a templated string obtained either from the WINFIRST() function or from a previous use of the WINNEXT() function.

Parameter

Description

sysgui

Valid SYSGUI channel.

contextid

Context ID.

ERR=lineref

Branch to be taken if an error occurs during execution.

If sysgui does not refer to a SYSGUI channel, WINNEXT() generates an !ERROR=11. When there are no more windows within the context, WINNEXT() generates an !ERROR=2.

Example

let sysgui=unt
open(sysgui)"X0"
let win=winfirst(sysgui,err=nowindows)
while w.win=200
let win=winnext(sysgui,win)
wend
let winfo$=wininfo(sysgui,win)

See Also

Functions - Alphabetical Listing