| Applies To: | HTMLRenderer |
Description
This event is triggered when the HTMLRenderer client attempts to open a new window. This is often done using an HTML <a> tag with the target attribute set to open a URL in a new window. Note that this does not apply to JavaScript Popup Boxes.
<a href="www.dyalog.com" target="_blank">Dyalog Website</a>
By default the HTMLRenderer ignores a request for a new window, but if the DoPoup event, is enabled, it provides the information needed to process the request in the workspace.
The event message reported as the result of ⎕DQ, or supplied as the right argument to your callback function, is a 4-element vector as follows:
| [1] | Object | ref or character vector |
| [2] | Event | 'DoPopup' or 846 |
| [3] | URL | the requested url |
| [4] | Attributes | requested window attributes (see below) |
Attributes is a 7-element nested vector that specifies the requested attributes for the new window. The HTMLRenderer currently provides no mechanism to use this information.
To respond to the request for a new window, the callback function should open the requested URL as appropriate, for example, in a newly created HTMLRenderer object.