TxtSaveOptions

TxtSaveOptions class

Represents the save options for csv/tab delimited/other text format.

class TxtSaveOptions extends SaveOptions;

Constructors

Constructor	Description
constructor()	Creates text file save options.
constructor(SaveOptions)	Constructs from a parent object convertible to this.
constructor(SaveFormat)	Creates text file save options.

Properties

Property	Type	Description
separator	string	Gets and sets char Delimiter of text file.
separatorString	string	Gets and sets a string value as separator.
encoding	EncodingType	Gets and sets the default encoding.
quoteType	TxtValueQuoteType	Gets or sets how to quote values in the exported text file.
formatStrategy	CellValueFormatStrategy	Gets and sets the format strategy when exporting the cell value as string.
lightCellsDataProvider	LightCellsDataProvider	The data provider for saving workbook in light mode.
trimLeadingBlankRowAndColumn	boolean	Indicates whether leading blank rows and columns should be trimmed like what ms excel does. Default is true.
trimTailingBlankCells	boolean	Indicates whether tailing blank cells in one row should be trimmed. Default is false.
keepSeparatorsForBlankRow	boolean	Indicates whether separators should be output for blank row. Default value is false so by default the content for blank row will be empty.
exportArea	CellArea	The range of cells to be exported.
exportQuotePrefix	boolean	Indicates whether the single quote sign should be exported as part of the value of one cell when Style.QuotePrefix is true for it. Default is false.
exportAllSheets	boolean	Indicates whether exporting all sheets to the text file. If it is false, only export the activesheet, just like MS Excel.
saveFormat	SaveFormat	Readonly. Gets the save file format.
clearData	boolean	Make the workbook empty after saving the file.
cachedFileFolder	string	The folder for temporary files that may be used as data cache.
validateMergedAreas	boolean	Indicates whether validate merged cells before saving the file.
mergeAreas	boolean	Indicates whether merge the areas of conditional formatting and validation before saving the file.
createDirectory	boolean	If true and the directory does not exist, the directory will be automatically created before saving the file.
sortNames	boolean	Indicates whether sorting defined names before saving file.
sortExternalNames	boolean	Indicates whether sorting external defined names before saving file.
refreshChartCache	boolean	Indicates whether refreshing chart cache data
warningCallback	IWarningCallback	Gets or sets warning callback.
checkExcelRestriction	boolean	Whether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputting string value longer than 32K. When you input a value longer than 32K, it will be truncated.
updateSmartArt	boolean	Indicates whether updating smart art setting. The default value is false.
encryptDocumentProperties	boolean	Indicates whether encrypt document properties when saving as .xls file. The default value is true.

Methods

