In This Topic ▼

LFileSettings::SetRTFOptions

Summary

Sets the file options used by LEADTOOLS when loading RTF files.

Syntax

#include "ltwrappr.h"

static L_INT LFileSettings::SetRTFOptions(pOptions)

Parameters

const pFILERTFOPTIONS pOptions

Pointer to a structure that contains the options to use when loading RTF files.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The uStructSize member of the FILERTFOPTIONS structure must be set before calling this function.

The values set by this function are valid for the current thread. To change the values used by the current thread, this function must be called again.

For a list of functions that utilize the LOADFILEOPTION or SAVEFILEOPTION structures, refer to the Usage section of their documentation.

Required DLLs and Libraries

LTFIL
File format DLLs
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

This example loads a RTF file, with a top margin, bottom margin, left margin, right margin defined by the user.

L_INT LFileSettings__SetRTFOptionsExample(L_TCHAR* pszRTFFileName, LBitmap* plBitmap, L_DOUBLE dTopMarg, L_DOUBLE dBottomMarg, L_DOUBLE dLeftMarg, L_DOUBLE dRightMarg) 
 
{ 
   L_INT nRet; 
   FILERTFOPTIONS RtfOptions; 
 
   RtfOptions.uStructSize = sizeof(FILERTFOPTIONS); 
 
   /* Get the current RTF options */    
   nRet = LFileSettings::GetRTFOptions(&RtfOptions,sizeof(FILERTFOPTIONS));  
   if(nRet != SUCCESS) 
      return nRet; 
 
   RASTERIZEDOCOPTIONS docOpts; 
   memset(&docOpts, 0, sizeof(RASTERIZEDOCOPTIONS)); 
   LFileSettings::GetRasterizeDocOptions(&docOpts, sizeof(RASTERIZEDOCOPTIONS)); 
 
   /*Change margin values */ 
   docOpts.dTopMargin     = dTopMarg;  
   docOpts.dBottomMargin  = dBottomMarg;  
   docOpts.dLeftMargin    = dLeftMarg;  
   docOpts.dRightMargin   = dRightMarg;  
 
   LFileSettings::SetRasterizeDocOptions(&docOpts); 
 
   /* Set new RTF options */ 
   nRet = LFileSettings::SetRTFOptions(&RtfOptions);  
   if(nRet != SUCCESS) 
      return nRet; 
 
   /* Now load the RTF file */ 
   nRet = plBitmap->Load(pszRTFFileName, 
                  0, 
                  ORDER_RGB, 
                  NULL, 
                  NULL ); 
 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}