Products Downloads


French version


 


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,

      • if options = *HREF[(target)], a click on a link of <a href='url' target='target'> type is simulated.
        The "target" of the link can be placed between parentheses:

        • *HREF : target=_blank, opens a new window by default.
        • HREF() : target='' (redirection of the current page, the Adelia desktop is exited).
        • *HREF(xxx) : target='xxx' (opens the URL in the "xxx" id window).
      • in other cases, a popup window is opened via the window.open(url, options) function. The list of options is directly passed as a parameter for the function.

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).


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


↑ Top of page