SvgImageOptions

SvgImageOptions class

Constructors

NameDescription
SvgImageOptions

Properties

NameTypeDescription
ImageTypeintThe value of the property is ImageType integer constant.
FitToViewPortboolean
CssPrefixString
EmbeddedFontTypeintThe value of the property is SvgEmbeddedFontType integer constant.
SaveFormatintGets or sets the output file format type Support Tiff/XPS The value of the property is SaveFormat integer constant. NOTE
PrintWithStatusDialogbooleanIf PrintWithStatusDialog = true , there will be a dialog that shows current print status. else no such dialog will show.
HorizontalResolutionintGets or sets the horizontal resolution for generated images, in dots per inch. Applies generating image method except Em
VerticalResolutionintGets or sets the vertical resolution for generated images, in dots per inch. Applies generating image method except Emf
TiffCompressionintGets or sets the type of compression to apply only when saving pages to the Tiff format. The value of the property is Ti
TiffColorDepthintGets or sets bit depth to apply only when saving pages to the Tiff format. The value of the property is ColorDepth integ
PrintingPageintIndicates which pages will not be printed. The value of the property is PrintingPageType integer constant.
QualityintGets or sets a value determining the quality of the generated images to apply only when saving pages to the Jpeg format.
IsCellAutoFitbooleanIndicates whether the width and height of the cells is automatically fitted by cell value. The default value is false. N
OnePagePerSheetbooleanIf OnePagePerSheet is true , all content of one sheet will output to only one page in result. The paper size of pagesetu
AllColumnsInOnePagePerSheetbooleanIf AllColumnsInOnePagePerSheet is true , all column content of one sheet will output to only one page in result. The wid
DrawObjectEventHandlerDrawObjectEventHandlerImplements this interface to get DrawObject and Bound when rendering.
ChartImageTypeImageFormatIndicate the chart imagetype when converting. default value: PNG. NOTE: This member is now obsolete. Instead, Chart and
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.
SvgCssPrefixString
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. The default value is false. That means the backgro
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. Default is fa
PageIndexintGets or sets the 0-based index of the first page to save. Default is 0.
PageCountintGets or sets the number of pages to save. Default is System.Int32.MaxValue which means all pages will be rendered.
IsOptimizedbooleanIndicates whether to optimize the output elements. Default value is false. Currently when this property is set to true,
DefaultFontStringWhen characters in the Excel are Unicode and not be set with correct font in cell style, They may appear as block in pdf
CheckWorkbookDefaultFontbooleanWhen characters in the Excel are Unicode and not be set with correct font in cell style, They may appear as block in pdf
OutputBlankPageWhenNothingToPrintbooleanIndicates whether to output a blank page when there is nothing to print. Default is false.
GridlineTypeintGets or sets gridline type. The value of the property is GridlineType integer constant. Default is Dotted type.
GridlineColorColor
TextCrossTypeintGets or sets displaying text type when the text width is larger than cell width. The value of the property is TextCrossT
DefaultEditLanguageintGets or sets default edit language. The value of the property is DefaultEditLanguage integer constant. It may display/re
SheetSetSheetSetGets or sets the sheets to render. Default is all visible sheets in the workbook: SheetSet.Visible . The set is ignored
EmfRenderSettingintSetting for rendering Emf metafile. The value of the property is EmfRenderSetting integer constant. EMF metafiles identi
CustomRenderSettingsCustomRenderSettings

Methods

NameDescription
getTiffPhotometricInterpretationGets the type of PhotometricInterpretation to apply only when saving pages to the Tiff format.

Has effect only when sav | | setTiffPhotometricInterpretation | Sets the type of PhotometricInterpretation to apply only when saving pages to the Tiff format.

Has effect only when sav | | setRenderingHint | Sets the value of a single preference for the rendering algorithms. Hint categories include controls for rendering quali | | setDesiredSize | Sets desired width and height of image.

