. DirectXtras Home

DirectCommunication Xtra
DirectConnection Xtra
DirectControl Xtra
DirectEmail Xtra
DirectFTP Xtra
DirectImage Xtra
DirectInteraction Xtra
DirectOS Xtra
License Agreement
Licensing Fees
Order Form
DirectSMS Xtra
DirectSound Xtra
DirectTransition Xtra
DirectTransition3D Xtra Set I
DirectTransition3D Xtra Set II
DirectTransition3D Xtra Set III
DirectTTS Xtra
DirectXport Xtra


Special Discounted Bundles

The Gallery
How To Order
Order Form
Check for Upgrades

Sign in
Change Your Profile

Contact Us

Xtra Power for Director & Authorware

DirectOS Xtra
 Directing Windows and MacOS. The OS at your fingertips!

Authorware 4.x Compatible Authorware 5.x CompatibleAuthorware 6.x CompatibleAuthorware 7.x CompatibleDirector 5.x Compatible Director 6.x CompatibleDirector 7.x Compatible Director 8.x CompatibleDirector MX Compatible     MacOS 8.x and 9.x CompatibleWindows Compatible   

dosGetPrinter(string Info)

Returns information about the default settings of the default printer. The settings returned do not necessarily reflect the current settings in the host application's page setup and print dialogs. 

Parameter :

Info : A string specifying the type of information requested. The returned type and value will depend on the value of this parameter. This parameter is case insensitive. 
Possible Values For Windows And MacOS :
"Default Printer" : Returns a string containing the name of the default printer. 
"Orientation" : Returns a string containing the page orientation. This can be either "Portrait" or "Landscape". Portrait represents the printout as not being rotated and being taller than wider. Landscape represents the printout as being rotated 90 degrees clockwise or counterclockwise and being wider than taller. 
"Paper Size" : Returns a linear list of 2 floats containing the paper dimensions in inches. The first float is the width, the second float is the height. Note that this represents the paper dimensions and not the actual printable area of the paper. 
"Copies" : Returns an integer containing the default number of copies of a document to print. 
"Resolution" : Returns a linear list of 2 integers containing the horizontal and vertical resolution in dots per inch. The first integer is the horizontal resolution, the second integer is the vertical resolution. 
Possible Values For Windows Only :
"Available Printers" : Returns a linear list of strings containing the names of all available printers.
"Paper Type" : Returns a string containing the name of the paper type. This can be "Plain Paper", "Glossy Paper", "Transparency Paper" or "Unknown Paper". 

Return Values : Depends on the value of the Info parameter. If an error occurs, an empty string will be returned for the "Default Printer", "Orientation", and "Paper Types" flags. An empty list will be returned  for the "Paper Size", "Resolution", and "Available Printers" flags. A value of 0 will be returned for the "Copies" flag. In case of an error, dosGetLastError() should be called the determine the cause of the error.

Possible Returned Error Codes via dosGetLastError() :
10001 : Invalid value for parameter 1. 
10027 : No default printer on system. 

Remarks :

This function is not supported on MacOS X.

DirectXtras Inc.
P.O Box 2645, Menlo Park, CA, 94026, U.S.A
Voice: +1-415-5058249, Fax: +1-801-8585841
Toll Free: 1-800-4453093
E-mail General Information: info@directxtras.com
E-mail Technical Support: support@directxtras.com

Copyright 1996-2004 DirectXtras Inc. All Rights Reserved.
WebMaster: tamar@directxtras.com
Last Updated: 12/20/2002 4:53:02 AM.