ConPageHndl function

 

Usage:

Handle??? = ConPageHndl (PageNum&)

 

Legacy Syntax:

Handle??? = GETSTDVID (PageNum&)

 

Pseudo-object Syntax:

Handle??? = CON.GETSTDVID (PageNum&)

 

Gets the Windows API handle of the specified console output buffer page.

 

It is normally only necessary to get this handle if you wish to use API functions. The returned handle can also be used with the OPEN HANDLE statement, if you wish to treat console output as a file.

 

PageNum& must be in the range of 1 through 8. If PageNum& is omitted, or it is equal to zero, the handle of the current active page is returned.

 

Note that this function returns the console output handle. If you need the console input handle, use the ConKbdHndl function.

 

Conversion:

 

#IF %DEF(%PB_CC32)

  Handle??? = GETSTDVID (PageNum&)

#ELSE

  Handle??? = ConPageHndl (PageNum&)

#ENDIF

 

CON.GETSTDVID or CONSOLE.GETSTDVID may be substituted for GETSTDVID in programs written for PB/CC 6. The syntax " ... TO Handle???" may be used instead of "Handle??? = ..."

 

See Also: ConKbdHndl