Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

IOXY^XGF(): Screen Cursor Placement

Reference Type: Supported, Category: XGF Function Library, Integration Agreement: 3173


This API positions the cursor on the screen at a screen coordinate. This API is similar to Kernel's X IOXY function. The row parameter must be between 0 and IOSL-1; the column parameter must be between 0 and IOM- 1.

A call to the PREP^XGF(): Screen/Keyboard Setup API must be made at some point prior to calling IOXY^XGF.

You can specify row and column parameters relative to the current $x and $y by specifying "+" or "-" to increment or decrement $x or $y by 1. You can increment or decrement by more than one if you add a number as well, such as "-5" or "+10".

NOTE: You must use quotes to pass a "+" or "-". Otherwise, to specify exact locations for row and column, pass numbers.



Input Parameters


(required) Row position to which the cursor is moved.


(required) Column position to which the cursor is moved.


$x and $y:

Set to the row and column specified as parameters.

NOTE: See also: SAY^XGF():Screen String and SAYU^XGF(): Screen String with Attributes APIs.


For example, to position the cursor at row 12, column 39, do the following:

>D IOXY^XGF(12,39)


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.