This function is used to open a URL either in a popup window or in an iframe inserted in the actual document.
Warning: This function must be used in the client part of the program.
Context
Adelia Cloud client.
Parameters
ALPHA (n) |
Title |
Page title. |
ALPHA (n) |
URL |
URL of linked document. |
ALPHA (n) |
Options |
Options, in the form of a list of key attributes [=value] separated by commas. Specific values: if inline = *TRUE, the "target" option must be provided and take as a value the identifier of the div in which the iframe will be created. The other options are the attributes of the <iframe> tag. if inline = *FALSE,
|
BOOL |
Inline |
Indicates if the page should be opened online in a div (*TRUE, in this case the options field must specify the div ID) or in a popup window. |
BOOL |
ReturnCode |
Operation return code: *TRUE if the function call is successful. *FALSE if not. The return code indicates that the popup window or the integrated document (<iframe>) was created but not that the document has been correctly loaded. |
Notes:
- If you open the "inline" URL, the created iframe will replace the whole content of the div specified as the target.
- Some sites (e.g. google.com) have a security policy prohibiting the opening of the document in an <iframe>. In this case, the content of the frame is empty but no error information is sent.
- According to your browser's configuration, the popup window may be created in a new tab and one or more of the options specified in the "Options" parameter are ignored by the browser.
See the window.open (https://developer.mozilla.org/en-US/docs/Web/API/Window.open) online documentation for the restrictions and possible values of the "Options" field ("features" parameter of the function).
- According to your browser's configuration, the popup window may be created in a new tab and one or more of the options specified in the "Options" parameter are ignored by the browser.
Example
Title = 'ONLINE_DOC'
URL = 'http://docserver.domain.com/doc/index.html'
Options = 'target=doc_element_id,sandbox="allow-same-origin",seamless'
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxCloudOpenURL' Title URL Options *TRUE ReturnCode
List of the VaToolBx functions by topic