asposecells.api

Classes

Constants

Class XpsSaveOptions

Represents the additional options when saving the file as the Xps.

Constructor Summary
`XpsSaveOptions()` Creates options for saving xps file.
`XpsSaveOptions(saveFormat)` Creates options for saving xps file.

Property Getters/Setters Summary
`method`	`getAllColumnsInOnePagePerSheet()`
`method`	`setAllColumnsInOnePagePerSheet(value)`
	If AllColumnsInOnePagePerSheet is true , all column content of one sheet will output to only one page in result. The width of paper size of pagesetup will be ignored, and the other settings of pagesetup will still take effect.
`method`	`getCachedFileFolder()`
`method`	`setCachedFileFolder(value)`
	The cached file folder is used to store some large data.
`method`	`getCheckFontCompatibility()`
`method`	`setCheckFontCompatibility(value)`
	Indicates whether to check font compatibility for every character in text.
`method`	`getCheckWorkbookDefaultFont()`
`method`	`setCheckWorkbookDefaultFont(value)`
	When characters in the Excel are Unicode and not be set with correct font in cell style, They may appear as block in pdf,image. Set this to true to try to use workbook's default font to show these characters first.
`method`	`getClearData()`
`method`	`setClearData(value)`
	Make the workbook empty after saving the file.
`method`	`getCreateDirectory()`
`method`	`setCreateDirectory(value)`
	If true and the directory does not exist, the directory will be automatically created before saving the file.
`method`	`getDefaultEditLanguage()`
`method`	`setDefaultEditLanguage(value)`
	Gets or sets default edit language. The value of the property is DefaultEditLanguage integer constant.
`method`	`getDefaultFont()`
`method`	`setDefaultFont(value)`
	When characters in the Excel are Unicode and not be set with correct font in cell style, They may appear as block in pdf,image. Set the DefaultFont such as MingLiu or MS Gothic to show these characters. If this property is not set, Aspose.Cells will use system default font to show these unicode characters.
`method`	`getDrawObjectEventHandler()`
`method`	`setDrawObjectEventHandler(value)`
	Implements this interface to get DrawObject and Bound when rendering.
`method`	`getEmfRenderSetting()`
`method`	`setEmfRenderSetting(value)`
	Setting for rendering Emf metafile. The value of the property is EmfRenderSetting integer constant.
`method`	`getGridlineType()`
`method`	`setGridlineType(value)`
	Gets or sets gridline type. The value of the property is GridlineType integer constant.
`method`	`getIgnoreError()`
`method`	`setIgnoreError(value)`
	Indicates if you need to hide the error while rendering. The error can be error in shape, image, chart rendering, etc.
`method`	`isFontSubstitutionCharGranularity()`
`method`	`setFontSubstitutionCharGranularity(value)`
	Indicates whether to only substitute the font of character when the cell font is not compatibility for it.
`method`	`getMergeAreas()`
`method`	`setMergeAreas(value)`
	Indicates whether merge the areas of conditional formatting and validation before saving the file.
`method`	`getOnePagePerSheet()`
`method`	`setOnePagePerSheet(value)`
	If OnePagePerSheet is true , all content of one sheet will output to only one page in result. The paper size of pagesetup will be invalid, and the other settings of pagesetup will still take effect.
`method`	`getOutputBlankPageWhenNothingToPrint()`
`method`	`setOutputBlankPageWhenNothingToPrint(value)`
	Indicates whether to output a blank page when there is nothing to print.
`method`	`getPageCount()`
`method`	`setPageCount(value)`
	Gets or sets the number of pages to save.
`method`	`getPageIndex()`
`method`	`setPageIndex(value)`
	Gets or sets the 0-based index of the first page to save.
`method`	`getPageSavingCallback()`
`method`	`setPageSavingCallback(value)`
	Control/Indicate progress of page saving process.
`method`	`getPrintingPageType()`
`method`	`setPrintingPageType(value)`
	Indicates which pages will not be printed. The value of the property is PrintingPageType integer constant.
`method`	`getRefreshChartCache()`
`method`	`setRefreshChartCache(value)`
	Indicates whether refreshing chart cache data
`method`	`getSaveFormat()`
	Gets the save file format. The value of the property is SaveFormat integer constant.
`method`	`getSheetSet()`
`method`	`setSheetSet(value)`
	Gets or sets the sheets to render. Default is all visible sheets in the workbook: SheetSet.Visible.
`method`	`getSortExternalNames()`
`method`	`setSortExternalNames(value)`
	Indicates whether sorting external defined names before saving file.
`method`	`getSortNames()`
`method`	`setSortNames(value)`
	Indicates whether sorting defined names before saving file.
`method`	`getTextCrossType()`
`method`	`setTextCrossType(value)`
	Gets or sets displaying text type when the text width is larger than cell width. The value of the property is TextCrossType integer constant.
`method`	`getUpdateSmartArt()`
`method`	`setUpdateSmartArt(value)`
	Indicates whether updating smart art setting. The default value is false.
