fpSetStyleMapping()

This function is used to set the mapping for user-defined styles. Export does not make a distinction between paragraph styles or character styles, but operates under the assumption that each style has a unique name.

Syntax

BOOL pascal _export fpSetStyleMapping( 
    void        *pContext,
    KVStyle     *pStyles,
    int          iStyles,
    BOOL         bCopy);

Arguments

pContext

A pointer to a KeyView Export session that you initialized by calling fpInit().

pStyles

A pointer to the developer-assigned instance of KVStyle. See KVStyle . The KVStyle structure defines the elements of a custom style.

iStyles

The number of elements in the pStyles array.

bCopy

If Export is to allocate memory to copy the pStyles array, set this to TRUE. If pStyles remains valid throughout the conversion process, set this to FALSE.

Returns

  • If the call is successful, the return value is TRUE.

  • If this call is unsuccessful, the return value is FALSE.

Discussion

  • Paragraph styles are presently implemented only for documents in Microsoft Word 97-2003 (DOC), RTF, Folio Flat files, WordPro, and WordPerfect 6.x.

  • This function runs in-process or out-of-process. See Convert Files Out-of-Process.

  • When converting out-of-process, this function must be called after the call to KVXMLStartOOPSession() and before the call to KVXMLEndOOPSession(). See KVXMLStartOOPSession() and KVXMLEndOOPSession().

  • After this API function is called, the styles are valid until fpShutDown() is called, or until this function is called again with a new style or NULL.