NOTE: This member is now obsolete. Instead, please use setDesiredSize(int, int, |

SvgImageOptions()

SvgImageOptions.ImageType property

The value of the property is ImageType integer constant.

Type: int

SvgImageOptions.FitToViewPort property

Type: boolean

SvgImageOptions.CssPrefix property

Type: String

SvgImageOptions.EmbeddedFontType property

The value of the property is SvgEmbeddedFontType integer constant.

Type: int

SvgImageOptions.SaveFormat property

Gets or sets the output file format type Support Tiff/XPS The value of the property is SaveFormat integer constant. NOTE: This member is now obsolete. Instead, For Tiff/Svg, use ImageType ; For Xps, use Workbook.save(java.lang.String, com.aspose.cells.SaveOptions) with XpsSaveOptions . This property will be removed 12 months later since August 2022. Aspose apologizes for any inconvenience you may have experienced.

Type: int

SvgImageOptions.PrintWithStatusDialog property

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

Type: boolean

SvgImageOptions.HorizontalResolution property

Gets or sets the horizontal resolution for generated images, in dots per inch. Applies generating image method except Emf format images. The default value is 96.

Type: int

SvgImageOptions.VerticalResolution property

Gets or sets the vertical resolution for generated images, in dots per inch. Applies generating image method except Emf format image. The default value is 96.

Type: int

SvgImageOptions.TiffCompression property

Gets or sets the type of compression to apply only when saving pages to the Tiff format. The value of the property is TiffCompression integer constant. Has effect only when saving to TIFF. The default value is Lzw.

Type: int

SvgImageOptions.TiffColorDepth property

Gets or sets bit depth to apply only when saving pages to the Tiff format. The value of the property is ColorDepth integer constant. 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.

Type: int

SvgImageOptions.PrintingPage property

Indicates which pages will not be printed. The value of the property is PrintingPageType integer constant.

Type: int

SvgImageOptions.Quality property

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 Has effect only when saving to JPEG. The value must be between 0 and 100. The default value is 100.

Type: int

SvgImageOptions.IsCellAutoFit property

Indicates whether the width and height of the cells is automatically fitted by cell value. The default value is false. NOTE: This member is now obsolete. Instead, please use Worksheet.autoFitColumns(com.aspose.cells.AutoFitterOptions) and Worksheet.autoFitRows(com.aspose.cells.AutoFitterOptions) . This property will be removed 12 months later since August 2022. Aspose apologizes for any inconvenience you may have experienced.

Type: boolean

SvgImageOptions.OnePagePerSheet property

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.

Type: boolean

SvgImageOptions.AllColumnsInOnePagePerSheet property

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.

Type: boolean

SvgImageOptions.DrawObjectEventHandler property

Implements this interface to get DrawObject and Bound when rendering.

Type: DrawObjectEventHandler

SvgImageOptions.ChartImageType property

Indicate the chart imagetype when converting. default value: PNG. NOTE: This member is now obsolete. Instead, Chart and Shape are always rendered as vector elements(e.g. point, line) for rendering quality. This property will be removed 12 months later since June 2022. Aspose apologizes for any inconvenience you may have experienced.

Type: ImageFormat

SvgImageOptions.EmbededImageNameInSvg property

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

Type: String

SvgImageOptions.SVGFitToViewPort property

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

Type: boolean

SvgImageOptions.SvgCssPrefix property

Type: String

SvgImageOptions.OnlyArea property

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

Type: boolean

SvgImageOptions.Transparent property

Indicates if the background of generated image should be transparent. The default value is false. That means the background of the generated images is white.

Type: boolean

SvgImageOptions.WarningCallback property

Gets or sets warning callback.

Type: IWarningCallback

SvgImageOptions.PageSavingCallback property

Control/Indicate progress of page saving process.

Type: IPageSavingCallback

SvgImageOptions.IsFontSubstitutionCharGranularity property

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.

Type: boolean

SvgImageOptions.PageIndex property

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

Type: int

SvgImageOptions.PageCount property

Gets or sets the number of pages to save. Default is System.Int32.MaxValue which means all pages will be rendered.

Type: int

SvgImageOptions.IsOptimized property

Indicates whether to optimize the output elements. 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.

Type: boolean

SvgImageOptions.DefaultFont property

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.

Type: String

SvgImageOptions.CheckWorkbookDefaultFont property

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.

Type: boolean

SvgImageOptions.OutputBlankPageWhenNothingToPrint property

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

Type: boolean

SvgImageOptions.GridlineType property

Gets or sets gridline type. The value of the property is GridlineType integer constant. Default is Dotted type.

Type: int

SvgImageOptions.GridlineColor property

Type: Color

SvgImageOptions.TextCrossType property

Gets or sets displaying text type when the text width is larger than cell width. The value of the property is TextCrossType integer constant.

Type: int

SvgImageOptions.DefaultEditLanguage property

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 .

Type: int

SvgImageOptions.SheetSet property

Gets or sets the sheets to render. Default is all visible sheets in the workbook: SheetSet.Visible . The set is ignored when it is used in SheetRender

Type: SheetSet

SvgImageOptions.EmfRenderSetting property

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 image, otherwise only EMF records will be parsed. Default value is EmfRenderSetting.EMF_ONLY . For the frameworks that depend on .Net System.Drawing.Common, this setting is ignored.

Type: int

SvgImageOptions.CustomRenderSettings property

Type: CustomRenderSettings

getTiffPhotometricInterpretation()

Gets the type of PhotometricInterpretation to apply only when saving pages to the Tiff format.

Has effect only when saving to TIFF. The default value is -1, represent no PhotometricInterpretation is applied.

setTiffPhotometricInterpretation(value)

Sets the type of PhotometricInterpretation to apply only when saving pages to the Tiff format.

Has effect only when saving to TIFF. The default value is -1, represent no PhotometricInterpretation is applied.

setRenderingHint(key, value)

Sets the value of a single preference for the rendering algorithms. Hint categories include controls for rendering quality and overall time/quality trade-off in the rendering process. Refer to the RenderingHints class for definitions of some common keys and values.

ParameterTypeDescription
keyKeythe key of the hint to be set.
valueObjectthe value indicating preferences for the specified hint category.

setDesiredSize(desiredWidth, desiredHeight) (1 of 2)

Sets desired width and height of image.

NOTE: This member is now obsolete. Instead, please use setDesiredSize(int, int, boolean) by setting param keepAspectRatio to false. This property will be removed 12 months later since May 2023. Aspose apologizes for any inconvenience you may have experienced.

ParameterTypeDescription
desiredWidthintdesired width in pixels
desiredHeightintdesired height in pixels

setDesiredSize(desiredWidth, desiredHeight, keepAspectRatio) (2 of 2)

Sets desired width and height of image.

ParameterTypeDescription
desiredWidthintdesired width in pixels
desiredHeightintdesired height in pixels
keepAspectRatiobooleanwhether to keep aspect ratio of origin image