Platform

Win32, x64

Purpose

To select the current drawing surface.

Syntax

INTEGER FUNCTION SELECT_GRAPHICS_REGION@( HANDLE )
INTEGER(7) HANDLE

Description

Drawing surfaces are created by %gr (Graphics Region), OPEN_PRINTER@ etc. and CREATE_GRAPHICS_REGION@. HANDLE is a value that is supplied to %gr (Graphics Region) or %pl (SIMPLEPLOT Graphics Region) via the [handle] option. HANDLE can also be obtaind by calling GET_CURRENT_GRAPHICS_REGION@ immediately after calling CREATE_GRAPHICS_REGION@ or immediately after a winio("%gr&"...) OPEN_PRINTER@ etc.. ClearWin+ drawing routines are applied to the current drawing surface. Call this function if there is more than one drawing surface in order to draw on a surface that is not the current one.

This is an alternate function to SELECT_GRAPHICS_OBJECT@.

Return value

The value 1 is returned for success or zero for failure (invalid identifier).