Resize Window by User (QsnRszWinUsr) API

Required Parameter:

Window handle

Input

Binary(4)

Omissible Parameter:

Error code

I/O

Char(*)

Returned Value:

Return code

Output

Binary(4)

  Default Public Authority: *USE

  Service Program: QSNAPI

  Threadsafe: No

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

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.
CPFA31E E	Required parameter &1 omitted.
CPFA340 E	Operation not supported with double-byte data.
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.

API introduced: V2R3

[ Back to top | Dynamic Screen Manager APIs | APIs by category ]