Method	Description
getSeparator()	@deprecated. Please use the ‘separator’ property instead. Gets and sets char Delimiter of text file.
setSeparator(string)	@deprecated. Please use the ‘separator’ property instead. Gets and sets char Delimiter of text file.
getSeparatorString()	@deprecated. Please use the ‘separatorString’ property instead. Gets and sets a string value as separator.
setSeparatorString(string)	@deprecated. Please use the ‘separatorString’ property instead. Gets and sets a string value as separator.
getEncoding()	@deprecated. Please use the ’encoding’ property instead. Gets and sets the default encoding.
setEncoding(EncodingType)	@deprecated. Please use the ’encoding’ property instead. Gets and sets the default encoding.
getQuoteType()	@deprecated. Please use the ‘quoteType’ property instead. Gets or sets how to quote values in the exported text file.
setQuoteType(TxtValueQuoteType)	@deprecated. Please use the ‘quoteType’ property instead. Gets or sets how to quote values in the exported text file.
getFormatStrategy()	@deprecated. Please use the ‘formatStrategy’ property instead. Gets and sets the format strategy when exporting the cell value as string.
setFormatStrategy(CellValueFormatStrategy)	@deprecated. Please use the ‘formatStrategy’ property instead. Gets and sets the format strategy when exporting the cell value as string.
getLightCellsDataProvider()	@deprecated. Please use the ’lightCellsDataProvider’ property instead. The data provider for saving workbook in light mode.
setLightCellsDataProvider(LightCellsDataProvider)	@deprecated. Please use the ’lightCellsDataProvider’ property instead. The data provider for saving workbook in light mode.
getTrimLeadingBlankRowAndColumn()	@deprecated. Please use the ’trimLeadingBlankRowAndColumn’ property instead. Indicates whether leading blank rows and columns should be trimmed like what ms excel does. Default is true.
setTrimLeadingBlankRowAndColumn(boolean)	@deprecated. Please use the ’trimLeadingBlankRowAndColumn’ property instead. Indicates whether leading blank rows and columns should be trimmed like what ms excel does. Default is true.
getTrimTailingBlankCells()	@deprecated. Please use the ’trimTailingBlankCells’ property instead. Indicates whether tailing blank cells in one row should be trimmed. Default is false.
setTrimTailingBlankCells(boolean)	@deprecated. Please use the ’trimTailingBlankCells’ property instead. Indicates whether tailing blank cells in one row should be trimmed. Default is false.
getKeepSeparatorsForBlankRow()	@deprecated. Please use the ‘keepSeparatorsForBlankRow’ property instead. Indicates whether separators should be output for blank row. Default value is false so by default the content for blank row will be empty.
setKeepSeparatorsForBlankRow(boolean)	@deprecated. Please use the ‘keepSeparatorsForBlankRow’ property instead. Indicates whether separators should be output for blank row. Default value is false so by default the content for blank row will be empty.
getExportArea()	@deprecated. Please use the ’exportArea’ property instead. The range of cells to be exported.
setExportArea(CellArea)	@deprecated. Please use the ’exportArea’ property instead. The range of cells to be exported.
getExportQuotePrefix()	@deprecated. Please use the ’exportQuotePrefix’ property instead. Indicates whether the single quote sign should be exported as part of the value of one cell when Style.QuotePrefix is true for it. Default is false.
setExportQuotePrefix(boolean)	@deprecated. Please use the ’exportQuotePrefix’ property instead. Indicates whether the single quote sign should be exported as part of the value of one cell when Style.QuotePrefix is true for it. Default is false.
getExportAllSheets()	@deprecated. Please use the ’exportAllSheets’ property instead. Indicates whether exporting all sheets to the text file. If it is false, only export the activesheet, just like MS Excel.
setExportAllSheets(boolean)	@deprecated. Please use the ’exportAllSheets’ property instead. Indicates whether exporting all sheets to the text file. If it is false, only export the activesheet, just like MS Excel.
isNull()	Checks whether the implementation object is null.
getSaveFormat()	@deprecated. Please use the ‘saveFormat’ property instead. Gets the save file format.
getClearData()	@deprecated. Please use the ‘clearData’ property instead. Make the workbook empty after saving the file.
setClearData(boolean)	@deprecated. Please use the ‘clearData’ property instead. Make the workbook empty after saving the file.
getCachedFileFolder()	@deprecated. Please use the ‘cachedFileFolder’ property instead. The folder for temporary files that may be used as data cache.
setCachedFileFolder(string)	@deprecated. Please use the ‘cachedFileFolder’ property instead. The folder for temporary files that may be used as data cache.
getValidateMergedAreas()	@deprecated. Please use the ‘validateMergedAreas’ property instead. Indicates whether validate merged cells before saving the file.
setValidateMergedAreas(boolean)	@deprecated. Please use the ‘validateMergedAreas’ property instead. Indicates whether validate merged cells before saving the file.
getMergeAreas()	@deprecated. Please use the ‘mergeAreas’ property instead. Indicates whether merge the areas of conditional formatting and validation before saving the file.
setMergeAreas(boolean)	@deprecated. Please use the ‘mergeAreas’ property instead. Indicates whether merge the areas of conditional formatting and validation before saving the file.
getCreateDirectory()	@deprecated. Please use the ‘createDirectory’ property instead. If true and the directory does not exist, the directory will be automatically created before saving the file.
setCreateDirectory(boolean)	@deprecated. Please use the ‘createDirectory’ property instead. If true and the directory does not exist, the directory will be automatically created before saving the file.
getSortNames()	@deprecated. Please use the ‘sortNames’ property instead. Indicates whether sorting defined names before saving file.
setSortNames(boolean)	@deprecated. Please use the ‘sortNames’ property instead. Indicates whether sorting defined names before saving file.
getSortExternalNames()	@deprecated. Please use the ‘sortExternalNames’ property instead. Indicates whether sorting external defined names before saving file.
setSortExternalNames(boolean)	@deprecated. Please use the ‘sortExternalNames’ property instead. Indicates whether sorting external defined names before saving file.
getRefreshChartCache()	@deprecated. Please use the ‘refreshChartCache’ property instead. Indicates whether refreshing chart cache data
setRefreshChartCache(boolean)	@deprecated. Please use the ‘refreshChartCache’ property instead. Indicates whether refreshing chart cache data
setWarningCallback(IWarningCallback)	@deprecated. Please use the ‘warningCallback’ property instead. Gets or sets warning callback.
getWarningCallback()	@deprecated. Please use the ‘warningCallback’ property instead. Gets or sets warning callback.
getCheckExcelRestriction()	@deprecated. Please use the ‘checkExcelRestriction’ property instead. Whether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputting string value longer than 32K. When you input a value longer than 32K, it will be truncated.
setCheckExcelRestriction(boolean)	@deprecated. Please use the ‘checkExcelRestriction’ property instead. Whether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputting string value longer than 32K. When you input a value longer than 32K, it will be truncated.
getUpdateSmartArt()	@deprecated. Please use the ‘updateSmartArt’ property instead. Indicates whether updating smart art setting. The default value is false.
setUpdateSmartArt(boolean)	@deprecated. Please use the ‘updateSmartArt’ property instead. Indicates whether updating smart art setting. The default value is false.
getEncryptDocumentProperties()	@deprecated. Please use the ’encryptDocumentProperties’ property instead. Indicates whether encrypt document properties when saving as .xls file. The default value is true.
setEncryptDocumentProperties(boolean)	@deprecated. Please use the ’encryptDocumentProperties’ property instead. Indicates whether encrypt document properties when saving as .xls file. The default value is true.

