EPNHTMOPTIONS

typedef struct tag_EPNHTMOPTIONS
{
    L_UINT uStructSize; 
    L_CHAR szTitle [ MAX_STRING ]; 
    COLORREF rgbBackground
   EEPNCOMPATIBILITY Compatibility; 
   L_BOOL bUnicoded; 
   L_BOOL bEnableURLDetect; 
   L_BOOL bUnderline; 
   L_BOOL bForceHyperlinkColor; 
   COLORREF rgbHyperlink; 
   L_BOOL bForceEmbed; 
   L_BOOL bAutoEmbed; 
   L_BOOL bEmbedAll; 
   L_INT nEmbeddedFontsCount; 
   L_BOOL bArrChecked[ MAX_EMBEDDED_FONTS ]; 
   L_BOOL bArrEmbedable[ MAX_EMBEDDED_FONTS ]; 
   L_CHAR strArrFonts[ MAX_EMBEDDED_FONTS ][ MAX_STRING ]; 
} EPNHTMOPTIONS, L_FAR * pEPNHTMOPTIONS;

The EPNHTMOPTIONS structure provides information about HTML pages properties.

Member

Description

uStructSize

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

szTitle

Character string that contains the title of the HTML page.

rgbBackground

COLORREF value that spcefies the background color of the HTML page.

Compatibility

Value that determines the compatibility of the generated HTML files with the Internet browsers. For a list of possible values, refer to EEPNCOMPATIBILITY enumeration.

bUnicoded

Flag that indecates whether to generate HTML files with UNICODE support. Possible values are:

 

Value

Meaning

 

TRUE

Support UNICODE. The generated HTML files will be larger in size.

 

FALSE

Do not support UNICODE.

bEnableURLDetect

Flag that indicates whether to enable URL detection in the HTML page. Possible values are:

 

Value

Meaning

 

TRUE

Enable URL detection.

 

FALSE

Disable URL detection.

bUnderline

Flag that indicates whether to underline the detected URLs in the HTML page. Use this member only if the value of the bEnableURLDetect is set to TRUE. Possible values are:

 

Value

Meaning

 

TRUE

Underline the detected URLs.

 

FALSE

Do not underline the detected URLs.

bForceHyperlinkColor

Flag that indicates whether to use a custom color for the detected URLs. Use this member only if the value of the bEnableURLDetect is set to TRUE. Possible values are:

 

Value

Meaning

 

TRUE

Use a custom color for the detected URLs.

 

FALSE

Do not use a custom color for the detected URLs.

rgbHyperlink

COLORREF value that specifies the custom color to be used for the detected URLs. Use this member only if the value of the bForceHyperlinkColor is set to TRUE.

bForceEmbed

Flag that indicates whether to embed Licensed Fonts in the HTML pages. Possible values are:

 

Value

Meaning

 

TRUE

Embed the Licensed Fonts. For more information about embedding licensed fonts, refer to Licensed Fonts.

 

FALSE

Do not embed licensed fonts.

bAutoEmbed

Flag that indicates whether to automatically embed fonts in the HTML pages. The automatically embedding fonts process depends on the font file size, and how common this font is. Possible values are:

 

Value

Meaning

 

TRUE

Automatically embed fonts.

 

FALSE

Not automatically embed fonts.

bEmbedAll

Flag that indicates whether to embed all fonts, including licensed fonts, in the HTML pages. Possible values are:

 

Value

Meaning

 

TRUE

Embed all fonts. For more information about embedding licensed fonts, refer to Licensed Fonts.

 

FALSE

Do not embed all fonts.

nEmbeddedFontsCount

Value that represents the number of embedded fonts. It determines the number of elements in the bArrChecked, bArrEmbedable, and strArrFonts arrays. The maximum value for this member is MAX_EMBEDDED_FONTS.

 

Use this member only if the value of the bEmbedAll is set to FLASE.

bArrChecked

Array of flags. Each element in this array is a flag that indicates whether the font at the same index in the strArrFonts array will be embedded. Use this member only if the value of the bEmbedAll is set to FLASE. Possible values are:

 

Value

Meaning

 

TRUE

The font will be embedded.

 

FALSE

The font will not be embedded.

 

The number of elements in this array is specified by the value of nEmbeddedFontsCount member.

bArrEmbedable

Array of flags. Each element in this array is a flag that indicates whether the font at the same index in the strArrFonts array is a licenced font. Use this member only if the value of the bEmbedAll is set to FLASE. Possible values are:

 

Value

Meaning

 

TRUE

The font is not licenced.

 

FALSE

The font is licenced.

 

The number of elements in this array is specified by the value of nEmbeddedFontsCount member.

strArrFonts

Array of character strings. Each element in this array is a character string that contains the name of the font to be used while saving HTML pages.

 

The number of elements in this array is specified by the value of nEmbeddedFontsCount member.

 

Use this member only if the value of the bEmbedAll is set to FLASE.

Comments

This structure is used within EPNDOCUMENTOPTIONS structure.