SvgImageOptions

SvgImageOptions class

Options for generating Svg image.

class SvgImageOptions extends ImageOrPrintOptions;

Constructors

ConstructorDescription
constructor()Ctor.
constructor(ImageOrPrintOptions)Constructs from a parent object convertible to this.

Properties

PropertyTypeDescription
fitToViewPortbooleanif this property is true, the generated svg will fit to view port.
cssPrefixstringGets and sets the prefix of the css name in svg,the default value is empty string.
embeddedFontTypeSvgEmbeddedFontTypeGets or sets the type of font that embedded in Svg.
printWithStatusDialogbooleanIf PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.
horizontalResolutionnumberGets or sets the horizontal resolution for generated images, in dots per inch.
verticalResolutionnumberGets or sets the vertical resolution for generated images, in dots per inch.
tiffCompressionTiffCompressionGets or sets the type of compression to apply only when saving pages to the Tiff format.
tiffColorDepthColorDepthGets or sets bit depth to apply only when saving pages to the Tiff format.
tiffBinarizationMethodImageBinarizationMethodGets or sets method used while converting images to 1 bpp format when ImageType is Tiff and TiffCompression is equal to Ccitt3 or Ccitt4.
printingPagePrintingPageTypeIndicates which pages will not be printed.
qualitynumberGets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format. The default value is 100
onePagePerSheetbooleanIf 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.
allColumnsInOnePagePerSheetbooleanIf 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 invalid, and the other settings of pagesetup will still take effect.
drawObjectEventHandlerDrawObjectEventHandlerImplements this interface to get DrawObject and Bound when rendering.
embededImageNameInSvgstringIndicate the filename of embedded image in svg. This should be full path with directory like “c:\xpsEmbedded”
sVGFitToViewPortbooleanif this property is true, the generated svg will fit to view port.
svgCssPrefixstringGets and sets the prefix of the css name in svg,the default value is empty string.
onlyAreabooleanIf this property is true , one Area will be output, and no scale will take effect.
transparentbooleanIndicates if the background of generated image should be transparent.
warningCallbackIWarningCallbackGets or sets warning callback.
pageSavingCallbackIPageSavingCallbackControl/Indicate progress of page saving process.
isFontSubstitutionCharGranularitybooleanIndicates whether to only substitute the font of character when the cell font is not compatibility for it.
pageIndexnumberGets or sets the 0-based index of the first page to save.
pageCountnumberGets or sets the number of pages to save.
isOptimizedbooleanIndicates whether to optimize the output elements.
defaultFontstringWhen 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.
checkWorkbookDefaultFontbooleanWhen 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.
outputBlankPageWhenNothingToPrintbooleanIndicates whether to output a blank page when there is nothing to print.
gridlineTypeGridlineTypeGets or sets gridline type.
gridlineColorColorGets or sets gridline colr.
textCrossTypeTextCrossTypeGets or sets displaying text type when the text width is larger than cell width.
defaultEditLanguageDefaultEditLanguageGets or sets default edit language.
sheetSetSheetSetGets or sets the sheets to render. Default is all visible sheets in the workbook: Aspose.Cells.Rendering.SheetSet.Visible.
emfRenderSettingEmfRenderSettingSetting for rendering Emf metafiles in source file.
customRenderSettingsCustomRenderSettingsGets or sets custom settings during rendering.

Methods