constructor()

Creates text file save options.

constructor();

constructor(SaveOptions)

Constructs from a parent object convertible to this.

constructor(obj: SaveOptions);

Parameters:

Parameter	Type	Description
obj	SaveOptions	The parent object.

constructor(SaveFormat)

Creates text file save options.

constructor(saveFormat: SaveFormat);

Parameters:

Parameter	Type	Description
saveFormat	SaveFormat	The file format. /// It should be SaveFormat.Csv or SaveFormat.Tsv, /// otherwise the saved format will be set as SaveFormat.Csv automatically.

separator

Gets and sets char Delimiter of text file.

separator : string;

separatorString

Gets and sets a string value as separator.

separatorString : string;

encoding

Gets and sets the default encoding.

encoding : EncodingType;

quoteType

Gets or sets how to quote values in the exported text file.

quoteType : TxtValueQuoteType;

formatStrategy

Gets and sets the format strategy when exporting the cell value as string.

formatStrategy : CellValueFormatStrategy;

lightCellsDataProvider

The data provider for saving workbook in light mode.

lightCellsDataProvider : LightCellsDataProvider;

trimLeadingBlankRowAndColumn

Indicates whether leading blank rows and columns should be trimmed like what ms excel does. Default is true.

trimLeadingBlankRowAndColumn : boolean;

Remarks

Same with the rule in ms excel, a row/column will not be taken as blank if it has custom style, even if it contains no cell data. When saving with LightCells mode, this option takes no effect. User should control the output range by the implementation of LightCellsDataProvider or by speicifing ExportArea

trimTailingBlankCells

Indicates whether tailing blank cells in one row should be trimmed. Default is false.

trimTailingBlankCells : boolean;

Remarks

When saving with LightCells mode and the ExportArea has not been specified, this option takes no effect and one row will be extended to just the last cell provided by the implementation LightCellsDataProvider

keepSeparatorsForBlankRow

Indicates whether separators should be output for blank row. Default value is false so by default the content for blank row will be empty.

keepSeparatorsForBlankRow : boolean;

exportArea

The range of cells to be exported.

exportArea : CellArea;

Remarks

If the exported area has been specified, TrimLeadingBlankRowAndColumn will takes no effect.

exportQuotePrefix

Indicates whether the single quote sign should be exported as part of the value of one cell when Style.QuotePrefix is true for it. Default is false.

exportQuotePrefix : boolean;

exportAllSheets

Indicates whether exporting all sheets to the text file. If it is false, only export the activesheet, just like MS Excel.

exportAllSheets : boolean;

