Instruction set reference
HIPE_OP_FRAME_EVENT
Sent by the server to a client that manages one or more sub-frames to indicate an event affecting a direct sub-frame of thise one. Frame events usually relate to a change in some information about the client in the subframe, rather than user interaction events happening within the subframe itself.
- location: The iframe element whose client triggered the event.
- arg[0]: The type of client event.
- arg[1]: Event detail (if applicable to a specific event type).
- requestor: The requestor value that was originally passed by this client, last time GET_FRAME_KEY was called on this iframe element.
Notes
Frame events are sent automatically once HIPE_OP_GET_FRAME_KEY has been requested for that frame.
Frame events are different to regular events in Hipe, and usually refer to a change in information about the client frame. The framing client doesn't get to specify which events should be listened for. All of the following events will be received if they occur
Event types are defined by macros in hipe_instruction.h, and have the prefix: HIPE_FRAME_EVENT_. These are represented by the raw char value of the first character in arg[0], and can be checked by evaluating the value of (received instruction).arg[0][0]
Client event types
| arg[0] | arg[1] | arg[2] |
|---|---|---|
| HIPE_FRAME_EVENT_CLIENT_CONNECTED | Client title | Client process ID (or 0) |
| HIPE_FRAME_EVENT_CLIENT_DISCONNECTED | - | - |
| HIPE_FRAME_EVENT_TITLE_CHANGED | Client title string | - |
| HIPE_FRAME_EVENT_ICON_CHANGED | binary PNG image data | - |
| HIPE_FRAME_EVENT_COLOR_CHANGED | new foreground color | - |
| HIPE_FRAME_EVENT_BACKGROUND_CHANGED | new background color | - |