MethodDescription
getFitToViewPort()@deprecated. Please use the ‘fitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.
setFitToViewPort(boolean)@deprecated. Please use the ‘fitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.
getCssPrefix()@deprecated. Please use the ‘cssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.
setCssPrefix(string)@deprecated. Please use the ‘cssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.
getEmbeddedFontType()@deprecated. Please use the ’embeddedFontType’ property instead. Gets or sets the type of font that embedded in Svg.
setEmbeddedFontType(SvgEmbeddedFontType)@deprecated. Please use the ’embeddedFontType’ property instead. Gets or sets the type of font that embedded in Svg.
isNull()Checks whether the implementation object is null.
setPrintWithStatusDialog(boolean)@deprecated. Please use the ‘printWithStatusDialog’ property instead. If PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.
getPrintWithStatusDialog()@deprecated. Please use the ‘printWithStatusDialog’ property instead. If PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.
getHorizontalResolution()@deprecated. Please use the ‘horizontalResolution’ property instead. Gets or sets the horizontal resolution for generated images, in dots per inch.
setHorizontalResolution(number)@deprecated. Please use the ‘horizontalResolution’ property instead. Gets or sets the horizontal resolution for generated images, in dots per inch.
getVerticalResolution()@deprecated. Please use the ‘verticalResolution’ property instead. Gets or sets the vertical resolution for generated images, in dots per inch.
setVerticalResolution(number)@deprecated. Please use the ‘verticalResolution’ property instead. Gets or sets the vertical resolution for generated images, in dots per inch.
getTiffCompression()@deprecated. Please use the ’tiffCompression’ property instead. Gets or sets the type of compression to apply only when saving pages to the Tiff format.
setTiffCompression(TiffCompression)@deprecated. Please use the ’tiffCompression’ property instead. Gets or sets the type of compression to apply only when saving pages to the Tiff format.
getTiffColorDepth()@deprecated. Please use the ’tiffColorDepth’ property instead. Gets or sets bit depth to apply only when saving pages to the Tiff format.
setTiffColorDepth(ColorDepth)@deprecated. Please use the ’tiffColorDepth’ property instead. Gets or sets bit depth to apply only when saving pages to the Tiff format.
getTiffBinarizationMethod()@deprecated. Please use the ’tiffBinarizationMethod’ property instead. Gets or sets method used while converting images to 1 bpp format when ImageType is Tiff and TiffCompression is equal to Ccitt3 or Ccitt4.
setTiffBinarizationMethod(ImageBinarizationMethod)@deprecated. Please use the ’tiffBinarizationMethod’ property instead. Gets or sets method used while converting images to 1 bpp format when ImageType is Tiff and TiffCompression is equal to Ccitt3 or Ccitt4.
getPrintingPage()@deprecated. Please use the ‘printingPage’ property instead. Indicates which pages will not be printed.
setPrintingPage(PrintingPageType)@deprecated. Please use the ‘printingPage’ property instead. Indicates which pages will not be printed.
getQuality()@deprecated. Please use the ‘quality’ property instead. Gets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format. The default value is 100
setQuality(number)@deprecated. Please use the ‘quality’ property instead. Gets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format. The default value is 100
getOnePagePerSheet()@deprecated. Please use the ‘onePagePerSheet’ property instead. 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.
setOnePagePerSheet(boolean)@deprecated. Please use the ‘onePagePerSheet’ property instead. 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()@deprecated. Please use the ‘allColumnsInOnePagePerSheet’ property instead. 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 invalid, and the other settings of pagesetup will still take effect.
setAllColumnsInOnePagePerSheet(boolean)@deprecated. Please use the ‘allColumnsInOnePagePerSheet’ property instead. 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 invalid, and the other settings of pagesetup will still take effect.
getDrawObjectEventHandler()@deprecated. Please use the ‘drawObjectEventHandler’ property instead. Implements this interface to get DrawObject and Bound when rendering.
setDrawObjectEventHandler(DrawObjectEventHandler)@deprecated. Please use the ‘drawObjectEventHandler’ property instead. Implements this interface to get DrawObject and Bound when rendering.
getEmbededImageNameInSvg()@deprecated. Please use the ’embededImageNameInSvg’ property instead. Indicate the filename of embedded image in svg. This should be full path with directory like “c:\xpsEmbedded”
setEmbededImageNameInSvg(string)@deprecated. Please use the ’embededImageNameInSvg’ property instead. Indicate the filename of embedded image in svg. This should be full path with directory like “c:\xpsEmbedded”
getSVGFitToViewPort()@deprecated. Please use the ‘sVGFitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.
setSVGFitToViewPort(boolean)@deprecated. Please use the ‘sVGFitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.
getSvgCssPrefix()@deprecated. Please use the ‘svgCssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.
setSvgCssPrefix(string)@deprecated. Please use the ‘svgCssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.
getOnlyArea()@deprecated. Please use the ‘onlyArea’ property instead. If this property is true , one Area will be output, and no scale will take effect.
setOnlyArea(boolean)@deprecated. Please use the ‘onlyArea’ property instead. If this property is true , one Area will be output, and no scale will take effect.
getTransparent()@deprecated. Please use the ’transparent’ property instead. Indicates if the background of generated image should be transparent.
setTransparent(boolean)@deprecated. Please use the ’transparent’ property instead. Indicates if the background of generated image should be transparent.
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.
getPageSavingCallback()@deprecated. Please use the ‘pageSavingCallback’ property instead. Control/Indicate progress of page saving process.
setPageSavingCallback(IPageSavingCallback)@deprecated. Please use the ‘pageSavingCallback’ property instead. Control/Indicate progress of page saving process.
setIsFontSubstitutionCharGranularity(boolean)@deprecated. Please use the ‘isFontSubstitutionCharGranularity’ property instead. Indicates whether to only substitute the font of character when the cell font is not compatibility for it.
isFontSubstitutionCharGranularity()@deprecated. Please use the ‘isFontSubstitutionCharGranularity’ property instead. Indicates whether to only substitute the font of character when the cell font is not compatibility for it.
setPageIndex(number)@deprecated. Please use the ‘pageIndex’ property instead. Gets or sets the 0-based index of the first page to save.
getPageIndex()@deprecated. Please use the ‘pageIndex’ property instead. Gets or sets the 0-based index of the first page to save.
setPageCount(number)@deprecated. Please use the ‘pageCount’ property instead. Gets or sets the number of pages to save.
getPageCount()@deprecated. Please use the ‘pageCount’ property instead. Gets or sets the number of pages to save.
isOptimized()@deprecated. Please use the ‘isOptimized’ property instead. Indicates whether to optimize the output elements.
setIsOptimized(boolean)@deprecated. Please use the ‘isOptimized’ property instead. Indicates whether to optimize the output elements.
getDefaultFont()@deprecated. Please use the ‘defaultFont’ property instead. 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.
setDefaultFont(string)@deprecated. Please use the ‘defaultFont’ property instead. 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()@deprecated. Please use the ‘checkWorkbookDefaultFont’ property instead. 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.
setCheckWorkbookDefaultFont(boolean)@deprecated. Please use the ‘checkWorkbookDefaultFont’ property instead. 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.
getOutputBlankPageWhenNothingToPrint()@deprecated. Please use the ‘outputBlankPageWhenNothingToPrint’ property instead. Indicates whether to output a blank page when there is nothing to print.
setOutputBlankPageWhenNothingToPrint(boolean)@deprecated. Please use the ‘outputBlankPageWhenNothingToPrint’ property instead. Indicates whether to output a blank page when there is nothing to print.
getGridlineType()@deprecated. Please use the ‘gridlineType’ property instead. Gets or sets gridline type.
setGridlineType(GridlineType)@deprecated. Please use the ‘gridlineType’ property instead. Gets or sets gridline type.
getGridlineColor()@deprecated. Please use the ‘gridlineColor’ property instead. Gets or sets gridline colr.
setGridlineColor(Color)@deprecated. Please use the ‘gridlineColor’ property instead. Gets or sets gridline colr.
getTextCrossType()@deprecated. Please use the ’textCrossType’ property instead. Gets or sets displaying text type when the text width is larger than cell width.
setTextCrossType(TextCrossType)@deprecated. Please use the ’textCrossType’ property instead. Gets or sets displaying text type when the text width is larger than cell width.
getDefaultEditLanguage()@deprecated. Please use the ‘defaultEditLanguage’ property instead. Gets or sets default edit language.
setDefaultEditLanguage(DefaultEditLanguage)@deprecated. Please use the ‘defaultEditLanguage’ property instead. Gets or sets default edit language.
getSheetSet()@deprecated. Please use the ‘sheetSet’ property instead. Gets or sets the sheets to render. Default is all visible sheets in the workbook: Aspose.Cells.Rendering.SheetSet.Visible.
setSheetSet(SheetSet)@deprecated. Please use the ‘sheetSet’ property instead. Gets or sets the sheets to render. Default is all visible sheets in the workbook: Aspose.Cells.Rendering.SheetSet.Visible.
getEmfRenderSetting()@deprecated. Please use the ’emfRenderSetting’ property instead. Setting for rendering Emf metafiles in source file.
setEmfRenderSetting(EmfRenderSetting)@deprecated. Please use the ’emfRenderSetting’ property instead. Setting for rendering Emf metafiles in source file.
getCustomRenderSettings()@deprecated. Please use the ‘customRenderSettings’ property instead. Gets or sets custom settings during rendering.
setCustomRenderSettings(CustomRenderSettings)@deprecated. Please use the ‘customRenderSettings’ property instead. Gets or sets custom settings during rendering.
setDesiredSize(number, number, boolean)Sets desired width and height of image.
getImageType()Gets or sets the format of the generated images. default value: PNG.
setImageType(ImageType)Gets or sets the format of the generated images. default value: PNG.

