typedef struct tag_EPNENHOPTIONS
{
L_UINT uStructSize;
L_BOOL bEnhancedOptions;
EEPNVERTICALALIGNMENT VerticalAlign;
EEPNHORIZONTALALIGNMENT HorizontalAlign;
EEPNLAYOUTS Layout;
EEPNMARGIN Margin;
EEPNBORDERS Borders;
EEPNPRINTINGMETHOD PrintingMethod;
EEPNGUTTERDIMENSIONUNITS GutterUnit;
L_UINT uGutter;
L_BOOL bGutterInside;
L_INT nGutterWidth;
L_UINT uOrdering;
L_INT nMarginOffset;
L_BOOL bRepeat;
L_BOOL bBestFit;
L_BOOL bRL;
} EPNENHOPTIONS, L_FAR * pEPNENHOPTIONS;
The EPNENHOPTIONS structure provides information about enhanced printing options.
|
Member |
Description |
|
|
uStructSize |
Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value. |
|
|
bEnhancedOptions |
Flag that indicates whether to use enhanced printing options. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Use the enhanced printing options. |
|
|
FALSE |
Do not the enhanced printing options. |
|
VerticalAlign |
Value that determines the vertical alignment of the pages when printing using the enhanced printing options. For a list of possible values, refer to the EEPNVERTICALALIGNMENT enumeration. Use this member only if the value of the bBestFit member is set to TRUE. |
|
|
HorizontalAlign |
Value that determines the horizontal alignment of the pages when printing using the enhanced printing options. For a list of possible values, refer to the EEPNHORIZONTALALIGNMENT enumeration. Use this member only if the value of the bBestFit member is set to TRUE. |
|
|
Layout |
Value that determines the layout of pages to be used when printing using the enhanced printing options. For a list of possible values, refer to the EEPNLAYOUTS enumeration. |
|
|
Margin |
Value that determines the margin to be used when printing using the enhanced printing options. For a list of possible values, refer to the EEPNMARGIN enumeration. |
|
|
Borders |
Value that determines the borders to be drawn around the pages when printing using the enhanced printing options. For a list of possible values, refer to the EEPNBORDERS enumeration. |
|
|
PrintingMethod |
Value that determines the duplex printing method to be used when printing using the enhanced printing options. For a list of possible values, refer to the EEPNPRINTINGMETHOD enumeration. |
|
|
GutterUnit |
Value that determines units for the Gutter dimensions to be used when printing using the enhanced printing options. For a list of possible values, refer to the EEPNGUTTERDIMENSIONUNITS enumeration. |
|
|
uGutter |
Flags that indicate the gutter placement. Possible values are: |
|
|
|
Value |
Meaning |
|
|
EPN_GUTTER_NONE |
[0x00000000] Do not use gutters. |
|
|
EPN_GUTTER_LEFT |
[0x00000001] Use left gutter. |
|
|
EPN_GUTTER_RIGHT |
[0x00000002] Use right gutter. |
|
|
EPN_GUTTER_TOP |
[0x00000004] Use top gutter. |
|
|
EPN_GUTTER_BOTTOM |
[0x00000008] Use bottom gutter. |
|
|
These values are valid for all page layouts except booklet (The value of the Layout member is set to EPN_BOOKLET_LAYOUT). |
|
|
bGutterInside |
Flag that indicates whether to use a gutter when the page layout is booklet only (The value of the Layout member is set to EPN_BOOKLET_LAYOUT). Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Use inside gutter. |
|
|
FALSE |
Do not use inside gutter. |
|
nGutterWidth |
Value that represnts the width of the gutter. The unit of this value depends on the value of the GutterUnit member. |
|
|
uOrdering |
Value that represents the ordering of pages on the printed sheet to be used when printing using the enhanced printing options. Use this member only if the page layout is not single (The Layout member value is set to a value other than EPN_SINGLE_LAYOUT). Possible values are: |
|
|
|
Value |
Meaning |
|
|
EPN_ORDERING_HORIZONTAL |
[0x00000001] Draw the pages across then draw them down. |
|
|
EPN_ORDERING_VERTICAL |
[0x00000002] Draw the pages down then draw them across. |
|
|
EPN_ORDERING_PDFLAYOUT |
[0x00000004] This option will cause the drawing of pages per sheet to start at the lower left corner instead of the upper left. This will be clear when layout is set to 4 X or 8 X. |
|
nMarginOffset |
The Margin value. Use this member only if the value of the Margin member is EPN_MARGIN_CUSTOM. |
|
|
|
This value represents the percent of the margin space to the paper space. For example, if 80 is set for this member, then the margins will be: |
|
|
|
Left Margin = 40% of the paper width. |
|
|
|
Right Margin = 40% of the paper width. |
|
|
|
(Left + Right = 80%) |
|
|
|
Top Margin = 40% of the paper height. |
|
|
|
Bottom Margin = 40% of the paper height. |
|
|
|
(Top + Left = 80%) |
|
|
bRepeat |
Flag that indicates whether to repeat pages on the sheet when the page layout is not single (the Layout member is set to a value other than EPN_SINGLE_LAYOUT). Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Repeat pages. |
|
|
FALSE |
Do not repeat. |
|
bBestFit |
Flag that indicates whether to draw the pages on the sheet using the best fit option. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Use the best fit option. The VerticalAlign and HorizontalAlign member values are valid. |
|
|
FALSE |
Do not use best fit. |
|
bRL |
Flag that indicates whether to arrange the pages on the printed sheet from the right to the left or from the left to the right. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Arrange the pages from the right to the left. |
|
|
FALSE |
Arrange the pages from the left to the right. |
Comments
This structure is used within the EPNBATCHPRINTERINFO structure and L_EpnGetDefaultEnhancedOptions function.