- Sending AppleEvents
  - tclAE::send
  - tclAE::IPCListPorts
  - tclAE::PPCBrowser

This page describes TclÆ calls for sending AppleEvents. For information on the associated ToolBox calls, see INSIDE MACINTOSH: Interapplication Communication.

# Sending AppleEvents

## `tclAE::send`

send the specified AppleEvent

### Synopsis

`tclAE::send [flags] anAddress aeclass aeeventID [event parameters]*`

### Result

### Description

`flags` can be:

`-dr`
  don't record (when used with `-s` flag)
`-dx`
  don't execute (when used with `-s` flag)
`-p`
  print reply with AEPrint before returning it (if absent, return parsed AEDesc identifier). This archaic flag is ignored. All replies come in AEPrinted form.
`-Q eventHandlerProc`
  queued reply requested (handler proc specified directly)
`-q`
  queued reply requested (register handler with currentReplyHandler). This flag is deprecated and only supported in Alpha for legacy code. Use `-Q`.
`-r`
  direct reply requested
`-s`
  send event to "self" (`kCurrentProcess`). Omit `anAddress` if `-s` is used
`-t timeout`
  specifies event timeout in ticks
`-z transactionID`
  indicates that event is part of an ongoing transaction with the target (obtained from a `misc/begi` event).
`--`
  don't process further flags

## `tclAE::IPCListPorts`

Tcl wrapper for ToolBox `IPCListPorts`.

This call is not supported on Mac OS X.

### Synopsis

    tclAE::IPCListPorts option [arg]*

### Result

A new `TargetID`.

### Description

Displays information about available ports. Legal options are:

`tclAE::IPCListPorts ppcNoLocation`
  List ports on local machine
`tclAE::IPCListPorts ppcNBPLocation objStr typeStr zoneStr`
  List ports on machine on the specified AppleTalk zone
`tclAE::IPCListPorts ppcXTIAddrLocation url`
  List ports on machine specified by internet address

## `tclAE::PPCBrowser`

Tcl wrapper for ToolBox `PPCBrowser`.

This call is not supported on Mac OS X.

### Synopsis

    tclAE::PPCBrowser [flags]

### Result

A new `TargetID`.

### Description

Display a dialog allowing the user to select an application to communicate with.

Flags are:

`-p string`
  Prompt string
`-l string`
  Label for application pane
`-fc list`
  Creator-type list
`-fn list`
  Port name list

Copyright © 1999Ð2003 Jonathan E. Guyer
All rights reserved.

Last modified Saturday, November 29, 2003 02:37:43 PM