Remarks

The defult value is false.

saveFormat

Readonly. Gets the save file format.

saveFormat : SaveFormat;

clearData

Make the workbook empty after saving the file.

clearData : boolean;

cachedFileFolder

The folder for temporary files that may be used as data cache.

cachedFileFolder : string;

Remarks

If the folder has not been specified, the default value for it is CellsHelper.GetCacheFolder(). If its default value is null or empty, or has been specified as null or empty, then no cache file will be used when saving the workbook.

validateMergedAreas

Indicates whether validate merged cells before saving the file.

validateMergedAreas : boolean;

Remarks

The default value is false.

mergeAreas

Indicates whether merge the areas of conditional formatting and validation before saving the file.

mergeAreas : boolean;

Remarks

The default value is false.

createDirectory

If true and the directory does not exist, the directory will be automatically created before saving the file.

createDirectory : boolean;

Remarks

The default value is false.

sortNames

Indicates whether sorting defined names before saving file.

sortNames : boolean;

sortExternalNames

Indicates whether sorting external defined names before saving file.

sortExternalNames : boolean;

refreshChartCache

Indicates whether refreshing chart cache data

refreshChartCache : boolean;

warningCallback

Gets or sets warning callback.

warningCallback : IWarningCallback;

checkExcelRestriction

Whether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputting string value longer than 32K. When you input a value longer than 32K, it will be truncated.

checkExcelRestriction : boolean;

updateSmartArt

Indicates whether updating smart art setting. The default value is false.

updateSmartArt : boolean;

Remarks

Only effects after calling Shape.GetResultOfSmartArt() method and the cached shapes exist in the template file.

encryptDocumentProperties

Indicates whether encrypt document properties when saving as .xls file. The default value is true.

encryptDocumentProperties : boolean;

Remarks

Only for .xls,xlsx,xlsb and xlsm file.

getSeparator()

@deprecated. Please use the ‘separator’ property instead. Gets and sets char Delimiter of text file.

getSeparator() : string;

setSeparator(string)

@deprecated. Please use the ‘separator’ property instead. Gets and sets char Delimiter of text file.

setSeparator(value: string) : void;

Parameters:

Parameter	Type	Description
value	string	The value to set.

getSeparatorString()

@deprecated. Please use the ‘separatorString’ property instead. Gets and sets a string value as separator.

getSeparatorString() : string;

setSeparatorString(string)

@deprecated. Please use the ‘separatorString’ property instead. Gets and sets a string value as separator.

setSeparatorString(value: string) : void;

Parameters:

Parameter	Type	Description
value	string	The value to set.

getEncoding()

@deprecated. Please use the ’encoding’ property instead. Gets and sets the default encoding.

getEncoding() : EncodingType;

Returns

EncodingType

setEncoding(EncodingType)

@deprecated. Please use the ’encoding’ property instead. Gets and sets the default encoding.

setEncoding(value: EncodingType) : void;

Parameters:

Parameter	Type	Description
value	EncodingType	The value to set.

getQuoteType()

@deprecated. Please use the ‘quoteType’ property instead. Gets or sets how to quote values in the exported text file.

getQuoteType() : TxtValueQuoteType;

Returns

TxtValueQuoteType

setQuoteType(TxtValueQuoteType)

@deprecated. Please use the ‘quoteType’ property instead. Gets or sets how to quote values in the exported text file.

setQuoteType(value: TxtValueQuoteType) : void;

Parameters:

Parameter	Type	Description
value	TxtValueQuoteType	The value to set.

getFormatStrategy()

@deprecated. Please use the ‘formatStrategy’ property instead. Gets and sets the format strategy when exporting the cell value as string.

getFormatStrategy() : CellValueFormatStrategy;

Returns

CellValueFormatStrategy

setFormatStrategy(CellValueFormatStrategy)

@deprecated. Please use the ‘formatStrategy’ property instead. Gets and sets the format strategy when exporting the cell value as string.

setFormatStrategy(value: CellValueFormatStrategy) : void;

Parameters:

Parameter	Type	Description
value	CellValueFormatStrategy	The value to set.

getLightCellsDataProvider()

@deprecated. Please use the ’lightCellsDataProvider’ property instead. The data provider for saving workbook in light mode.

getLightCellsDataProvider() : LightCellsDataProvider;

