Sets the string that separates the lines in the output document.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_REC_converter_linebreak_set( LPCSTR lpszFormatName, LPAT_WCHAR lpwszLineBreak ); |
Arguments:
lpszFormatName | Symbolic name of the output format like Converters.Text.Cvs. See IG_REC_output_format_set for more info about format names. |
lpwszLineBreak | String to be set as line break. |
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.UCsv
- Converters.Text.Text
- Converters.Text.UText
- Converters.Text.TextWithLinebreaks
- Converters.Text.UTextWithLinebreaks
- Converters.Text.FormattedTxt
- Converters.Text.UFormattedTxt
The line break string 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_INT iLength = 0; AT_BOOL bCLBIsApplicable = FALSE; LPCSTR lpszFormatName = "Converters.Text.Csv"; LPAT_WCHAR lpwszLinebreak = L"This is the beginning of a paragraph"; ErrCount += IG_REC_output_format_set(lpszFormatName); ErrCount += IG_REC_converter_linebreak_is_applicable(lpszFormatName, &bCLBIsApplicable); if(bCLBIsApplicable) ErrCount += IG_REC_converter_linebreak_set(lpszFormatName, lpwszLinebreak); |