constructor()

Ctor.

constructor();

constructor(ImageOrPrintOptions)

Constructs from a parent object convertible to this.

constructor(obj: ImageOrPrintOptions);

Parameters:

ParameterTypeDescription
objImageOrPrintOptionsThe parent object.

fitToViewPort

if this property is true, the generated svg will fit to view port.

fitToViewPort : boolean;

cssPrefix

Gets and sets the prefix of the css name in svg,the default value is empty string.

cssPrefix : string;

embeddedFontType

Gets or sets the type of font that embedded in Svg.

embeddedFontType : SvgEmbeddedFontType;

Remarks

Default value is SvgEmbeddedFontType.None which indicates that it will not embed font in Svg.

printWithStatusDialog

If PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.

printWithStatusDialog : boolean;

horizontalResolution

Gets or sets the horizontal resolution for generated images, in dots per inch.

horizontalResolution : number;

Remarks

ara>The default value is 96. Setting HorizontalResolution and VerticalResolution effects the width and height of the output image in pixels.</para

verticalResolution

Gets or sets the vertical resolution for generated images, in dots per inch.

verticalResolution : number;

Remarks

ara>The default value is 96. Setting HorizontalResolution and VerticalResolution effects the width and height of the output image in pixels.</para

tiffCompression

Gets or sets the type of compression to apply only when saving pages to the Tiff format.

tiffCompression : TiffCompression;

Remarks

Has effect only when saving to TIFF. The default value is Lzw.

tiffColorDepth

Gets or sets bit depth to apply only when saving pages to the Tiff format.

tiffColorDepth : ColorDepth;

Remarks

Has effect only when saving to TIFF. If TiffCompression is set to CCITT3, CCITT4, this will not take effect, the bit depth of the generated tiff image will be always 1.

