EPNPRINTERSPECIFICATIONS

typedef struct tag_EPNPRINTERSPECIFICATIONS
{
   L_UINT uStructSize; 
   L_UINT uPaperID; 
   L_CHAR szPaperSizeName[ MAX_STRING ]; 
   L_DOUBLE dPaperWidth; 
   L_DOUBLE dPaperHeight; 
   L_BOOL bDimensionsInInches; 
   L_BOOL bPortraitOrient; 
   L_CHAR szMarginsPrinter[ MAX_PRINTER_NAME ]; 
   L_INT nPrintQuality;
   L_INT nYResolution;
   L_INT nPrintQuality; 
   L_INT nYResolution; 
} EPNPRINTERSPECIFICATIONS, L_FAR * pEPNPRINTERSPECIFICATIONS;

The EPNPRINTERSPECIFICATIONS structure provides information about the print quality, paper size, paper orientation, and paper margins.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.

uPaperID

Value that represents the paper size. This value can be any of the predefined paper size IDs. For a list of possible values, refer to the dmPaperSize member of the DEVMODE structure in the Microsoft® Platform SDK help file.

 

Also the value can be a custom paper size ID. Custom paper IDs start from the value of DMPAPER_USER + 200.

szPaperSizeName

Character string that contains the name of the custom paper size.

dPaperWidth

Value that represents the width of the paper measured in inches or in millimeters. The unit of the paper width is determined by the value of the member bDimensionsInInches.

dPaperHeight

Value that represents the height of the paper measured in inches or in millimeters. The unit of the paper height is determined by the value of the member bDimensionsInInches.

bDimensionsInInches

Flag that indicates whether the values of the dPaperWidth and dPaperHeight members are measured in inches or in millimeters units. Possible values are:

 

Value

Meaning

 

TRUE

Dimensions in inches.

 

FALSE

Dimensions in millimeters.

bPortraitOrient

Flag that indicates whether the paper orientation is portrait or landscape. Possible values are:

 

Value

Meaning

 

TRUE

Portrait paper.

 

FALSE

Landscape paper.

szMarginsPrinter

Character string that contains the name of the printer that will be used to simulate margins.

nPrintQuality

Value that represents the print quality or the X resolution to be used for printing. Possible values are:

 

Value

Meaning

 

The print quality predefined values:

 

DMRES_DRAFT

[-1] Use draft resolution (96 DPI).

 

DMRES_LOW

[-2] Use low resolution (150 DPI).

 

DMRES_MEDIUM

[-3] Use medium resolution (300 DPI).

 

DMRES_HIGH

[-4] Use high resolution (600 DPI).

 

The X resolution in DPI positive possible values:

 

From 50 to 1600.

nYResolution

Value that represents the Y resolution to be used for printing. If the value of the nPrintQuality member is one of the print quality predefined values, this value will be ignored. Otherwise, this value should be the same as the value of nPrintQuality member.

Comments

This structure is used with L_EpnSetPrinterSpecifications and L_EpnGetPrinterSpecifications.