aspose.cells

Class EbookLoadOptions

Represents options when importing an ebook file.

Constructor Summary
EbookLoadOptions()
Creates an options of loading the ebook file.
EbookLoadOptions(loadFormat)
Creates an options of loading the ebook file.
 
Property Getters/Setters Summary
functiongetAttachedFilesDirectory()
function
           The directory that the attached files will be saved to.
functiongetAutoFilter()
function
           Indicates whether auto filtering the data when loading the files.
functiongetAutoFitColsAndRows()
function
           Indicates whether auto-fit columns and rows. The default value is false.
functiongetAutoFitterOptions()
function
           Gets and sets the auto fitter options
functiongetCheckDataValid()
function
           Check whether data is valid in the template file.
functiongetCheckExcelRestriction()
function
           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 such as by Cell.PutValue(string), if this property is true, you will get an Exception. If this property is false, we will accept your input string value as the cell's value so that later you can output the complete string value for other file formats such as CSV. However, if you have set such kind of value that is invalid for excel file format, you should not save the workbook as excel file format later. Otherwise there may be unexpected error for the generated excel file.
functiongetConvertDateTimeData()
function
           Gets or sets a value that indicates whether the string in text file is converted to date data.
functiongetConvertFormulasData()
function
           if true, convert string to formula when string value starts with character '=',the default value is false.
functiongetConvertNumericData()
function
           Gets or sets a value that indicates whether the string in text file is converted to numeric data.
functiongetDefaultStyleSettings()
Gets the default style settings for initializing styles of the workbook
functiongetDeleteRedundantSpaces()
function
           Indicates whether delete redundant spaces when the text wraps lines using <br> tag. The default value is false.
functiongetEncoding()
function
           Gets and sets the default encoding. Only applies for csv file.
functiongetFontConfigs()
function
           Gets and sets individual font configs. Only works for the Workbook which uses this LoadOptions to load.
functionhasFormula()
function
           Indicates whether the text is formula if it starts with "=".
functiongetIgnoreNotPrinted()
function
           Ignore the data which are not printed if directly printing the file
functiongetIgnoreUselessShapes()
function
           Indicates whether ignoring useless shapes.
functiongetInterruptMonitor()
function
           Gets and sets the interrupt monitor.
functiongetKeepPrecision()
function
           Indicates whether not parsing a string value if the length is 15.
functiongetKeepUnparsedData()
function
           Whether keep the unparsed data in memory for the Workbook when it is loaded from template file. Default is true.
functiongetLanguageCode()
function
           Gets or sets the user interface language of the Workbook version based on CountryCode that has saved the file. The value of the property is CountryCode integer constant.
functiongetLightCellsDataHandler()
function
           The data handler for processing cells data when reading template file.
functiongetLoadFilter()
function
           The filter to denote how to load data.
functiongetLoadFormat()
Gets the load format. The value of the property is LoadFormat integer constant.
functiongetLoadFormulas()
function
           Indicates whether importing formulas if the original html file contains formulas
functiongetLoadStyleStrategy()
function
           Indicates the strategy to apply style for parsed values when converting string value to number or datetime. The value of the property is TxtLoadStyleStrategy integer constant.
functiongetLocale()
function
setLocale(value)
           Gets and sets the Locale used for workbook at the time the file was loaded.
functiongetMemorySetting()
function
           Gets or sets the memory usage options. The value of the property is MemorySetting integer constant.
functiongetParsingFormulaOnOpen()
function
           Indicates whether parsing the formula when reading the file.
functiongetParsingPivotCachedRecords()
function
           Indicates whether parsing pivot cached records when loading the file. The default value is false.
functiongetPassword()
function
           Gets and set the password of the workbook.
functiongetPreservePaddingSpacesInFormula()
function
           Indicates whether preserve those spaces and line breaks that are padded between formula tokens while getting and setting formulas. Default value is false.
functiongetProgId()
Gets the program id of creating the file. Only for MHT files.
functiongetRegion()
function
setRegion(value)
           Gets or sets the system regional settings based on CountryCode at the time the file was loaded. The value of the property is CountryCode integer constant.
functiongetStandardFont()
function
           Sets the default standard font name
functiongetStandardFontSize()
function
           Sets the default standard font size.
functiongetStreamProvider()
function
           Gets or sets the StreamProviderImportHtmlFile for importing objects.
functiongetSupportDivTag()
function
           Indicates whether support the layout of <div> tag when the html file contains it. The default value is false.
functiongetTableLoadOptions()
Get the HtmlTableLoadOptionCollection instance
functiongetWarningCallback()
function
           Gets or sets warning callback.
 