Returns

LightCellsDataProvider

setLightCellsDataProvider(LightCellsDataProvider)

@deprecated. Please use the ’lightCellsDataProvider’ property instead. The data provider for saving workbook in light mode.

setLightCellsDataProvider(value: LightCellsDataProvider) : void;

Parameters:

Parameter	Type	Description
value	LightCellsDataProvider	The value to set.

getTrimLeadingBlankRowAndColumn()

@deprecated. Please use the ’trimLeadingBlankRowAndColumn’ property instead. Indicates whether leading blank rows and columns should be trimmed like what ms excel does. Default is true.

getTrimLeadingBlankRowAndColumn() : boolean;

Remarks

setTrimLeadingBlankRowAndColumn(boolean)

@deprecated. Please use the ’trimLeadingBlankRowAndColumn’ property instead. Indicates whether leading blank rows and columns should be trimmed like what ms excel does. Default is true.

setTrimLeadingBlankRowAndColumn(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

getTrimTailingBlankCells()

@deprecated. Please use the ’trimTailingBlankCells’ property instead. Indicates whether tailing blank cells in one row should be trimmed. Default is false.

getTrimTailingBlankCells() : boolean;

Remarks

setTrimTailingBlankCells(boolean)

@deprecated. Please use the ’trimTailingBlankCells’ property instead. Indicates whether tailing blank cells in one row should be trimmed. Default is false.

setTrimTailingBlankCells(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

getKeepSeparatorsForBlankRow()

@deprecated. Please use the ‘keepSeparatorsForBlankRow’ property instead. Indicates whether separators should be output for blank row. Default value is false so by default the content for blank row will be empty.

getKeepSeparatorsForBlankRow() : boolean;

setKeepSeparatorsForBlankRow(boolean)

setKeepSeparatorsForBlankRow(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

getExportArea()

@deprecated. Please use the ’exportArea’ property instead. The range of cells to be exported.

getExportArea() : CellArea;

Returns

CellArea

Remarks

If the exported area has been specified, TrimLeadingBlankRowAndColumn will takes no effect.

setExportArea(CellArea)

@deprecated. Please use the ’exportArea’ property instead. The range of cells to be exported.

setExportArea(value: CellArea) : void;

Parameters:

Parameter	Type	Description
value	CellArea	The value to set.

Remarks

If the exported area has been specified, TrimLeadingBlankRowAndColumn will takes no effect.

getExportQuotePrefix()

@deprecated. Please use the ’exportQuotePrefix’ property instead. Indicates whether the single quote sign should be exported as part of the value of one cell when Style.QuotePrefix is true for it. Default is false.

getExportQuotePrefix() : boolean;

setExportQuotePrefix(boolean)

setExportQuotePrefix(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

getExportAllSheets()

@deprecated. Please use the ’exportAllSheets’ property instead. Indicates whether exporting all sheets to the text file. If it is false, only export the activesheet, just like MS Excel.

getExportAllSheets() : boolean;

Remarks

The defult value is false.

setExportAllSheets(boolean)

@deprecated. Please use the ’exportAllSheets’ property instead. Indicates whether exporting all sheets to the text file. If it is false, only export the activesheet, just like MS Excel.

setExportAllSheets(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

The defult value is false.

isNull()

Checks whether the implementation object is null.

isNull() : boolean;

getSaveFormat()

@deprecated. Please use the ‘saveFormat’ property instead. Gets the save file format.

getSaveFormat() : SaveFormat;

Returns

SaveFormat

getClearData()

@deprecated. Please use the ‘clearData’ property instead. Make the workbook empty after saving the file.

getClearData() : boolean;

setClearData(boolean)

@deprecated. Please use the ‘clearData’ property instead. Make the workbook empty after saving the file.

setClearData(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

getCachedFileFolder()

@deprecated. Please use the ‘cachedFileFolder’ property instead. The folder for temporary files that may be used as data cache.

getCachedFileFolder() : string;

Remarks

setCachedFileFolder(string)

@deprecated. Please use the ‘cachedFileFolder’ property instead. The folder for temporary files that may be used as data cache.

setCachedFileFolder(value: string) : void;

Parameters:

Parameter	Type	Description
value	string	The value to set.

Remarks

getValidateMergedAreas()

@deprecated. Please use the ‘validateMergedAreas’ property instead. Indicates whether validate merged cells before saving the file.

getValidateMergedAreas() : boolean;

Remarks

The default value is false.

setValidateMergedAreas(boolean)

@deprecated. Please use the ‘validateMergedAreas’ property instead. Indicates whether validate merged cells before saving the file.

setValidateMergedAreas(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

The default value is false.

getMergeAreas()

@deprecated. Please use the ‘mergeAreas’ property instead. Indicates whether merge the areas of conditional formatting and validation before saving the file.

getMergeAreas() : boolean;

Remarks

The default value is false.

setMergeAreas(boolean)

@deprecated. Please use the ‘mergeAreas’ property instead. Indicates whether merge the areas of conditional formatting and validation before saving the file.

setMergeAreas(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

The default value is false.

getCreateDirectory()

@deprecated. Please use the ‘createDirectory’ property instead. If true and the directory does not exist, the directory will be automatically created before saving the file.

getCreateDirectory() : boolean;

Remarks

The default value is false.

setCreateDirectory(boolean)

@deprecated. Please use the ‘createDirectory’ property instead. If true and the directory does not exist, the directory will be automatically created before saving the file.

setCreateDirectory(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

The default value is false.

getSortNames()

@deprecated. Please use the ‘sortNames’ property instead. Indicates whether sorting defined names before saving file.

getSortNames() : boolean;

setSortNames(boolean)

@deprecated. Please use the ‘sortNames’ property instead. Indicates whether sorting defined names before saving file.

setSortNames(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

getSortExternalNames()

@deprecated. Please use the ‘sortExternalNames’ property instead. Indicates whether sorting external defined names before saving file.

getSortExternalNames() : boolean;

setSortExternalNames(boolean)

@deprecated. Please use the ‘sortExternalNames’ property instead. Indicates whether sorting external defined names before saving file.

setSortExternalNames(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

getRefreshChartCache()

@deprecated. Please use the ‘refreshChartCache’ property instead. Indicates whether refreshing chart cache data

getRefreshChartCache() : boolean;

setRefreshChartCache(boolean)

@deprecated. Please use the ‘refreshChartCache’ property instead. Indicates whether refreshing chart cache data

setRefreshChartCache(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

setWarningCallback(IWarningCallback)

@deprecated. Please use the ‘warningCallback’ property instead. Gets or sets warning callback.

setWarningCallback(value: IWarningCallback) : void;

Parameters:

Parameter	Type	Description
value	IWarningCallback	The value to set.

getWarningCallback()

@deprecated. Please use the ‘warningCallback’ property instead. Gets or sets warning callback.

getWarningCallback() : IWarningCallback;

Returns

IWarningCallback

getCheckExcelRestriction()

@deprecated. Please use the ‘checkExcelRestriction’ property instead. Whether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputting string value longer than 32K. When you input a value longer than 32K, it will be truncated.

getCheckExcelRestriction() : boolean;

setCheckExcelRestriction(boolean)

setCheckExcelRestriction(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

getUpdateSmartArt()

@deprecated. Please use the ‘updateSmartArt’ property instead. Indicates whether updating smart art setting. The default value is false.

getUpdateSmartArt() : boolean;

Remarks

Only effects after calling Shape.GetResultOfSmartArt() method and the cached shapes exist in the template file.

setUpdateSmartArt(boolean)

@deprecated. Please use the ‘updateSmartArt’ property instead. Indicates whether updating smart art setting. The default value is false.

setUpdateSmartArt(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

Only effects after calling Shape.GetResultOfSmartArt() method and the cached shapes exist in the template file.

getEncryptDocumentProperties()

@deprecated. Please use the ’encryptDocumentProperties’ property instead. Indicates whether encrypt document properties when saving as .xls file. The default value is true.

getEncryptDocumentProperties() : boolean;

Remarks

Only for .xls,xlsx,xlsb and xlsm file.

setEncryptDocumentProperties(boolean)

@deprecated. Please use the ’encryptDocumentProperties’ property instead. Indicates whether encrypt document properties when saving as .xls file. The default value is true.

setEncryptDocumentProperties(value: boolean) : void;

Parameters:

Parameter	Type	Description
value	boolean	The value to set.

Remarks

Only for .xls,xlsx,xlsb and xlsm file.