utils.h

CD_高级PALM编程

/********************************************************************
* FILE:				Utils.h
*					Copyright (c) 2000 by Steve Mann & Ray Rischpater.
*
* DESCRIPTION:	Header file for a collection of generic utility functions.
*					See Utils.c for a description of each utility.
*
* VERSION:		1.0
*
**********************************************************************/

// Constants

#define	LibType	'libr'

#ifndef 	noErr 
#define 	noErr ( 0 )
#endif

// Function prototypes

extern Err RomVersionCompatible // ( out ) error code or zero
( 
	UInt32 	requiredVersion, 	// (in) Minimum ROM version required
	UInt16 	launchFlags			// (in) App launch flags to check for UI available
);

extern void * GetObjectPtr
(
	UInt16 	objectID				// (in) ID of the object you want the pointer for
);
 
 extern void GetROMString
 ( 
 	UInt32		ROMVersion,			// (in) ROM version # 
 	char * 	ioROMStr				// (out) Char array to place version # string into
 );
 
extern Err OpenSharedLibrary	// (out) error code or zero	
( 		
	Char *		shLibNameP,			// (in) library name
	UInt32		shLibCreator,		// (in) library creator ID
	UInt16 *	ioshLibRefP			// (out) library reference number
);

extern Err CloseSharedLibrary	// (out) an error code or zero
(	
	UInt16		ioshLibRef			// (in) library reference number
);

extern Err SetTextFieldWithString//	(out)	result code
(	
	UInt16		textFldID,				//	(in)	the ID of the text field to set
	Char *		string,					//	(in)	C-string to set
	Boolean	drawIt				//	(in)	true to draw the text right away
);			
	
extern void SetTextFieldWithHandle
(
	UInt16			textFldID,			//	(in)	the ID of the text field to set
	MemHandle	textHdl,			//	(in)	handle containing a C-string
	Boolean		drawIt			//	(in)	true to draw the text right away
);			

extern void QuadToString
(
	UInt32			quad,				// (in) quad to convert
	Char *			out				// (in/out) string to contain results
);

extern Err OpenDatabase			// (out) error code or zero
(
	UInt32			dbType,			// (in) database type
	UInt32			dbCreator,		// (in) database creator
	UInt16			dbMode,			// (in) open mode
	DmOpenRef *	dbRef				// (out) database reference
);

 extern void GetRecordData
 (
	DmOpenRef	dbRef,				// (in) database to get the record from
	UInt16			itemNum,			// (in) record # to fetch
	Char *			dataStr			// (out) place to put the record data
 );
 
 extern Err CheckAppInfo
(
	DmOpenRef	dbRef				// (in) database to check the appInfo for
);

Boolean  CheckDatabaseMode	// (out) database is set to input mode
(
	DmOpenRef	dbRef,				// (in) the database to get the read-only status of
	UInt16			modeToCheck	// (in) the mode to check
);

void DebugMessage
(
		Char *m	// (in) Message for debugging...
);