Method Summary
functionsetPaperSize(type)
Sets the default print paper size from default printer's setting.
 

    • Constructor Detail

      • EbookLoadOptions

        function EbookLoadOptions()
        Creates an options of loading the ebook file.
      • EbookLoadOptions

        function EbookLoadOptions(loadFormat)
        Creates an options of loading the ebook file.
        Parameters:
        loadFormat: Number - A LoadFormat value. The loading format
    • Property Getters/Setters Detail

      • getAttachedFilesDirectory/setAttachedFilesDirectory : String 

        function getAttachedFilesDirectory() / function setAttachedFilesDirectory(value)
        
        The directory that the attached files will be saved to. NOTE: This member is now obsolete. Instead, please use HtmlLoadOptions.StreamProvider property. This property will be removed 12 months later since December 2014. Aspose apologizes for any inconvenience you may have experienced.
      • getLoadFormulas/setLoadFormulas : boolean 

        function getLoadFormulas() / function setLoadFormulas(value)
        
        Indicates whether importing formulas if the original html file contains formulas
      • getSupportDivTag/setSupportDivTag : boolean 

        function getSupportDivTag() / function setSupportDivTag(value)
        
        Indicates whether support the layout of <div> tag when the html file contains it. The default value is false.
      • getDeleteRedundantSpaces/setDeleteRedundantSpaces : boolean 

        function getDeleteRedundantSpaces() / function setDeleteRedundantSpaces(value)
        
        Indicates whether delete redundant spaces when the text wraps lines using <br> tag. The default value is false.
      • getAutoFitColsAndRows/setAutoFitColsAndRows : boolean 

        function getAutoFitColsAndRows() / function setAutoFitColsAndRows(value)
        
        Indicates whether auto-fit columns and rows. The default value is false.
      • getConvertFormulasData/setConvertFormulasData : boolean 

        function getConvertFormulasData() / function setConvertFormulasData(value)
        
        if true, convert string to formula when string value starts with character '=',the default value is false. NOTE: This property is now obsolete. Instead, please use HtmlLoadOptions.HasFormula property. This property will be removed 12 months later since March 2023. Aspose apologizes for any inconvenience you may have experienced.
      • hasFormula/setHasFormula : boolean 

        function hasFormula() / function setHasFormula(value)
        
        Indicates whether the text is formula if it starts with "=".
      • getStreamProvider/setStreamProvider : IStreamProvider 

        function getStreamProvider() / function setStreamProvider(value)
        
        Gets or sets the StreamProviderImportHtmlFile for importing objects.
      • getProgId : String 

        function getProgId()
        
        Gets the program id of creating the file. Only for MHT files.
      • getEncoding/setEncoding : Encoding 

        function getEncoding() / function setEncoding(value)
        
        Gets and sets the default encoding. Only applies for csv file.
      • getLoadStyleStrategy/setLoadStyleStrategy : Number 

        function getLoadStyleStrategy() / function setLoadStyleStrategy(value)
        
        Indicates the strategy to apply style for parsed values when converting string value to number or datetime. The value of the property is TxtLoadStyleStrategy integer constant.
      • getConvertNumericData/setConvertNumericData : boolean 

        function getConvertNumericData() / function setConvertNumericData(value)
        
        Gets or sets a value that indicates whether the string in text file is converted to numeric data.
      • getConvertDateTimeData/setConvertDateTimeData : boolean 

        function getConvertDateTimeData() / function setConvertDateTimeData(value)
        
        Gets or sets a value that indicates whether the string in text file is converted to date data.
      • getKeepPrecision/setKeepPrecision : boolean 

        function getKeepPrecision() / function setKeepPrecision(value)
        
        Indicates whether not parsing a string value if the length is 15.
      • getLoadFormat : Number 

        function getLoadFormat()
        
        Gets the load format. The value of the property is LoadFormat integer constant.
      • getPassword/setPassword : String 

        function getPassword() / function setPassword(value)
        
        Gets and set the password of the workbook.
      • getParsingFormulaOnOpen/setParsingFormulaOnOpen : boolean 

        function getParsingFormulaOnOpen() / function setParsingFormulaOnOpen(value)
        
        Indicates whether parsing the formula when reading the file. Only applies for Excel Xlsx, Xltx, Xltm and Xlsm file because the formulas in the files are stored with a string formula.
      • getParsingPivotCachedRecords/setParsingPivotCachedRecords : boolean 

        function getParsingPivotCachedRecords() / function setParsingPivotCachedRecords(value)
        
        Indicates whether parsing pivot cached records when loading the file. The default value is false. Only applies for Excel Xlsx, Xltx, Xltm , Xlsm and xlsb file
      • getLanguageCode/setLanguageCode : Number 

        function getLanguageCode() / function setLanguageCode(value)
        
        Gets or sets the user interface language of the Workbook version based on CountryCode that has saved the file. The value of the property is CountryCode integer constant.
      • getRegion/setRegion : Number 

        function getRegion() / function setRegion(value)
        
        Gets or sets the system regional settings based on CountryCode at the time the file was loaded. The value of the property is CountryCode integer constant.If you do not want to use the region saved in the file, please reset it after reading the file.
      • getLocale/setLocale : Locale 

        function getLocale() / function setLocale(value)
        
        Gets and sets the Locale used for workbook at the time the file was loaded.
      • getDefaultStyleSettings : DefaultStyleSettings 

        function getDefaultStyleSettings()
        
        Gets the default style settings for initializing styles of the workbook
      • getStandardFont/setStandardFont : String 

        function getStandardFont() / function setStandardFont(value)
        
        Sets the default standard font name NOTE: This member is now obsolete. Instead, please use DefaultStyleSettings. This property will be removed 12 months later since March 2022. Aspose apologizes for any inconvenience you may have experienced.
      • getStandardFontSize/setStandardFontSize : Number 

        function getStandardFontSize() / function setStandardFontSize(value)
        
        Sets the default standard font size. NOTE: This member is now obsolete. Instead, please use DefaultStyleSettings. This property will be removed 12 months later since March 2022. Aspose apologizes for any inconvenience you may have experienced.
      • getInterruptMonitor/setInterruptMonitor : AbstractInterruptMonitor 

        function getInterruptMonitor() / function setInterruptMonitor(value)
        
        Gets and sets the interrupt monitor.
      • getIgnoreNotPrinted/setIgnoreNotPrinted : boolean 

        function getIgnoreNotPrinted() / function setIgnoreNotPrinted(value)
        
        Ignore the data which are not printed if directly printing the file Only for xlsx file.
      • getCheckDataValid/setCheckDataValid : boolean 

        function getCheckDataValid() / function setCheckDataValid(value)
        
        Check whether data is valid in the template file.
      • getCheckExcelRestriction/setCheckExcelRestriction : boolean 

        function getCheckExcelRestriction() / function setCheckExcelRestriction(value)
        
        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 such as by Cell.PutValue(string), if this property is true, you will get an Exception. If this property is false, we will accept your input string value as the cell's value so that later you can output the complete string value for other file formats such as CSV. However, if you have set such kind of value that is invalid for excel file format, you should not save the workbook as excel file format later. Otherwise there may be unexpected error for the generated excel file.
      • getKeepUnparsedData/setKeepUnparsedData : boolean 

        function getKeepUnparsedData() / function setKeepUnparsedData(value)
        
        Whether keep the unparsed data in memory for the Workbook when it is loaded from template file. Default is true. For scenarios that user only needs to read some contents from template file and does not need to save the workbook back, set this property as false may improve performance, especially when using it together with some kind of LoadFilter,
      • getLoadFilter/setLoadFilter : LoadFilter 

        function getLoadFilter() / function setLoadFilter(value)
        
        The filter to denote how to load data.
      • getLightCellsDataHandler/setLightCellsDataHandler : LightCellsDataHandler 

        function getLightCellsDataHandler() / function setLightCellsDataHandler(value)
        
        The data handler for processing cells data when reading template file.
      • getMemorySetting/setMemorySetting : Number 

        function getMemorySetting() / function setMemorySetting(value)
        
        Gets or sets the memory usage options. The value of the property is MemorySetting integer constant.
      • getWarningCallback/setWarningCallback : IWarningCallback 

        function getWarningCallback() / function setWarningCallback(value)
        
        Gets or sets warning callback.
      • getAutoFitterOptions/setAutoFitterOptions : AutoFitterOptions 

        function getAutoFitterOptions() / function setAutoFitterOptions(value)
        
        Gets and sets the auto fitter options Only for xlsx ,spreadsheetML file now.
      • getAutoFilter/setAutoFilter : boolean 

        function getAutoFilter() / function setAutoFilter(value)
        
        Indicates whether auto filtering the data when loading the files. Sometimes although autofilter is set, the corresponding rows is not hidden in the file. Now only works for SpreadSheetML file.
      • getFontConfigs/setFontConfigs : IndividualFontConfigs 

        function getFontConfigs() / function setFontConfigs(value)
        
        Gets and sets individual font configs. Only works for the Workbook which uses this LoadOptions to load.
      • getIgnoreUselessShapes/setIgnoreUselessShapes : boolean 

        function getIgnoreUselessShapes() / function setIgnoreUselessShapes(value)
        
        Indicates whether ignoring useless shapes. Only works for xlsx,xlsb, and xlsm files. There are many overlapping identical shapes which are useless in some files, we can ingore them when loading files.
      • getPreservePaddingSpacesInFormula/setPreservePaddingSpacesInFormula : boolean 

        function getPreservePaddingSpacesInFormula() / function setPreservePaddingSpacesInFormula(value)
        
        Indicates whether preserve those spaces and line breaks that are padded between formula tokens while getting and setting formulas. Default value is false. After loading workbook from template file with this option, FormulaSettings.PreservePaddingSpaces will be set to the same value with this property.
    • Method Detail

      • setPaperSize

        function setPaperSize(type)
        Sets the default print paper size from default printer's setting. If there is no setting about paper size,MS Excel will use default printer's setting.
        Parameters:
        type: Number - A PaperSizeType value. The default paper size.