| 1 | Window handle | Input | Binary(4) |
| 2 | Error code | I/O | Char(*) |
| Return code | Output | Binary(4) |
The Move Window by User (QsnMovWinUsr) API allows a window to be moved on the screen to a new location specified by the user. The API positions the cursor at the upper left corner of the window and prompts the user to move the cursor to the new position for the upper left corner. The prompt is displayed only if a message line has been defined. If the window can fit within the display at the location specified, it is moved to the new position. If a Change Window Coordinates exit routine is specified on the window description, it is called after the window is successfully moved. If the window is a full screen window, the API will complete successfully, but the window will not be moved.
None.
A handle for the window to be moved.
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.
A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPFA318 E | Error calling exit routine. |
| CPFA31E E | Required parameter &1 omitted. |
| CPFA343 E | Output operation not done. |
| CPFA344 E | The file &2 in library &3 is not valid. |
| CPFA345 E | The invite active flag is not valid. |
| CPFA3A4 E | Specified window is not active. |
| CPFA3AA E | Window handle incorrect. |
[ Back to top | Dynamic Screen Manager APIs | APIs by category ]