Message_PlugIn_Open (changes)
Showing changes from revision #1 to #2:
Added | Removed | Changed
WindowManager
» Messages
» Message Codes
» Message_PlugIn_Open
Message_PlugIn_Open
(Code &4D540)
| Message Block | |
|---|---|
| +20 | Flags |
| +24 | Reserved |
| +28 | Browser instance handle (provided by the browser) |
| +32 | Parent window handle |
| +36 | Left |
| +40 | Bottom |
| +44 | Right |
| +48 | Top |
| +52 | File Type |
| +56 | Filename (string_value) |
Flags
| Bit | Meaning if set |
|---|---|
| 0 | Open as a helper (otherwise as a plugin) |
| All other are Reserved (must be zero) | |
Use
This message is sent by the browser to create a plugin instance.
Notes
The file specified contains a series of parameters in the form of name-value pairs. This data is the list of attributes and parameters from the APPLET, OBJECT or EMBED tag – see their respective definitions. This data is used by the plugin to understand what is being requested of it.
If bit 0 of the flags word is set then this is a request to open the file as a helper application. i.e. external to the parent application. In this case the bounding box (offset bytes 35 to 51) are invalid. The parent window handle may be valid or 0 depending on how the file is launched.
Usually a plugin application will respond with Message_PlugIn_Opening.
The bounding box of the PlugIn (as defined by left, bottom, right and top co-ordinates) is the work area co-ordinates within the parent’s window.
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.