• getAppInfo subcommand ?option ?value??
Return information about Alpha or other applications. The syntax can
take different forms (explained below):
The options have the following meaning:
- getAppInfo commands
- getAppInfo current -[bnp]
- getAppInfo host
- getAppInfo identifier ?path?
- getAppInfo mainWindow -[kn]
- getAppInfo name -[bps] value
- getAppInfo osversion
- getAppInfo path -[bnps] value
- getAppInfo pid
- getAppInfo processes
- getAppInfo running -[b] value
- getAppInfo url -[bnps] value
- getAppInfo version
- getAppInfo versionName
The subcommands have the following meaning:
- The subcommands
return the process identifier (pid), version number and
version name of Alpha itself.
- The subcommand identifier returns
the bundle identifier of the application specified by the path
argument. If path is not specified, it returns the bundle
identifier of Alpha itself.
- The subcommands host,
return information about the machine Alpha is running on.
- The subcommand commands returns
the list of all the core Tcl commands defined by Alpha.
- The processes subcommand returns a
list of sublists corresponding to the currently running processes. Each
sublist contains four items: the localized name, the process identifier
(pid), the bundle identifier and the full path.
- The running subcommand returns a
list of process identifiers (pid) for all currently running
applications with the specified bundle identifier. If none is running, the
command returns an empty list.
- The subcommands name,
as an argument an application designated by its bundle identifier (option
-b), its name (option -n), its process identifier if it is
a running process (option -p) or its signature (option -s)
and return the required information. The -s option is provided as a
convenience for compatibility reasons, but the use of signatures is
deprecated and should be avoided in favor of the -b option.
- The subcommand mainWindow returns
information about Alpha's main window :
If there is no main window (or if the application is not active or is
hidden), the command returns an empty string.
- with the option -k, it
indicates the main window's kind: the returned value is "alphadoc"
if it is a document window or "viewroot" if it is a root window
(created with the [view root] command).
- with the option -n, it
returns the name of the main window if it is a document window (kind alphadoc) or its token if it is a root window (kind "viewroot").