Main Page Cookbook/Overview ImageMeister the jcprops file Licensing Binary Installation & Configuration [ Win · Mac · Nix · OSX ] Changes Public API Source Code Main Page Java [ Common · Win · Mac · Nix ] Native Code [ Common · Win · Mac · Nix ] Manifest Native Code Overviews [ Common · Win · Mac · Nix · Strings ] Macros [ General · Native Macros ] Walkthroughs [ Java only · Java and native ] Building [ Win · Mac · Nix · OSX ] Distribution Issues

# SAppUtils

  Routines for working with applications.

[ Mac | Source | Keywords | Summary | Ancestors | All Members | Descendants ]

## Quick Index

  DESCRIPTION

## Class Summary

class SAppUtils
{
public:

  typedef enum tageOpenWithDocsEventCode eOpenWithDocsEventCode;
  typedef enum tageSendAppDocsEventCode eSendAppDocsEventCode;
  typedef enum tageLaunchWithDocFlags eLaunchWithDocFlags;
  static ErrCode sendAppDocs( eSendAppDocsEventCode eventCode, ProcessSerialNumber *appPSN, FSSpec *filesToLaunch, long numSpecs, eLaunchWithDocFlags flags );
  static ErrCode openWithDocs( eOpenWithDocsEventCode eventCode, CFSpec *appSpec, FSSpec *filesToLaunch, long numSpecs, ProcessSerialNumber *retPSN, eLaunchWithDocFlags flags );
  static ErrCode launchApp( CFSpec *appSpec, ProcessSerialNumber *retPSN, long flags );
  static ErrCode getOpenableFileTypes( long vRef, long creator, FileType *typesBlockP, long maxToReturn, long *numReturned );
  static ErrCode sendEvent( AppleEvent *theEvent, OSType creator );
  static ErrCode launchFSSpec( CFSpec *appSpec, AppleEvent *theEvent );

protected:

}; // SAppUtils

Back to the top of SAppUtils

### DESCRIPTION

Routines for working with applications.

Back to the top of SAppUtils

### typedef enum tageOpenWithDocsEventCode eOpenWithDocsEventCode;

See openWithDocs()

    	typedef enum tageOpenWithDocsEventCode {
    		kLaunchWithDocOpenDoc = 1,
    		kLaunchWithDocPrintDoc = 2
    	} eOpenWithDocsEventCode;

Back to the top of SAppUtils

### typedef enum tageSendAppDocsEventCode eSendAppDocsEventCode;

See sendAppDocs()

    	typedef enum tageSendAppDocsEventCode {
    		kSendAppDocsOpenDoc = 3,
    		kSendAppDocsPrintDoc = 4
    	} eSendAppDocsEventCode;

Back to the top of SAppUtils

### typedef enum tageLaunchWithDocFlags eLaunchWithDocFlags;

See openWithDocs() and sendAppDocs()

    	typedef enum tageLaunchWithDocFlags {
    		kDontSwitchLayer = 1
    	} eLaunchWithDocFlags;

Back to the top of SAppUtils

### ErrCode sendAppDocs( eSendAppDocsEventCode eventCode, ProcessSerialNumber *appPSN, FSSpec *filesToLaunch, long numSpecs, eLaunchWithDocFlags flags );

Send a series of documents to a running app.

in eventCode
  one of the eSendAppDocsEventCode values
in appPSN
  the PSN of the app
in filesToLaunch
  an array of FSSpec's containing the documents to send to the app
in numSpecs
  the number of FSSpec's in filesToLaunch
in flags
  ignored

    	static	ErrCode sendAppDocs( eSendAppDocsEventCode eventCode, ProcessSerialNumber *appPSN,
    									FSSpec *filesToLaunch, long numSpecs,
    									eLaunchWithDocFlags flags );

Back to the top of SAppUtils

### ErrCode openWithDocs( eOpenWithDocsEventCode eventCode, CFSpec *appSpec, FSSpec *filesToLaunch, long numSpecs, ProcessSerialNumber *retPSN, eLaunchWithDocFlags flags );

Open an app with a series of documents.

in eventCode
  one of the eOpenWithDocsEventCode values
