EPNNAMINGOPTIONS

typedef struct tag_EPNNAMINGOPTIONS
{
   L_UINT uStructSize; 
   L_CHAR szTagOptions[ L_MAXPATH ]; 
   EEPNDATETYPE DateType; 
   EEPNTIMETYPE TimeType; 
   EEPNSRCCASE SrcCase; 
   EPNNUMTAGDATA structNum; 
   EPNALPHATAGDATA structAlpha; 
   EPNALPHANUMTAGDATA structAlphaNum; 
} EPNNAMINGOPTIONS, L_FAR * pEPNNAMINGOPTIONS;

The EPNNAMINGOPTIONS structure provides file name options for the save operation.

Member

Description

uStructSize

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

szTagOptions

Character string that contains the type of tag to be used. You can use any of the following predefined strings:

 

Value

Meaning

 

<NUM>

The target file name will contain a numeric counter, where the counter size, and behavior are dependent on the structNum settings.

 

<ALPHA>

The target file name will contain an alphabetical counter, where the counter size, and behavior are dependent on the structAlpha settings.

 

<ALPHANUM>

The target file name will contain a counter of mixed alphabetical and numeric symbols, where the counter size, and behavior are dependent on the structAlphaNum settings.

 

<DATE>

The target file name will contain the date when the naming template is applied, where the date format is dependent on the value of DateType.

 

<TIME>

The target file name will contain the time when the naming template is applied, where the time format is dependent on the value of TimeType.

 

<SRC>

The target file name will contain the source file name, where the character’s upper and lower cases are dependent on the value of SrcCase.

DateType

Value that determines the date format. For a list of possible values, refer to the EEPRINTCALLBACKTYPE enumeration. This value will be used to determine the date format if the <DATE> string is used in szTagOptions.

TimeType

Value that determines the time format. For a list of possible values, refer to the EEPNTIMETYPE enumeration. This will be used to determine the time format if the <TIME> string is used in szTagOptions.

SrcCase

Value that determines the letters cases to be used in generating file names. For a list of possible values, refer to the EEPNSRCCASE enumeration. This will be used to determine the characters case if the <SRC> string is used in szTagOptions.

structNum

EPNNUMTAGDATA structure that contains numerical digits that will be used when the <NUM> string is used in szTagOptions.

structAlpha

EPNALPHATAGDATA structure that contains characters that will be used when the <ALPHA> string is used in szTagOptions.

structAlphaNum

EPNALPHANUMTAGDATA structure that contains numerical digits and characters that will be used when the < ALPHANUM> string is used in szTagOptions.

Comments

This structure is used when multi-page print jobs will be saved separately (i.e. each page in a separate file).

This structure is used with the EPNPRINTERSAVEOPTIONS structure and L_EpnGetDefaultNamingOptions function.