RTFDOCWORDMLSETTINGS

typedef struct _tagRtfDocWordMLSettings 
{ 
   L_UINT32 uStructSize; 
   L_BOOL bBullets; 
   L_BOOL bCharColors; 
   L_BOOL bCharScaling; 
   L_BOOL bCharSpacing; 
   L_BOOL bColumnBreaks; 
   L_BOOL bConsolidatePages; 
   L_CHAR * pszDocAuthor; 
   L_CHAR * pszDocCategory; 
   L_CHAR * pszDocComments; 
   L_CHAR * pszDocCompany; 
   L_CHAR * pszDocKeywords; 
   L_CHAR * pszDocManager; 
   L_CHAR * pszDocSubject; 
   L_CHAR * pszDocTitle; 
   L_BOOL bDropCaps; 
   L_BOOL bFieldCodes; 
   DOC2_HEADERFOOTERSETTING HFSetng; 
   L_BOOL bLineBreaks; 
   DOC2_FORMATLEVEL OutputMode; 
   DOC2_PAGEBREAKSETTING PgBreakValue; 
   L_BOOL bPageColor; 
   DOC2_DPISETTING DpiSetng; 
   L_BOOL bRuleLines; 
   L_BOOL bStyles; 
   DOC2_TABLESETTING TableSetng; 
   L_BOOL bTabs; 
} RTFDOCWORDMLSETTINGS, * pRTFDOCWORDMLSETTINGS; 

The RTFDOCWORDMLSETTINGS structure provides information for the common settings of the following output formats:

• DOC2_RTF_6
• DOC2_RTF_97
• DOC2_RTF_2000
• DOC2_RTF_WORD_2000
• DOC2_WORD_2000
• DOC2_WORD_97
• DOC2_WORDML

Members

uStructSize

Structure size. Set it to sizeof(RTFDOCWORDMLSETTINGS).

bBullets

Specifies whether bullets are in the document. Possible values are:

bCharColors

Specifies whether the colors of the characters should be kept. Possible values are:

bCharScaling

Specifies  whether to keep character scaling. Possible values are:

bCharSpacing

Specifies whether to keep character spacing. Possible values are:

bColumnBreaks

Specifies whether to keep column breaks. Possible values are:

bConsolidatePages

Specifies whether to consolidate pages. Possible values are:

pszDocAuthor

Character string that specifies the author of the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocCategory

Specifies the category of the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocComments

Specifies the comments for the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocCompany

Specifies the company name of the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocKeywords

Specifies the keywords for the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocManager

Specifies the name of the manager of the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocSubject

Specifies the subject of the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

pszDocTitle

Specifies the title of the document.

The toolkit allocates memory internally for this member using the Windows GlobalAllocPtr macro. When the structure is no longer needed, be sure to use the Windows GlobalFreePtr macro to free the memory allocated by the toolkit if it contains a valid pointer (not NULL).

bDropCaps

Specifies whether to use drop caps. Possible values are:

bFieldCodes

Specifies whether to retain field codes. Possible values are:

HFSetng

Specifies the header and footer settings for the document. For a list of possible values, refer to DOC2_HEADERFOOTERSETTING.

bLineBreaks

Specifies whether to insert line breaks. Possible values are:

OutputMode

Specifies output mode. For list of possible values, refer to DOC2_FORMATLEVEL.

PgBreakValue

Enumerated values that specify how to handle page breaks . For list of possible values, refer to DOC2_PAGEBREAKSETTING.

bPageColor

Specifies whether to retain the page background color or use the default.

DpiSetng

Specifies the DPI setting. For a list of possible values, refer to DOC2_DPISETTING.

bRuleLines

Specifies whether to insert rule lines. Possible values are:

bStyles

Specifies whether to retain styles. Possible values are:

TableSetng

Specifies the table settings. For a list of possible values, refer to DOC2_TABLESETTING.

bTabs

Specifies whether to retain the original tab positions or to use the defaults. Possible values are:

Comments

pRTFDOCWORDMLSETTINGS is a pointer to a RTFDOCWORDMLSETTINGS structure. If the function parameter type is pRTFDOCWORDMLSETTINGS, declare a RTFDOCWORDMLSETTINGS variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pRTFDOCWORDMLSETTINGS variable is necessary only if the program requires a pointer.

The structure is used by:

• L_Doc2GetOutputFormatSettings
• L_Doc2GetOutputFormatSettingsExt
• L_Doc2SetOutputFormatSettings
• L_Doc2SetOutputFormatSettingsExt