short Escape(hdc, MOUSETRAILS, sizeof(WORD),lpTrailSize, NULL)The MOUSETRAILS escape enables or disables mouse trails for display devices.
hdc
HDC Identifies the device context.
lpTrailSize
LPINT points to a 16-bit variable containing a value specifying the action to take and the number of mouse cursor images to display (trail size). The variable can be one of the following values:
| Value | Meaning |
| 1 through 7 | Enables mouse trails and sets the trail size to the specified number. A value of 1 requests a single mouse cursor. A value of 2 requests that one extra mouse cursor be drawn behind the current mouse cursor, and so on, up to a maximum of 7 total cursor images. The escape sets the MouseTrails entry in the WIN.INI file to the given value and returns the new trail size. |
| 0 | Disables mouse trails. The escape sets the MouseTrails entry to the negative value of the current trail size (if positive) and returns the negative value. |
| –1 | Enables mouse trails. The display driver reads the MouseTrails entry from the [windows] section of the WIN.INI file. If the value of the entry is positive, the escape sets the trail size to the given value. If the entry is negative, the escape sets the trail size to the entry's absolute value and writes the positive value back to WIN.INI. If the MouseTrails entry is not found, the escape sets the trail size to 7 and writes a new MouseTrails entry to the WIN.INI file, setting its value to 7. The escape then returns the new trail size. |
| –2 | Disables mouse trails but does not cause the display driver to update the WIN.INI file. |
| –3 | Enables mouse trails but does not cause the display driver to update the WIN.INI file. |
The return value specifies the new trail size if the escape is successful. The return value is zero if the escape is not supported.