Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

  ◄Syntax►  ◄Details►  ◄Example►                 ◄Contents►  ◄Index►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
PEN(n%)
 
    ■ n%   An integer value between 0 and 9 that specifies what information
           is to be returned about the status of the lightpen.
 
    Argument   Value returned
    0          Whether pen was down since last function call
               (-1 = yes, 0 = no).
    1          The x coordinate of the last pen press.
    2          The y coordinate of the last pen press.
    3          The current pen switch status (-1 = down, 0 = up).
    4          The x coordinate where the pen last left the screen.
    5          The y coordinate where the pen last left the screen.
    6          The character row of the last pen press.
    7          The character column of the last pen press.
    8          The character row where the pen last left the screen.
    9          The character column where the pen last left the screen.
 
    ■ The lightpen coordinate system is identical to the current graphics
      screen mode, without viewport or window considerations.
    ■ The PEN function is not available in OS/2 protected mode.
 
See Also    ◄PEN Statements►