Sets a Boolean value indicating whether page margins are retained or their default values are used.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_REC_converter_pagemargins_usage_set( LPCSTR lpszFormatName, AT_BOOL bUsePageMargins ); |
|
Arguments:
| lpszFormatName | Symbolic name of the output format like Converters.Text.Cvs. |
| bUsePageMargins | Boolean value to be set. TRUE means that the default page margins should be used when saving recognition results. FALSE retains margins. |
Return Value:
The number of ImageGear errors that occurred during the function call.Supported Raster Image Formats:
This function does not process image pixels.
Remarks:
The function affects the following output formats:
- Converters.Text.Csv
- Converters.Text.DocX
- Converters.Text.Excel2000
- Converters.Text.Excel97
- Converters.Text.FormattedTxt
- Converters.Text.Html32
- Converters.Text.Html40
- Converters.Text.Kindle
- Converters.Text.PowerPoint97
- Converters.Text.PptX
- Converters.Text.Publisher98
- Converters.Text.RTF2000
- Converters.Text.RTF6
- Converters.Text.RTF97
- Converters.Text.Text
- Converters.Text.TextWithLinebreaks
- Converters.Text.UCsv
- Converters.Text.UFormattedTxt
- Converters.Text.UText
- Converters.Text.UTextWithLinebreaks
- Converters.Text.Word2000
- Converters.Text.Word97
- Converters.Text.WordML
- Converters.Text.WordPad
- Converters.Text.WordPerfect10
- Converters.Text.XlsX
Margins usage flag can't be set if the corresponding output format has not been selected with IG_REC_output_format_set at least once. In this case the function returns a non-zero value and appends IGE_REC_CONVERTER_NOT_INITIALIZED error code to the error stack.
Example:
| Copy Code |
|
|---|---|
AT_ERRCOUNT ErrCount = 0;
AT_BOOL bUsePageMargins = FALSE;
LPCSTR lpszFormatName = "Converters.Text.Csv";
ErrCount += IG_REC_output_format_set(lpszFormatName);
ErrCount += IG_REC_converter_pagemargins_usage_set(lpszFormatName, bUsePageMargins);
|
|