tiffBinarizationMethod

Gets or sets method used while converting images to 1 bpp format when ImageType is Tiff and TiffCompression is equal to Ccitt3 or Ccitt4.

tiffBinarizationMethod : ImageBinarizationMethod;

Remarks

The default value is FloydSteinbergDithering.

printingPage

Indicates which pages will not be printed.

printingPage : PrintingPageType;

quality

Gets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format. The default value is 100

quality : number;

Remarks

Has effect only when saving to JPEG. The value must be between 0 and 100. The default value is 100.

onePagePerSheet

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.

onePagePerSheet : boolean;

allColumnsInOnePagePerSheet

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 invalid, and the other settings of pagesetup will still take effect.

allColumnsInOnePagePerSheet : boolean;

drawObjectEventHandler

Implements this interface to get DrawObject and Bound when rendering.

drawObjectEventHandler : DrawObjectEventHandler;

embededImageNameInSvg

Indicate the filename of embedded image in svg. This should be full path with directory like “c:\xpsEmbedded”

embededImageNameInSvg : string;

Remarks

NOTE: This member is now obsolete. Instead, please remove this property because images are now always embedded in Svg with base64 format. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

sVGFitToViewPort

if this property is true, the generated svg will fit to view port.

sVGFitToViewPort : boolean;

Remarks

NOTE: This member is now obsolete. Instead, please use SvgImageOptions.FitToViewPort. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

svgCssPrefix

Gets and sets the prefix of the css name in svg,the default value is empty string.

svgCssPrefix : string;

Remarks

NOTE: This member is now obsolete. Instead, please use SvgImageOptions.CssPrefix. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

onlyArea

If this property is true , one Area will be output, and no scale will take effect.

onlyArea : boolean;

transparent

Indicates if the background of generated image should be transparent.

transparent : boolean;

Remarks

The default value is false. That means the background of the generated images is white.

warningCallback

Gets or sets warning callback.

warningCallback : IWarningCallback;

pageSavingCallback

Control/Indicate progress of page saving process.

pageSavingCallback : IPageSavingCallback;

isFontSubstitutionCharGranularity

Indicates whether to only substitute the font of character when the cell font is not compatibility for it.

isFontSubstitutionCharGranularity : boolean;

Remarks

Default is false. We will try default font of Workbook and PdfSaveOption/system for cell font first.

pageIndex

Gets or sets the 0-based index of the first page to save.

pageIndex : number;

Remarks

Default is 0.

pageCount

Gets or sets the number of pages to save.

pageCount : number;

Remarks

Default is System.Int32.MaxValue which means all pages will be rendered.

isOptimized

Indicates whether to optimize the output elements.

isOptimized : boolean;

Remarks

Default value is false. Currently when this property is set to true, the following optimizations will be done: 1. optimize the border lines. 2. optimize the file size while rendering to Svg image.

defaultFont

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.

defaultFont : string;

checkWorkbookDefaultFont

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.

checkWorkbookDefaultFont : boolean;

Remarks

Default is true.

outputBlankPageWhenNothingToPrint

Indicates whether to output a blank page when there is nothing to print.

outputBlankPageWhenNothingToPrint : boolean;

Remarks

Default is false.

gridlineType

Gets or sets gridline type.

gridlineType : GridlineType;

Remarks

Default is Dotted type.

gridlineColor

Gets or sets gridline colr.

gridlineColor : Color;

Remarks

It will ignore the gridline color settings in the source file.

textCrossType

Gets or sets displaying text type when the text width is larger than cell width.

textCrossType : TextCrossType;

defaultEditLanguage

Gets or sets default edit language.

defaultEditLanguage : DefaultEditLanguage;

Remarks

It may display/render different layouts for text paragraph when different edit languages is set. Default is Aspose.Cells.DefaultEditLanguage.Auto.

sheetSet

Gets or sets the sheets to render. Default is all visible sheets in the workbook: Aspose.Cells.Rendering.SheetSet.Visible.

sheetSet : SheetSet;

Remarks

The set is ignored when it is used in SheetRender

emfRenderSetting

Setting for rendering Emf metafiles in source file.

emfRenderSetting : EmfRenderSetting;

Remarks

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 Aspose.Cells.EmfRenderSetting.EmfPlusPrefer is set, then EMF+ records will be parsed while rendering to image, otherwise only EMF records will be parsed. Default value is Aspose.Cells.EmfRenderSetting.EmfOnly. For the frameworks that depend on .Net System.Drawing.Common, this setting is ignored.

customRenderSettings

Gets or sets custom settings during rendering.

customRenderSettings : CustomRenderSettings;

getFitToViewPort()

@deprecated. Please use the ‘fitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.

getFitToViewPort() : boolean;

setFitToViewPort(boolean)

@deprecated. Please use the ‘fitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.

