Function Entry: GRREAD

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: GRREAD

Name

grread

Class

Host Function

Syntax

(grread [track] [allkeys [curtype]])

Arguments and Values

track: optional tracking flag
allkeys: optional key/gesture mode
curtype: optional cursor-type control

Autodesk documents allkeys as a bit-coded integer.

Description

Reads low-level graphical or keyboard input events.

Return Values

List describing the input event.

Autodesk documents that the first list element is an event type code, with the second element depending on that type.

Side Effects

enters low-level input mode
consumes input events

Compatibility

One of the most host- and UI-specific user-input functions.

Availability

AutoCAD 2026: documented (per Autodesk reference page).
BricsCAD V26: presumed compatible (no contradicting page found).
Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Source Notes

[grread (AutoLISP)](https://help.autodesk.com/cloudhelp/2023/ENU/AutoCAD-AutoLISP-Reference/files/GUID-2484FFE3-95B3-4C2B-AF79-BE7772B07419.htm)
[About Accessing and Requesting User Input (AutoLISP)](https://help.autodesk.com/cloudhelp/2024/ESP/AutoCAD-AutoLISP/files/GUID-7F024C1B-EFB8-4F6C-9EFE-A6491210A4CD.htm)

Notes

Autodesk documents allkeys bit values including drag-mode coordinates, all-key reporting, and cursor control.
Autodesk explicitly warns that applications using grread are unlikely to be upward compatible across hardware and platform configurations.
Current Autodesk reference marks grread as supported on Windows and macOS, not Web.