setappleeventvalue
setappleeventvalue
VALUE

The setappleeventvalue statement 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.

Parameters

This statement has one parameter:

value – is the value to return to the calling event/program. This value may be either text or numeric. Dates and binary values are not allowed, and integer values larger than 32 bit are not allowed.

Description

Use the SetAppleEventValue statement to return a value from Panorama to AppleScript. This AppleScript finds out the number of selected records in the current database and displays that in a dialog.

    tell application "PanoramaX"
        set recordCount to run code "setappleeventvalue info({selected})"
    end tell
    display dialog recordCount

Working with Lists

One of AppleScript’s powerful features is the List data type. Panorama does not directly support the list data type, but you can easily convert between Panorama text arrays and lists, and back again.

Here is an example that transfers a text array to an AppleScript variable and then converts that variable into a list.

    tell application "PanoramaX"
        set databaseFields to run code "setappleeventvalue dbinfo({fields},{})"
    end tell
    set AppleScript's text item delimiters to return
    set databaseFields to every text item of databaseFields

This can be rearranged into a simpler version:

    tell application "PanoramaX"
        set AppleScript's text item delimiters to return
        set databaseFields to every text item of (run code "setappleeventvalue dbinfo({fields},{})")
    end tell

See Also

- 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).
- openurlinbackground -- 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).
- 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).
- 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
1.0 | New | New in this version.