setFitToViewPort(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getCssPrefix()

@deprecated. Please use the ‘cssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.

getCssPrefix() : string;

setCssPrefix(string)

@deprecated. Please use the ‘cssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.

setCssPrefix(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getEmbeddedFontType()

@deprecated. Please use the ’embeddedFontType’ property instead. Gets or sets the type of font that embedded in Svg.

getEmbeddedFontType() : SvgEmbeddedFontType;

Returns

SvgEmbeddedFontType

Remarks

Default value is SvgEmbeddedFontType.None which indicates that it will not embed font in Svg.

setEmbeddedFontType(SvgEmbeddedFontType)

@deprecated. Please use the ’embeddedFontType’ property instead. Gets or sets the type of font that embedded in Svg.

setEmbeddedFontType(value: SvgEmbeddedFontType) : void;

Parameters:

ParameterTypeDescription
valueSvgEmbeddedFontTypeThe value to set.

Remarks

Default value is SvgEmbeddedFontType.None which indicates that it will not embed font in Svg.

isNull()

Checks whether the implementation object is null.

isNull() : boolean;

setPrintWithStatusDialog(boolean)

@deprecated. Please use the ‘printWithStatusDialog’ property instead. If PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.

setPrintWithStatusDialog(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getPrintWithStatusDialog()

@deprecated. Please use the ‘printWithStatusDialog’ property instead. If PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.

getPrintWithStatusDialog() : boolean;

getHorizontalResolution()

@deprecated. Please use the ‘horizontalResolution’ property instead. Gets or sets the horizontal resolution for generated images, in dots per inch.

getHorizontalResolution() : number;

Remarks

ara>The default value is 96. Setting HorizontalResolution and VerticalResolution effects the width and height of the output image in pixels.</para

setHorizontalResolution(number)

@deprecated. Please use the ‘horizontalResolution’ property instead. Gets or sets the horizontal resolution for generated images, in dots per inch.

setHorizontalResolution(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

Remarks

ara>The default value is 96. Setting HorizontalResolution and VerticalResolution effects the width and height of the output image in pixels.</para

getVerticalResolution()

@deprecated. Please use the ‘verticalResolution’ property instead. Gets or sets the vertical resolution for generated images, in dots per inch.

getVerticalResolution() : number;

Remarks

ara>The default value is 96. Setting HorizontalResolution and VerticalResolution effects the width and height of the output image in pixels.</para

setVerticalResolution(number)

@deprecated. Please use the ‘verticalResolution’ property instead. Gets or sets the vertical resolution for generated images, in dots per inch.

setVerticalResolution(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

Remarks

ara>The default value is 96. Setting HorizontalResolution and VerticalResolution effects the width and height of the output image in pixels.</para

getTiffCompression()

@deprecated. Please use the ’tiffCompression’ property instead. Gets or sets the type of compression to apply only when saving pages to the Tiff format.

getTiffCompression() : TiffCompression;

Returns

TiffCompression

Remarks

Has effect only when saving to TIFF. The default value is Lzw.

setTiffCompression(TiffCompression)

@deprecated. Please use the ’tiffCompression’ property instead. Gets or sets the type of compression to apply only when saving pages to the Tiff format.

setTiffCompression(value: TiffCompression) : void;

Parameters:

ParameterTypeDescription
valueTiffCompressionThe value to set.

Remarks

Has effect only when saving to TIFF. The default value is Lzw.

getTiffColorDepth()

@deprecated. Please use the ’tiffColorDepth’ property instead. Gets or sets bit depth to apply only when saving pages to the Tiff format.

getTiffColorDepth() : ColorDepth;

Returns

ColorDepth

Remarks

Has effect only when saving to TIFF. If TiffCompression is set to CCITT3, CCITT4, this will not take effect, the bit depth of the generated tiff image will be always 1.

setTiffColorDepth(ColorDepth)

@deprecated. Please use the ’tiffColorDepth’ property instead. Gets or sets bit depth to apply only when saving pages to the Tiff format.

setTiffColorDepth(value: ColorDepth) : void;

Parameters:

ParameterTypeDescription
valueColorDepthThe value to set.

Remarks

Has effect only when saving to TIFF. If TiffCompression is set to CCITT3, CCITT4, this will not take effect, the bit depth of the generated tiff image will be always 1.

getTiffBinarizationMethod()

@deprecated. Please use the ’tiffBinarizationMethod’ property instead. Gets or sets method used while converting images to 1 bpp format when ImageType is Tiff and TiffCompression is equal to Ccitt3 or Ccitt4.

getTiffBinarizationMethod() : ImageBinarizationMethod;

Returns

ImageBinarizationMethod

Remarks

The default value is FloydSteinbergDithering.

setTiffBinarizationMethod(ImageBinarizationMethod)

@deprecated. Please use the ’tiffBinarizationMethod’ property instead. Gets or sets method used while converting images to 1 bpp format when ImageType is Tiff and TiffCompression is equal to Ccitt3 or Ccitt4.

setTiffBinarizationMethod(value: ImageBinarizationMethod) : void;

Parameters:

ParameterTypeDescription
valueImageBinarizationMethodThe value to set.

Remarks

The default value is FloydSteinbergDithering.

getPrintingPage()

@deprecated. Please use the ‘printingPage’ property instead. Indicates which pages will not be printed.

getPrintingPage() : PrintingPageType;

Returns

PrintingPageType

setPrintingPage(PrintingPageType)

@deprecated. Please use the ‘printingPage’ property instead. Indicates which pages will not be printed.

setPrintingPage(value: PrintingPageType) : void;

Parameters:

ParameterTypeDescription
valuePrintingPageTypeThe value to set.

getQuality()

@deprecated. Please use the ‘quality’ property instead. Gets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format. The default value is 100

getQuality() : number;

Remarks

Has effect only when saving to JPEG. The value must be between 0 and 100. The default value is 100.

setQuality(number)

@deprecated. Please use the ‘quality’ property instead. Gets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format. The default value is 100

setQuality(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

Remarks

Has effect only when saving to JPEG. The value must be between 0 and 100. The default value is 100.

getOnePagePerSheet()

@deprecated. Please use the ‘onePagePerSheet’ property instead. 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.

getOnePagePerSheet() : boolean;

setOnePagePerSheet(boolean)

@deprecated. Please use the ‘onePagePerSheet’ property instead. 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.

setOnePagePerSheet(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getAllColumnsInOnePagePerSheet()

@deprecated. Please use the ‘allColumnsInOnePagePerSheet’ property instead. 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 invalid, and the other settings of pagesetup will still take effect.

getAllColumnsInOnePagePerSheet() : boolean;

setAllColumnsInOnePagePerSheet(boolean)

@deprecated. Please use the ‘allColumnsInOnePagePerSheet’ property instead. 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 invalid, and the other settings of pagesetup will still take effect.

setAllColumnsInOnePagePerSheet(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getDrawObjectEventHandler()

@deprecated. Please use the ‘drawObjectEventHandler’ property instead. Implements this interface to get DrawObject and Bound when rendering.

getDrawObjectEventHandler() : DrawObjectEventHandler;

Returns

DrawObjectEventHandler

setDrawObjectEventHandler(DrawObjectEventHandler)

@deprecated. Please use the ‘drawObjectEventHandler’ property instead. Implements this interface to get DrawObject and Bound when rendering.

setDrawObjectEventHandler(value: DrawObjectEventHandler) : void;

Parameters:

ParameterTypeDescription
valueDrawObjectEventHandlerThe value to set.

getEmbededImageNameInSvg()

@deprecated. Please use the ’embededImageNameInSvg’ property instead. Indicate the filename of embedded image in svg. This should be full path with directory like “c:\xpsEmbedded”

getEmbededImageNameInSvg() : string;

Remarks

NOTE: This member is now obsolete. Instead, please remove this property because images are now always embedded in Svg with base64 format. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

setEmbededImageNameInSvg(string)

@deprecated. Please use the ’embededImageNameInSvg’ property instead. Indicate the filename of embedded image in svg. This should be full path with directory like “c:\xpsEmbedded”

setEmbededImageNameInSvg(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

Remarks

NOTE: This member is now obsolete. Instead, please remove this property because images are now always embedded in Svg with base64 format. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

getSVGFitToViewPort()

@deprecated. Please use the ‘sVGFitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.

getSVGFitToViewPort() : boolean;

Remarks

NOTE: This member is now obsolete. Instead, please use SvgImageOptions.FitToViewPort. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

setSVGFitToViewPort(boolean)

@deprecated. Please use the ‘sVGFitToViewPort’ property instead. if this property is true, the generated svg will fit to view port.

setSVGFitToViewPort(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

Remarks

NOTE: This member is now obsolete. Instead, please use SvgImageOptions.FitToViewPort. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

getSvgCssPrefix()

@deprecated. Please use the ‘svgCssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.

getSvgCssPrefix() : string;

Remarks

NOTE: This member is now obsolete. Instead, please use SvgImageOptions.CssPrefix. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

setSvgCssPrefix(string)

@deprecated. Please use the ‘svgCssPrefix’ property instead. Gets and sets the prefix of the css name in svg,the default value is empty string.

setSvgCssPrefix(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

Remarks

NOTE: This member is now obsolete. Instead, please use SvgImageOptions.CssPrefix. This property will be removed 12 months later since April 2025. Aspose apologizes for any inconvenience you may have experienced.

getOnlyArea()

@deprecated. Please use the ‘onlyArea’ property instead. If this property is true , one Area will be output, and no scale will take effect.

getOnlyArea() : boolean;

setOnlyArea(boolean)

@deprecated. Please use the ‘onlyArea’ property instead. If this property is true , one Area will be output, and no scale will take effect.

setOnlyArea(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getTransparent()

@deprecated. Please use the ’transparent’ property instead. Indicates if the background of generated image should be transparent.

getTransparent() : boolean;

Remarks

The default value is false. That means the background of the generated images is white.

setTransparent(boolean)

@deprecated. Please use the ’transparent’ property instead. Indicates if the background of generated image should be transparent.

setTransparent(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

Remarks

The default value is false. That means the background of the generated images is white.

setWarningCallback(IWarningCallback)

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

setWarningCallback(value: IWarningCallback) : void;

Parameters:

ParameterTypeDescription
valueIWarningCallbackThe value to set.

getWarningCallback()

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

getWarningCallback() : IWarningCallback;

Returns

IWarningCallback

getPageSavingCallback()

@deprecated. Please use the ‘pageSavingCallback’ property instead. Control/Indicate progress of page saving process.

getPageSavingCallback() : IPageSavingCallback;

Returns

IPageSavingCallback

setPageSavingCallback(IPageSavingCallback)

@deprecated. Please use the ‘pageSavingCallback’ property instead. Control/Indicate progress of page saving process.

setPageSavingCallback(value: IPageSavingCallback) : void;

Parameters:

ParameterTypeDescription
valueIPageSavingCallbackThe value to set.

setIsFontSubstitutionCharGranularity(boolean)

@deprecated. Please use the ‘isFontSubstitutionCharGranularity’ property instead. Indicates whether to only substitute the font of character when the cell font is not compatibility for it.

setIsFontSubstitutionCharGranularity(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

Remarks

Default is false. We will try default font of Workbook and PdfSaveOption/system for cell font first.

isFontSubstitutionCharGranularity()

@deprecated. Please use the ‘isFontSubstitutionCharGranularity’ property instead. Indicates whether to only substitute the font of character when the cell font is not compatibility for it.

isFontSubstitutionCharGranularity() : boolean;

Remarks

Default is false. We will try default font of Workbook and PdfSaveOption/system for cell font first.

setPageIndex(number)

@deprecated. Please use the ‘pageIndex’ property instead. Gets or sets the 0-based index of the first page to save.

setPageIndex(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

Remarks

Default is 0.

getPageIndex()

@deprecated. Please use the ‘pageIndex’ property instead. Gets or sets the 0-based index of the first page to save.

getPageIndex() : number;

Remarks

Default is 0.

setPageCount(number)

@deprecated. Please use the ‘pageCount’ property instead. Gets or sets the number of pages to save.

setPageCount(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

Remarks

Default is System.Int32.MaxValue which means all pages will be rendered.

getPageCount()

@deprecated. Please use the ‘pageCount’ property instead. Gets or sets the number of pages to save.

getPageCount() : number;

Remarks

Default is System.Int32.MaxValue which means all pages will be rendered.

isOptimized()

@deprecated. Please use the ‘isOptimized’ property instead. Indicates whether to optimize the output elements.

isOptimized() : boolean;

Remarks

Default value is false. Currently when this property is set to true, the following optimizations will be done: 1. optimize the border lines. 2. optimize the file size while rendering to Svg image.

setIsOptimized(boolean)

@deprecated. Please use the ‘isOptimized’ property instead. Indicates whether to optimize the output elements.

setIsOptimized(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

Remarks

Default value is false. Currently when this property is set to true, the following optimizations will be done: 1. optimize the border lines. 2. optimize the file size while rendering to Svg image.

getDefaultFont()

@deprecated. Please use the ‘defaultFont’ property instead. 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.

getDefaultFont() : string;

setDefaultFont(string)

@deprecated. Please use the ‘defaultFont’ property instead. 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.

setDefaultFont(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getCheckWorkbookDefaultFont()

@deprecated. Please use the ‘checkWorkbookDefaultFont’ property instead. 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.

getCheckWorkbookDefaultFont() : boolean;

Remarks

Default is true.

setCheckWorkbookDefaultFont(boolean)

@deprecated. Please use the ‘checkWorkbookDefaultFont’ property instead. 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.

setCheckWorkbookDefaultFont(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

Remarks

Default is true.

getOutputBlankPageWhenNothingToPrint()

@deprecated. Please use the ‘outputBlankPageWhenNothingToPrint’ property instead. Indicates whether to output a blank page when there is nothing to print.

getOutputBlankPageWhenNothingToPrint() : boolean;

Remarks

Default is false.

setOutputBlankPageWhenNothingToPrint(boolean)

@deprecated. Please use the ‘outputBlankPageWhenNothingToPrint’ property instead. Indicates whether to output a blank page when there is nothing to print.

setOutputBlankPageWhenNothingToPrint(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

Remarks

Default is false.

getGridlineType()

@deprecated. Please use the ‘gridlineType’ property instead. Gets or sets gridline type.

getGridlineType() : GridlineType;

Returns

GridlineType

Remarks

Default is Dotted type.

setGridlineType(GridlineType)

@deprecated. Please use the ‘gridlineType’ property instead. Gets or sets gridline type.

setGridlineType(value: GridlineType) : void;

Parameters:

ParameterTypeDescription
valueGridlineTypeThe value to set.

Remarks

Default is Dotted type.

getGridlineColor()

@deprecated. Please use the ‘gridlineColor’ property instead. Gets or sets gridline colr.

getGridlineColor() : Color;

Returns

Color

Remarks

It will ignore the gridline color settings in the source file.

setGridlineColor(Color)

@deprecated. Please use the ‘gridlineColor’ property instead. Gets or sets gridline colr.

setGridlineColor(value: Color) : void;

Parameters:

ParameterTypeDescription
valueColorThe value to set.

Remarks

It will ignore the gridline color settings in the source file.

getTextCrossType()

@deprecated. Please use the ’textCrossType’ property instead. Gets or sets displaying text type when the text width is larger than cell width.

getTextCrossType() : TextCrossType;

Returns

TextCrossType

setTextCrossType(TextCrossType)

@deprecated. Please use the ’textCrossType’ property instead. Gets or sets displaying text type when the text width is larger than cell width.

setTextCrossType(value: TextCrossType) : void;

Parameters:

ParameterTypeDescription
valueTextCrossTypeThe value to set.

getDefaultEditLanguage()

@deprecated. Please use the ‘defaultEditLanguage’ property instead. Gets or sets default edit language.

getDefaultEditLanguage() : DefaultEditLanguage;

Returns

DefaultEditLanguage

Remarks

It may display/render different layouts for text paragraph when different edit languages is set. Default is Aspose.Cells.DefaultEditLanguage.Auto.

setDefaultEditLanguage(DefaultEditLanguage)

@deprecated. Please use the ‘defaultEditLanguage’ property instead. Gets or sets default edit language.

setDefaultEditLanguage(value: DefaultEditLanguage) : void;

Parameters:

ParameterTypeDescription
valueDefaultEditLanguageThe value to set.

Remarks

It may display/render different layouts for text paragraph when different edit languages is set. Default is Aspose.Cells.DefaultEditLanguage.Auto.

getSheetSet()

@deprecated. Please use the ‘sheetSet’ property instead. Gets or sets the sheets to render. Default is all visible sheets in the workbook: Aspose.Cells.Rendering.SheetSet.Visible.

getSheetSet() : SheetSet;

Returns

SheetSet

Remarks

The set is ignored when it is used in SheetRender

setSheetSet(SheetSet)

@deprecated. Please use the ‘sheetSet’ property instead. Gets or sets the sheets to render. Default is all visible sheets in the workbook: Aspose.Cells.Rendering.SheetSet.Visible.

setSheetSet(value: SheetSet) : void;

Parameters:

ParameterTypeDescription
valueSheetSetThe value to set.

Remarks

The set is ignored when it is used in SheetRender

getEmfRenderSetting()

@deprecated. Please use the ’emfRenderSetting’ property instead. Setting for rendering Emf metafiles in source file.

getEmfRenderSetting() : EmfRenderSetting;

Returns

EmfRenderSetting

Remarks

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 Aspose.Cells.EmfRenderSetting.EmfPlusPrefer is set, then EMF+ records will be parsed while rendering to image, otherwise only EMF records will be parsed. Default value is Aspose.Cells.EmfRenderSetting.EmfOnly. For the frameworks that depend on .Net System.Drawing.Common, this setting is ignored.

setEmfRenderSetting(EmfRenderSetting)

@deprecated. Please use the ’emfRenderSetting’ property instead. Setting for rendering Emf metafiles in source file.

setEmfRenderSetting(value: EmfRenderSetting) : void;

Parameters:

ParameterTypeDescription
valueEmfRenderSettingThe value to set.

Remarks

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 Aspose.Cells.EmfRenderSetting.EmfPlusPrefer is set, then EMF+ records will be parsed while rendering to image, otherwise only EMF records will be parsed. Default value is Aspose.Cells.EmfRenderSetting.EmfOnly. For the frameworks that depend on .Net System.Drawing.Common, this setting is ignored.

getCustomRenderSettings()

@deprecated. Please use the ‘customRenderSettings’ property instead. Gets or sets custom settings during rendering.

getCustomRenderSettings() : CustomRenderSettings;

Returns

CustomRenderSettings

setCustomRenderSettings(CustomRenderSettings)

@deprecated. Please use the ‘customRenderSettings’ property instead. Gets or sets custom settings during rendering.

setCustomRenderSettings(value: CustomRenderSettings) : void;

Parameters:

ParameterTypeDescription
valueCustomRenderSettingsThe value to set.

setDesiredSize(number, number, boolean)

Sets desired width and height of image.

setDesiredSize(desiredWidth: number, desiredHeight: number, keepAspectRatio: boolean) : void;

Parameters:

ParameterTypeDescription
desiredWidthnumberdesired width in pixels
desiredHeightnumberdesired height in pixels
keepAspectRatiobooleanwhether to keep aspect ratio of origin image

Remarks

ara>The width and height of the output image in pixels will be only based on the set desired width and height. The HorizontalResolution and VerticalResolution will not effect the width and height of the output image in this case.</para

getImageType()

Gets or sets the format of the generated images. default value: PNG.

getImageType() : ImageType;

Returns

ImageType

setImageType(ImageType)

Gets or sets the format of the generated images. default value: PNG.

setImageType(value: ImageType) : void;

Parameters:

ParameterTypeDescription
valueImageTypeThe value to set.