`method`	`getValidateMergedAreas()`
`method`	`setValidateMergedAreas(value)`
	Indicates whether validate merged cells before saving the file.

- Constructor Detail
  - XpsSaveOptions
```
XpsSaveOptions()
```
    Creates options for saving xps file.
  - XpsSaveOptions
```
XpsSaveOptions(saveFormat)
```
    Creates options for saving xps file.
    NOTE: This constructor is now obsolete. Instead, please use XpsSaveOptions() constructor. This property will be removed 12 months later since August 2022. Aspose apologizes for any inconvenience you may have experienced.
    Parameters:
    saveFormat: int - A SaveFormat value. The save format, it must be xps format.
- Property Getters/Setters Detail
  - getDefaultFont/setDefaultFont : String
```
String getDefaultFont() / setDefaultFont(value)
```
    When characters in the Excel are Unicode and not be set with correct font in cell style, They may appear as block in pdf,image. Set the DefaultFont such as MingLiu or MS Gothic to show these characters. If this property is not set, Aspose.Cells will use system default font to show these unicode characters.
  - getCheckWorkbookDefaultFont/setCheckWorkbookDefaultFont : boolean
```
boolean getCheckWorkbookDefaultFont() / setCheckWorkbookDefaultFont(value)
```
    When characters in the Excel are Unicode and not be set with correct font in cell style, They may appear as block in pdf,image. Set this to true to try to use workbook's default font to show these characters first.
    Default is true.
  - getCheckFontCompatibility/setCheckFontCompatibility : boolean
```
boolean getCheckFontCompatibility() / setCheckFontCompatibility(value)
```
    Indicates whether to check font compatibility for every character in text.
    The default value is true. Disable this property may give better performance. But when the default or specified font of text/character cannot be used to render it, unreadable characters(such as block) maybe occur in the generated pdf. For such situation user should keep this property as true so that alternative font can be searched and used to render the text instead;
  - isFontSubstitutionCharGranularity/setFontSubstitutionCharGranularity : boolean
```
boolean isFontSubstitutionCharGranularity() / setFontSubstitutionCharGranularity(value)
```
    Indicates whether to only substitute the font of character when the cell font is not compatibility for it.
    Default is false. We will try default font of Workbook and PdfSaveOption/system for cell font first.
  - getOnePagePerSheet/setOnePagePerSheet : boolean
```
boolean getOnePagePerSheet() / setOnePagePerSheet(value)
```
    If OnePagePerSheet is true , all content of one sheet will output to only one page in result. The paper size of pagesetup will be invalid, and the other settings of pagesetup will still take effect.
  - getAllColumnsInOnePagePerSheet/setAllColumnsInOnePagePerSheet : boolean
```
boolean getAllColumnsInOnePagePerSheet() / setAllColumnsInOnePagePerSheet(value)
```
    If AllColumnsInOnePagePerSheet is true , all column content of one sheet will output to only one page in result. The width of paper size of pagesetup will be ignored, and the other settings of pagesetup will still take effect.
  - getIgnoreError/setIgnoreError : boolean
```
boolean getIgnoreError() / setIgnoreError(value)
```
    Indicates if you need to hide the error while rendering. The error can be error in shape, image, chart rendering, etc.
  - getOutputBlankPageWhenNothingToPrint/setOutputBlankPageWhenNothingToPrint : boolean
```
boolean getOutputBlankPageWhenNothingToPrint() / setOutputBlankPageWhenNothingToPrint(value)
```
    Indicates whether to output a blank page when there is nothing to print.
    Default is true.
  - getPageIndex/setPageIndex : int
```
int getPageIndex() / setPageIndex(value)
```
    Gets or sets the 0-based index of the first page to save.
    Default is 0.
  - getPageCount/setPageCount : int
```
int getPageCount() / setPageCount(value)
```
    Gets or sets the number of pages to save.
    Default is System.Int32.MaxValue which means all pages will be rendered..
  - getPrintingPageType/setPrintingPageType : int
```
int getPrintingPageType() / setPrintingPageType(value)
```
    Indicates which pages will not be printed. The value of the property is PrintingPageType integer constant.
    If content in the sheet is sparse, there will be some pages are totally blank in the output pdf file. If you don't want these blank pages, you can use this option to omit them.
  - getGridlineType/setGridlineType : int
```
int getGridlineType() / setGridlineType(value)
```
    Gets or sets gridline type. The value of the property is GridlineType integer constant.
    Default is Dotted type.
  - getTextCrossType/setTextCrossType : int
```
int getTextCrossType() / setTextCrossType(value)
```
    Gets or sets displaying text type when the text width is larger than cell width. The value of the property is TextCrossType integer constant.
  - getDefaultEditLanguage/setDefaultEditLanguage : int
```
int getDefaultEditLanguage() / setDefaultEditLanguage(value)
```
    Gets or sets default edit language. The value of the property is DefaultEditLanguage integer constant.
    It may display/render different layouts for text paragraph when different edit languages is set. Default is DefaultEditLanguage.AUTO.
  - getSheetSet/setSheetSet : SheetSet
