Instruction set reference
HIPE_OP_FRAME_CLOSE
Sent to a client frame (by the display server, or by a framing manager) to indicate that the user has requested a client be closed/terminated.
- location: 0 (body element) if receiving a request to close. If sending a close request to a child frame, use the location of that frame.
- arg[0]: Send an empty argument to disconnect a
child frame's client from the display server by force (the client will not
receive a HIPE_OP_FRAME_CLOSE instruction, but will instead be immediately
disconnected and see HIPE_OP_SERVER_DENIED when it tries to obtain the
next instruction). Or, send "1" to pass a
HIPE_OP_FRAME_CLOSE instruction to the client, which should then react
accordingly.
Other non-empty arguments (e.g. "0") are presently undefined and should not be used.
Notes
You are required and expected to check for this instruction in your application, and respond in a reasonable way. It may not be appropriate for your application to terminate immediately - an acceptable response might be to ask the user for confirmation before discarding unsaved changes to a document.
Unless the close operation is forced, receiving this instruction will not actually close your application. You are required to handle the received instruction, to close the hipe client session and then terminate your application.
A forced close operation makes no guarantee that the client process will terminate; only that it will be removed from the display server. A poorly written application might continue to run in the background after it no longer has access to the display, although most ought to terminate.