| GEOS SDK TechDocs | | SpoolGetNumPaperSizes() ... | StreamOpen() ...

---

SpoolModifyPriority()

SpoolOpStatus 	SpoolModifyPriority(
        word 		jobID,
        ThreadPriority 		priority);

Use this routine to modify the priority of the thread that processes a print job's print queue.

SpoolSetDefaultPageSizeInfo()

void	SpoolSetDefaultPageSizeInfo(
        PageSizeReport		*psr);

Set the dimensions of the default system page.

Include: spool.goh

SpoolSetDefaultPrinter()

void 	SpoolSetDefaultPrinter(
        int prtrNum);		/* printer number */

Sets the system-default printer, used (for example) by PrintControlClass as the default printer. This routine is normally called from within the Preferences manager.

Include: spool.goh

SpoolSetDocSize()

void 	SpoolSetDocSize(
        Boolean 		open;			/* false if document is closed */
        PageSizeInfo 		* psr);			/* NULL if document is closed */

This routine tells the application's PageSizeControl object the document's size.

Include: spool.goh

SpoolSetPaperSizeOrder()

void 	SpoolSetPaperSizeOrder(
        byte	*orderArray, 		/* Array of paper siaes. Each element is 
				 * a byte signifying:
				 * 0-127  : a pre-defined paper size, or
				 * 128-255: a user-defined paper size. */

        word 	number, 		/* number of entries in array */
        PageType pageType);			/* page type (paper, envelope, label) */

This routine resets the order in which paper sizes are displayed to the user.

Include: spool.goh

SpoolVerifyPrinterPort()

SpoolOpStatus SpoolVerifyPrinterPort(
        PrintPortInfo *portInfo);

Use this routine to check for the existence of a printer port

SpreadsheetInitFile()

VMBlockHandle SpreadsheetInitFile(
        const SpreadsheetInitFileData					* ifd);

This routine initializes a VM file for use by the spreadsheet object. It allocates a spreadsheet map block in the file and initializes this block. The routine returns the map block's handle; applications will need to remember this handle. It does not change any existing blocks in the VM file.

The ifd parameter is pointer to a SpreadsheetInitFileData structure containing the file handle and the number of rows and columns to allocate.

Structures: The SpreadsheetInitFileData structure is defined as follows:

typedef struct {
	word				SIFD_file;
	word				SIFD_numRows;
	word 				SIFD_numCols;
	SpreadsheetDrawFlags				SIFD_drawFlags;
} SpreadsheetInitFileData;

/* SpreadsheetDrawFlags:
 * SDF_DRAW_GRAPHICS
 * SDF_DRAW_NOTE_BUTTON
 * SDF_DRAW_HEADER_FOOTER_BUTTON
 * SDF_DRAW_GRID				*/

Include: ssheet.goh

StreamClose()

StreamError StreamClose (
        GeodeHandle 		driver,
        StreamToken 		stream,
        Boolean 		linger);

This routine shuts down a stream. It is passed the following arguments:

driver

The GeodeToken of the stream driver.

stream

The StreamToken of the stream.

linger

Set true (i.e., non-zero) if the data currently in the stream should be kept until it's read; set false to flush the data immediately.

If the routine is successful, it returns zero. If it is unsuccessful, it returns a member of the StreamError enumerated type.

StreamFlush()

StreamError StreamFlush (
        GeodeHandle 		driver,
        StreamToken 		stream);

This routine flushes all the data pending in a stream. It is passed the following arguments:

driver

The GeodeToken of the stream driver.

stream

The StreamToken of the stream.

If the routine is successful, it returns zero. If it is unsuccessful, it returns a member of the StreamError enumerated type.

StreamGetError()

StreamError	 	StreamGetError (
        Handle 		driver,
        StreamToken 		stream,
        StreamRoles 		roles,
        word *		errorCode);

This routine returns any driver-specific error codes set by the last call to a stream routine. It takes the following arguments:

driver

The GeodeToken of the stream driver.

stream

The StreamToken of the stream.

role

If this is STREAM_ROLES_WRITER, the routine will return the last error from a write operation. If it is STREAM_ROLES_READER, it will return the last error from a read operation.

errorCode

A pointer to a word-sized variable. The device's error code is written to this variable.

If the routine is successful, it returns zero and writes the device's last error code into the errorCode variable. If it is unsuccessful, it returns a member of the StreamError enumerated type.