in appSpec
  the CFSpec of the app
in filesToLaunch
  an array of FSSpec's containing the documents to send to the app
in numSpecs
  the number of FSSpec's in filesToLaunch
out retPSN
  on return, the PSN of the new process
in flags
  0 or a combination of one of the eLaunchWithDocFlags values

    	static	ErrCode openWithDocs( eOpenWithDocsEventCode eventCode, CFSpec *appSpec,
    									FSSpec *filesToLaunch, long numSpecs,
    									ProcessSerialNumber *retPSN, eLaunchWithDocFlags flags );

Back to the top of SAppUtils

### ErrCode launchApp( CFSpec *appSpec, ProcessSerialNumber *retPSN, long flags );

Launch an app without docs.

in appSpec
  the CFSpec of the app
out retPSN
  on return, the PSN of the new process
in flags
  0 or a combination of one of the eLaunchWithDocFlags values

    	static	ErrCode launchApp( CFSpec *appSpec, ProcessSerialNumber *retPSN, long flags );

Back to the top of SAppUtils

### ErrCode getOpenableFileTypes( long vRef, long creator, FileType *typesBlockP, long maxToReturn, long *numReturned );

Get a list of the file types an app says it can open.

in vRef
  the volume containing the add identified by creator
in creator
  the creator code of the app
out typesBlockP
  an array of FileType's
in maxToReturn
  the number of FileType elements in typesBlockP
out numReturned
  on returned, the number of FileType's placed in typesBlockP

    	static	ErrCode getOpenableFileTypes( long vRef, long creator, FileType *typesBlockP, long maxToReturn,
    											long *numReturned );

Back to the top of SAppUtils

### ErrCode sendEvent( AppleEvent *theEvent, OSType creator );

Send an event to an app, running or not.

in theEvent
  the event to send
in creator
  the creator code of the app

    	static	ErrCode sendEvent( AppleEvent *theEvent, OSType creator );

Back to the top of SAppUtils

### ErrCode launchFSSpec( CFSpec *appSpec, AppleEvent *theEvent );

Launch the app specified by 'appSpec' with an AppleEvent.

in appSpec
  the CFSpec of the app
in theEvent
  the AppleEvent to launch the app with

    	static	ErrCode launchFSSpec( CFSpec *appSpec, AppleEvent *theEvent );

Back to the top of SAppUtils

## All Members

public:
  typedef enum tageOpenWithDocsEventCode eOpenWithDocsEventCode;
  typedef enum tageSendAppDocsEventCode eSendAppDocsEventCode;
  typedef enum tageLaunchWithDocFlags eLaunchWithDocFlags;
  static ErrCode sendAppDocs( eSendAppDocsEventCode eventCode, ProcessSerialNumber *appPSN, FSSpec *filesToLaunch, long numSpecs, eLaunchWithDocFlags flags );
  static ErrCode openWithDocs( eOpenWithDocsEventCode eventCode, CFSpec *appSpec, FSSpec *filesToLaunch, long numSpecs, ProcessSerialNumber *retPSN, eLaunchWithDocFlags flags );
  static ErrCode launchApp( CFSpec *appSpec, ProcessSerialNumber *retPSN, long flags );
  static ErrCode getOpenableFileTypes( long vRef, long creator, FileType *typesBlockP, long maxToReturn, long *numReturned );
  static ErrCode sendEvent( AppleEvent *theEvent, OSType creator );
  static ErrCode launchFSSpec( CFSpec *appSpec, AppleEvent *theEvent );
protected:

Back to the top of SAppUtils

## Ancestors

Class does not inherit from any other class.

Back to the top of SAppUtils

## Descendants

Class is not inherited by any others.

Back to the top of SAppUtils

Generated from source by the Cocoon utilities on Fri Aug 23 12:34:28 2002 .

Main Page · JConfig · ImageMeister · System Properties Repository · WordMeister · Free Samples · Java Freeware · Contact Us · FAQ · Links

Copyright (c) 1997-2002 Samizdat Productions. All Rights Reserved.
WarpMovie, TileMovie, JConfig, ImageMeister and MovieShredder are Trademarks of Samizdat Productions.