[ROOT] --> C++Client

class PCREExportOptions
    inherited from virtual public PCRESynchronized

The PCREExportOptions encapsulates the process of exporting a report to an output format.

There are many output forms that may be used. The output forms are selected by the use of constants.
The constants currently in use are as follows:

Author:
Copyright (c) 2000 Dynalivery Corp., All Rights Reserved.

Version:
2.4.0

Source:
MobileApps\PCRE\CppClient\Include\pcreexports.h

Constructors Index

PCREExportOptions
Create a new PCREExportOptions class. This will default to having no destination setup.
~PCREExportOptions
Default constructor.


Enums Index

{


Methods Index

getCharFieldDelimiter
Return the character deliminator that will be used for the exporting, if relevent.
getCharStringDelimiter
Return the character deliminator that will be used for the exporting, if relevent.
getDestinationDLLName
Get the name of the DLL that will be used for the exporting.
getDestinationType
Find the type of output that will be generated.
getDiskFileName
Return the name of the output file. This will probably not be used, the ideal thing to use is the function refering to the output type is being generated, such as getHTMLFileName..
getExcelTabHasColumnHeadings
Test to see whether output to Excel format should have column headings.
getExchangeDestinationType
getExchangeFolderPath
getExchangeProfile
getFormatDLLName
Get the name of the DLL that will be used for the formatting.
getFormatType
Return the type of format.
getHTMLFileName
Get the name of the output file when generating HTML.
getLinesPerPage
Get the number of lines to use per page when exporting to text.
getMailBccList
Get the list of addresses to be used when using VIM Mail Export. This function is meaningless for MAPI.
getMailCCList
Get the list of addresses to be used when using VIM or MAPI Mail Export.
getMailMessage
Get the message to be sent when using VIM or MAPI Mail Export.
getMailSubject
Get the subject of the message to be sent when using VIM or MAPI Mail Export.
getMailToList
Get the recipients of the message to be sent when using VIM or MAPI Mail Export
getODBCExportTableName
Get the export table name for the ODBC source.
getODBCSourceName
Get the source for the ODBC source name
getODBCSourcePassword
Get password for the ODBC source.
getODBCSourceUserID
Get user ID for the ODBC source.
getOptions
Get the PEExportOptions that this object represents. This can be useful when exploring this object, and for passing to the export methods of the PCREJob class.
getPDFFileName
Get the output filename for the PDF export.
getPSFileName
Get the output postscript filename for the PDF export.
getUseReportDateFormat
See whether the job should use the report date format for DIF output
getUseReportNumberFormat
See whether the job should use the report number format for DIF output
Reset
Reset the state of this object.
setCharFieldDelimiter
Set the character deliminator that will be used for the exporting, if relevent.
setCharStringDelimiter
Set the character deliminator that will be used for the exporting, if relevent.
setDestinationType
Change the type of output that will be generated.
setDiskFileName
Set the name of the output file. This will probably not be used, the ideal thing to use is the function refering to the output type is being generated, such as setHTMLFileName..
setExcelTabHasColumnHeadings
Specify whether output to Excel format should have column headings.
setExchangeDestinationType
setExchangeFolderPath
setExchangeProfile
setFormatType
Change the type of format.
setHTMLFileName
Set the name of the output file when generating HTML. [See the example above]
setLinesPerPage
Set the number of lines to use per page when exporting to text.
setMailBCCList
Set the list of addresses to be used when using VIM Mail Export. This option is meaningless for MAPI.
setMailCCList
Set the list of addresses to be used when using VIM or MAPI Mail Export.
setMailCCList
Set the list of addresses to be used when using VIM or MAPI Mail Export.
setMailMessage
Set the text of the message to be sent when using VIM or MAPI Mail Export.
setMailMessage
Set the text of the message to be sent when using VIM or MAPI Mail Export.
setMailSubject
Set the subject of the message to be sent when using VIM or MAPI Mail Export.
setMailSubject
Set the subject of the message to be sent when using VIM or MAPI Mail Export.
setMailToList
Set the recipients of the message to be sent when using VIM or MAPI Mail Export
setMailToList
Set the recipients of the message to be sent when using VIM or MAPI Mail Export
setODBCExportTableName
Set the export table name for the ODBC source.
setODBCSourceName
Set the source for the ODBC source name
setODBCSourcePassword
Set password for the ODBC source.
setODBCSourceUserID
Set user ID for the ODBC source.
setPDFFileName
Set the output filename for the PDF export.
setPSFileName
Set the postscript output filename for the PDF export.
setUseReportDateFormat
Specify whether the to use the report date format for DIF output
setUseReportNumberFormat
Specify whether the to use the report number format for DIF output


Constructors

PCREExportOptions

 PCREExportOptions ( int ftag = crEFTNoFormat ,
                           int tag = crEDTNoDestination ) ;

Create a new PCREExportOptions object. The default has no destination setup.

PCREExportOptions

 ~ PCREExportOptions ( ) ;

Default destructor.


Enums

{

 enum { crEDTNoDestination = 0 ,
              crEDTDiskFile = 1 ,
              crEDTMailMAPI = 2 ,
              crEDTMailVIM = 3 ,
              crEDTMicrosoftExchange = 4 ,
              crEFTNoFormat = 0 ,
              crEFTCrystalReport = 1 ,
              crEFTDataInterchange = 2 ,
              crEFTRecordStyle = 3 ,
              crEFTRichText = 4 ,
              crEFTCommaSeparated = 5 ,
              crEFTTabSeparated = 6 ,
              crEFTCharSeparated = 7 ,
              crEFTText = 8 ,
              crEFTTabSeparatedText = 9 ,
              crEFTPaginatedText = 10, ,
              crEFTLotus123Wks = 11, ,
              crEFTLotus123WK1 = 12, ,
              crEFTLotus123WK3 = 13, ,
              crEFTWordForWindows = 14, ,
              crEFTWordForDOS = 15, ,
              crEFTWordPerfect = 16, ,
              crEFTQuattroPro50 = 17, ,
              crEFTExcel21 = 18, ,
              crEFTExcel30 = 19, ,
              crEFTExcel40 = 20, ,
              crEFTExcel50 = 21, ,
              crEFTExcel50Tabular = 22, ,
              crEFTODBC = 23, ,
              crEFTHTML32Standard = 24, ,
              crEFTExplorer32Extend = 25, ,
              crEFTNetscape20 = 26, ,
              crEFTPDFWriter = 30, ,
              crEFTPDFDistiller = 31, ,
              crEFTPDFMasLib = 32, ,
              crExchangePostDocMessage = 1011, ,
              crExchangeFolderType = 0 } ;


Methods

Reset

 void Reset ( ) ;

Reset the state of this object.

getOptions

 PEExportOptions * getOptions ( ) ;

Get the PEExportOptions that this object represents. This can be useful when exploring this object, and for passing to the export methods of the PCREJob class.

Return:
A PEExportOptions object containing the settings from this object.

getDestinationType

 int getDestinationType ( ) ;

Find the type of output that will be generated.

Return:
The constant describing the output type.

setDestinationType

 void setDestinationType ( int tag ) ;

Change the type of output that will be generated.

Parameters:
tag The new constant describing the output type, this should be one of the constants above.

getDestinationDLLName

 const char * getDestinationDLLName ( ) ;

Get the name of the DLL that will be used for the exporting.

Return:
The name of the DLL that will be used for the exporting process.

getFormatType

 int getFormatType ( ) ;

Return the type of format.

Return:
The format type.

setFormatType

 void setFormatType ( int tag ) ;

Change the type of format.

Parameters:
tag The new format type.

getFormatDLLName

 const char * getFormatDLLName ( ) ;

Get the name of the DLL that will be used for the formatting.

Return:
The name of the DLL that will be used for the formatting process.

setCharFieldDelimiter

 void setCharFieldDelimiter ( char * fd ) ;

Set the character deliminator that will be used for the exporting, if relevent.

Parameters:
fd The new deliminator character.

getCharFieldDelimiter

 const char * getCharFieldDelimiter ( ) ;

Return the character deliminator that will be used for the exporting, if relevent.

Return:
The deliminator character.

setCharStringDelimiter

 void setCharStringDelimiter ( char sd ) ;

Set the character deliminator that will be used for the exporting, if relevent.

Parameters:
fd The new deliminator character.

getCharStringDelimiter

 char getCharStringDelimiter ( ) ;

Return the character deliminator that will be used for the exporting, if relevent.

Return:
The deliminator character.

setDiskFileName

 void setDiskFileName ( char * name ) ;

Set the name of the output file.

Parameters:
name The disk output file name.

getDiskFileName

 const char * getDiskFileName ( ) ;

Return the name of the output file.

Return:
The disk output file name.

setExcelTabHasColumnHeadings

 void setExcelTabHasColumnHeadings ( BOOL value ) ;

Specify whether output to Excel format should have column headings.

Parameters:
value True if there should be headings, false otherwise.

getExcelTabHasColumnHeadings

 BOOL getExcelTabHasColumnHeadings ( ) ;

Test to see whether output to Excel format should have column headings.

Return:
True if there should be headings, false otherwise.

setExchangeDestinationType

 void setExchangeDestinationType ( int value ) ;

getExchangeDestinationType

 int getExchangeDestinationType ( ) ;

setExchangeFolderPath

 void setExchangeFolderPath ( char * path ) ;

Change the path that describes where the Exchange Folder lives.

getExchangeFolderPath

 const char * getExchangeFolderPath ( ) ;

Retrieve the path describing where the Exchange Folder lives.

Return:
The absolute path of the Exchange Folder.

setExchangeProfile

 void setExchangeProfile ( char * profile ) ;

Change the Exchange profile.

getExchangeProfile

 const char * getExchangeProfile ( ) ;

Retrieve the contents of the Exchange profile.

setHTMLFileName

 void setHTMLFileName ( char * name ) ;

Set the name of the output file when generating HTML.

Parameters:
name The name of the file in which to write HTML output.

getHTMLFileName

 const char * getHTMLFileName ( ) ;

Get the name of the output file when generating HTML.

Return:
The name of the file in which to write HTML output.

setMailBCCList

 void setMailBCCList ( char * list ) ;

Set the list of addresses to be used when using VIM Mail Export. Note: This option is meaningless for MAPI.

Parameters:
list A list of e-mail addresses to be used in the BCC: header field.

getMailBccList

 const char * getMailBccList ( ) ;

Get the list of addresses to be used when using VIM Mail Export. Note: This function is meaningless for MAPI.

Return:
A list of e-mail addresses to be used in the BCC: header field.

setMailCCList

 void setMailCCList ( char * list ) ;

Set the list of addresses to be used when using VIM or MAPI Mail Export.

Parameters:
list A list of e-mail addresses to be used in the CC: header field.

setMailCCList

 void setMailCCList ( char * list ,
                            int type ) ;

Set the list of addresses to be used when using VIM or MAPI Mail Export.

Parameters:
list A list of e-mail addresses to be used in the CC: header field.
type Specifies the type of mail being used. Either crEDTMailMAPI, crEDTMailVIM.

getMailCCList

 const char * getMailCCList ( ) ;

Get the list of addresses to be used when using VIM or MAPI Mail Export.

Return:
A list of e-mail addresses to be used in the CC: header field.

setMailMessage

 void setMailMessage ( char * msg ) ;

Set the text of the message to be sent when using VIM or MAPI Mail Export.

Parameters:
msg The mesage to be sent.

setMailMessage

 void setMailMessage ( char * msg ,
                             int type ) ;

Set the text of the message to be sent when using VIM or MAPI Mail Export.

Parameters:
msg The mesage to be sent.
type Specifies the type of mail being used. Either crEDTMailMAPI, crEDTMailVIM.

getMailMessage

 const char * getMailMessage ( ) ;

Get the message to be sent when using VIM or MAPI Mail Export.

Return:
The mesage to be sent.

setMailSubject

 void setMailSubject ( char * subject ) ;

Set the subject of the message to be sent when using VIM or MAPI Mail Export.

Parameters:
subject The subject to be sent.

setMailSubject

 void setMailSubject ( char * subject ,
                             int type ) ;

Set the subject of the message to be sent when using VIM or MAPI Mail Export.

Parameters:
subject The subject to be sent.
type Specifies the type of mail being used. Either crEDTMailMAPI, crEDTMailVIM.

getMailSubject

 const char * getMailSubject ( ) ;

Get the subject of the message to be sent when using VIM or MAPI Mail Export.

Parameters:
subject The subject to be sent.

setMailToList

 void setMailToList ( char * list ) ;

Set the recipients of the message to be sent when using VIM or MAPI Mail Export

Parameters:
list The list of recipients to send the message to.

setMailToList

 void setMailToList ( char * list ,
                            int type ) ;

Set the recipients of the message to be sent when using VIM or MAPI Mail Export

Parameters:
list The list of recipients to send the message to.
type Specifies the type of mail being used. Either crEDTMailMAPI, crEDTMailVIM.

getMailToList

 const char * getMailToList ( ) ;

Get the recipients of the message to be sent when using VIM or MAPI Mail Export

Return:
The list of recipients to send the message to.

setLinesPerPage

 void setLinesPerPage ( WORD lines ) ;

Set the number of lines to use per page when exporting to text.

Parameters:
lines The number of lines to use per page.

getLinesPerPage

 const WORD getLinesPerPage ( ) ;

Get the number of lines to use per page when exporting to text.

Return:
The number of lines to use per page.

setODBCSourceName

 void setODBCSourceName ( char * name ) ;

Set the source for the ODBC source name.

Parameters:
name The name of the source for ODBC.

getODBCSourceName

 const char * getODBCSourceName ( ) ;

Get the source for the ODBC source name.

Return:
The name of the source for ODBC.

setODBCSourcePassword

 void setODBCSourcePassword ( char * password ) ;

Set password for the ODBC source.

Parameters:
password The password to use for the ODBC source.

getODBCSourcePassword

 const char * getODBCSourcePassword ( ) ;

Get password for the ODBC source.

Return:
The password in use for the ODBC source.

setODBCSourceUserID

 void setODBCSourceUserID ( char * user ) ;

Set user ID for the ODBC source.

Parameters:
user The user ID for the ODBC source.

getODBCSourceUserID

 const char * getODBCSourceUserID ( ) ;

Get user ID for the ODBC source.

Return:
The user ID for the ODBC source.

setODBCExportTableName

 void setODBCExportTableName ( char * name ) ;

Set the export table name for the ODBC source.

Parameters:
name The name of the export table to use.

getODBCExportTableName

 const char * getODBCExportTableName ( ) ;

Get the export table name for the ODBC source.

Return:
The name of the export table in use for ODBC.

setUseReportDateFormat

 void setUseReportDateFormat ( BOOL value ) ;

Specify whether the to use the report date format for DIF output.

Parameters:
value True to use the report date format for DIF output.

getUseReportDateFormat

 BOOL getUseReportDateFormat ( ) ;

See whether the job should use the report date format for DIF output.

Return:
True if using the report date format; false otherwise.

setUseReportNumberFormat

 void setUseReportNumberFormat ( BOOL value ) ;

Specify whether the to use the report number format for DIF output.

Parameters:
value True to use the report number format for DIF output.

getUseReportNumberFormat

 BOOL getUseReportNumberFormat ( ) ;

See whether the job should use the report number format for DIF output.

Return:
True if using the report number format; false otherwise.

setPDFFileName

 void setPDFFileName ( char * name ) ;

Set the output filename for the PDF export.

Parameters:
name The output file in which to generate PDF.

getPDFFileName

 const char * getPDFFileName ( ) ;

Get the output filename for the PDF export.

Return:
The output file in which to generate the PDF.

setPSFileName

 void setPSFileName ( char * name ) ;

Set the postscript output filename for the PDF export.

Parameters:
name The output file in which to generate PDF.

getPSFileName

 const char * getPSFileName ( ) ;

Get the output postscript filename for the PDF export.

Return:
The output file in which to generate postscript.

Copyright (c) 2000 Dynalivery Corp.