Resize Window by User (QsnRszWinUsr) API

The Resize Window by User (QsnRszWinUsr) API allows a window to be resized according to the cursor movements specified by the user. If the cursor is located on a border when this API is called, then that border can be moved. If the cursor is located on a border corner, the two sides that meet at that corner can be moved. If the user positions the cursor to a new row/column for the horizontal or vertical border, the border is moved to the new coordinate position and the window is resized accordingly. If the cursor is not on the border when the API is called, then the cursor is moved to the bottom center corner of the window and the user is prompted to move the cursor to the new position for the bottom center corner of the window. The prompt is displayed only if a message line has been defined. If the window is a full screen window, the API will complete successfully, but the window will not be moved.

A window can be made only as small (large) as the minimum (maximum) size allowed for the window. If the user moves the cursor such that the resulting window will be smaller (larger) than the minimum (maximum) size allowed, the resulting window will be the minimum (maximum) size. If a Change Window Coordinates exit routine is specified on the window description, this routine is called after the window is successfully resized. Typically, this API would be called after the user presses a particular function key. Windows where the associated low-level environment indicates DBCS support cannot be resized.

Authorities and Locks

None

Required Parameter

Window handle

INPUT; BINARY(4)

A handle for the window to be resized.

Omissible Parameter

Error code

I/O; CHAR(*)

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.

Returned Value

Return code

OUTPUT; BINARY(4)

A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.

Error Messages