Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filev_exit_cur()
v_enter_cur()                                                           VDI

Syntax

VOID v_enter_cur( handle )
WORD handle;

Function      v_enter_cur() clears the screen to color 0, removes the
              mouse cursor and enters text mode.

Opcode        5

Sub-Opcode    3

Availability  Supported by all screen drivers.

Parameters    handle specifies a valid workstation handle.

Binding       contrl[0] = 5;
              contrl[1] = contrl[3] = 0;
              contrl[5] = 3;
              contrl[6] = handle;

              vdi();

Caveats       You should check that the left mouse button has been
              released with vq_mouse() prior to calling this function. If
              the button is depressed when you call this function the VDI
              will lock waiting for it to be released after v_exit_cur().

Comments      This call is used by a GEM application to prepare for
              executing a TOS application when not running under MultiTOS.

See Also      v_exit_cur()

Group         VDI Alpha Escapes