```
SheetSet getSheetSet() / setSheetSet(value)
```
    Gets or sets the sheets to render. Default is all visible sheets in the workbook: SheetSet.Visible.
  - getDrawObjectEventHandler/setDrawObjectEventHandler : DrawObjectEventHandler
```
DrawObjectEventHandler getDrawObjectEventHandler() / setDrawObjectEventHandler(value)
```
    Implements this interface to get DrawObject and Bound when rendering.
  - getPageSavingCallback/setPageSavingCallback : IPageSavingCallback
```
IPageSavingCallback getPageSavingCallback() / setPageSavingCallback(value)
```
    Control/Indicate progress of page saving process.
  - getEmfRenderSetting/setEmfRenderSetting : int
```
int getEmfRenderSetting() / setEmfRenderSetting(value)
```
    Setting for rendering Emf metafile. The value of the property is EmfRenderSetting integer constant.
    EMF metafiles identified as "EMF+ Dual" can contain both EMF+ records and EMF records. Either type of record can be used to render the image, only EMF+ records, or only EMF records. When EmfRenderSetting.EMF_PLUS_PREFER is set, then EMF+ records will be parsed while rendering to page, otherwise only EMF records will be parsed. Default value is EmfRenderSetting.EMF_ONLY.
  - getSaveFormat : int
```
int getSaveFormat()
```
    Gets the save file format. The value of the property is SaveFormat integer constant.
  - getClearData/setClearData : boolean
```
boolean getClearData() / setClearData(value)
```
    Make the workbook empty after saving the file.
  - getCachedFileFolder/setCachedFileFolder : String
```
String getCachedFileFolder() / setCachedFileFolder(value)
```
    The cached file folder is used to store some large data.
  - getValidateMergedAreas/setValidateMergedAreas : boolean
```
boolean getValidateMergedAreas() / setValidateMergedAreas(value)
```
    Indicates whether validate merged cells before saving the file.
    The default value is false.
  - getMergeAreas/setMergeAreas : boolean
```
boolean getMergeAreas() / setMergeAreas(value)
```
    Indicates whether merge the areas of conditional formatting and validation before saving the file.
    The default value is false.
  - getCreateDirectory/setCreateDirectory : boolean
```
boolean getCreateDirectory() / setCreateDirectory(value)
```
    If true and the directory does not exist, the directory will be automatically created before saving the file.
    The default value is false.
  - getSortNames/setSortNames : boolean
```
boolean getSortNames() / setSortNames(value)
```
    Indicates whether sorting defined names before saving file.
  - getSortExternalNames/setSortExternalNames : boolean
```
boolean getSortExternalNames() / setSortExternalNames(value)
```
    Indicates whether sorting external defined names before saving file.
  - getRefreshChartCache/setRefreshChartCache : boolean
```
boolean getRefreshChartCache() / setRefreshChartCache(value)
```
    Indicates whether refreshing chart cache data
  - getUpdateSmartArt/setUpdateSmartArt : boolean
```
boolean getUpdateSmartArt() / setUpdateSmartArt(value)
```
    Indicates whether updating smart art setting. The default value is false.
    Only effects after calling Shape.GetResultOfSmartArt() method and the cached shapes exist in the template file.

asposecells.api

Classes

Constants

Class XpsSaveOptions

Constructor Detail

XpsSaveOptions

XpsSaveOptions

Property Getters/Setters Detail

getDefaultFont/setDefaultFont : String

getCheckWorkbookDefaultFont/setCheckWorkbookDefaultFont : boolean

getCheckFontCompatibility/setCheckFontCompatibility : boolean

isFontSubstitutionCharGranularity/setFontSubstitutionCharGranularity : boolean

getOnePagePerSheet/setOnePagePerSheet : boolean

getAllColumnsInOnePagePerSheet/setAllColumnsInOnePagePerSheet : boolean

getIgnoreError/setIgnoreError : boolean

getOutputBlankPageWhenNothingToPrint/setOutputBlankPageWhenNothingToPrint : boolean

getPageIndex/setPageIndex : int

getPageCount/setPageCount : int

getPrintingPageType/setPrintingPageType : int

getGridlineType/setGridlineType : int

getTextCrossType/setTextCrossType : int

getDefaultEditLanguage/setDefaultEditLanguage : int

getSheetSet/setSheetSet : SheetSet

getDrawObjectEventHandler/setDrawObjectEventHandler : DrawObjectEventHandler

getPageSavingCallback/setPageSavingCallback : IPageSavingCallback

getEmfRenderSetting/setEmfRenderSetting : int

getSaveFormat : int

getClearData/setClearData : boolean

getCachedFileFolder/setCachedFileFolder : String

getValidateMergedAreas/setValidateMergedAreas : boolean

getMergeAreas/setMergeAreas : boolean

getCreateDirectory/setCreateDirectory : boolean

getSortNames/setSortNames : boolean

getSortExternalNames/setSortExternalNames : boolean

getRefreshChartCache/setRefreshChartCache : boolean

getUpdateSmartArt/setUpdateSmartArt : boolean