Remove Pop-Up Window (QUIRMVPW) API

Required Parameter Group:

Application handle

Input

Char(8)

Remove option

Input

Char(1)

Error code

I/O

Char(*)

Default Public Authority: *USE

Threadsafe: No

The Remove Pop-Up Window (QUIRMVPW) API removes the pop-up window created by the Add Pop-Up Window (QUIADDPW) API. After calling the QUIRMVPW API, subsequent calls to the Display Panel (QUIDSPP) API display either a full-screen panel or a panel in a pop-up window defined by a previous call of the QUIADDPW API. A pop-up window cannot be removed if an action or exit program is currently being processed for a panel displayed in that pop-up window.

Authorities and Locks

None.

Required Parameter Group

Application handle

INPUT; CHAR(8)

The application handle assigned by the UIM and returned to the application program by the Open Display Application (QUIOPNDA) API when the application is opened.

Remove option

INPUT; CHAR(1)

The pop-up windows that are removed from the open application. One of the following values must be used:

All inactive pop-up windows. A pop-up window is inactive if there are no panels currently displayed in that window.

The most recently added pop-up window.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID

Error Message Text

CPF3C90 E

Literal value cannot be changed.

CPF6A0B E

Application handle &3 not valid.

CPF6A0C E

Application domain error for application &1.

CPF6A0F E

Previous error occurred while running application &3.

CPF6A24 E

Parameter &1 not passed correctly.

CPF6A25 E

Return code length of &1 not valid.

CPF6A3E E

Application not open for display.

CPF6A84 E

Window cannot be removed at this time.

CPF6A90 E

Value not correct. Reason code &3.

CPF9872 E

Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V2R2

[ Back to top | User Interface Manager APIs | APIs by category ]