---

The openurlinbackground statement opens a URL (usually a web page or to create an e-mail message) without bringing forward the app that handles the URL (in other words, Panorama remains the frontmost application).

---

Parameters

This statement has one parameter:

url – is the the URL to be opened. If you are opening a web page, it is the absolute URL of the web page, starting with http://. If you are creating an e-mail message, it must begin with mailto: followed by the e-mail address (optionally followed by ? and the e-mail subject).

---

Description

The openurlinbackground statement opens a web page, creates an e-mail message (or sends a URL to any application that handles a custom URL scheme) in the background. Panorama remains the frontmost application even as the second application processes the URL. This is especially useful for applications that handle the x-callback-url protocol (see xcallbackurl), since it allows you to communicate with these applications without excessive screen flashing.

To open a web page in the background use the “http://” scheme. This example opens the HTML document Roadshow.html on the web server www.genericsite.com . The HTML document will be opened using the default web browser.

openurlinbackground "http://www.genericsite.com/Roadshow.html"

If you want to open a URL and bring it foward, use the openurl statement.

---

Error Messages

Could not open URL – This error occurs if the URL is not valid.

---

See Also

• @urls --
• applescriptconstant( -- converts an expression into an AppleScript literal.
• applescriptstring( -- converts text into an AppleScript string literal.
• arraytopythonlist( -- converts a Panorama array into a Python list.
• hideotherapplications -- hides all other applications, leaving only Panorama visible.
• javascriptconstant( -- converts an expression into a JavaScript literal.
• javascriptstring( -- converts a text string into a JavaScript string
• jsonscriptstring( -- converts text into a JSON string literal
• loadcustomfunctions -- reloads all ProVUE defined custom functions.
• openanything -- opens a document or application.
• openurl -- opens a URL (usually a web page or to create an e-mail message).
• openwith -- opens a document with a specific application.
• openwithterminal -- opens an application in a new Terminal.app window (useful for debugging).
• perlconstant( -- encodes text for use as a constant in a Perl program.
• perlscriptstring( -- converts text into a Perl string literal.
• phpconstant( -- encodes text for use as a contant in a php program.
• posixpath( -- converts a path and filename into a POSIX path that can be used as a parameter to a shell command.
• pythonconstant( -- encodes text for use as a constant in a python program.
• registercustomfunction -- defines a new custom function.
• revealinfinder -- reveals a file or folder in the Finder.
• revealmultipleinfinder -- reveals one or more files or folders in the Finder.
• rubyconstant( -- encodes a value for use as a constant in a Ruby program.
• runningappinfo( -- returns information about applications that are currently running on this computer.
• Scripting Panorama X with AppleScript -- embedding Panorama code into AppleScript (allowing Panorama to be controlled from other programs).
• setappleeventvalue -- may be used in a procedure that responds to an AppleEvent (this includes AppleScript programs), the statement specifies the value to be returned by the event.
• shellscriptwithterminal -- runs a shell script in a new Terminal.app window (useful for debugging).
• unixshellpath( -- converts a path and filename into a POSIX path that can be embedded within the shellscript statement.
• unixshellstring( -- encodes text for use as a parameter to a unix shell command.

---

History

Version	Status	Notes
10.2	New	New in this version.