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 .

Report problems to jkotula@stratasys.com


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.