←Select platform

SetSvg Method

Summary

Replaces the SVG document for this page.

Syntax

C#
VB
Java
C++
Public Sub SetSvg( 
   ByVal svg As SvgDocument, 
   ByVal options As CodecsLoadSvgOptions 
) 
public:  
   void SetSvg( 
      SvgDocument^ svg, 
      CodecsLoadSvgOptions^ options 
   ) 
public void setSvg(SvgDocument svg, CodecsLoadSvgOptions options) 

Parameters

svg

New SVG document to use for this page. This value can be null.

options

Options to use when caching this SVG document. It can be used to drop images, text or shapes before the document is saved

if they are not needed. If this value can is null, then the SVG document is saved as is without modifications.

Remarks

GetSvg is used to get an SVG document representation of this page. Not all document types support this method, this depends on the value of DocumentImages.IsSvgSupported.

SetSvg is used to replace the SVG document of the page. IsSvgModified is used to as flag that indicates that the SVG document of this page has been replaced by the user.

This method works as follows (the "item" is the SVG document passed by the user):

  1. If this document does not support SVG (the value of DocumentImages.IsSvgSupported is false), then an exception will be thrown.

  2. This method requires that the owner document uses a cache system (Document.HasCache is true), otherwise; an exception will be thrown.

  3. If the value of the IsReadOnly property of Document is true, then the user cannot modify this document and an exception will be thrown.

  4. SVG documents with the same options previously saved for this page are purged from the cache.

  5. svg is added to the cache by serializing the SvgDocument object. The original object is not disposed and is still owned by the user. If svg is null, then a "null" item is added to the cache.

GetSvg will check the cache first, hence, subsequent calls will return the value set by this method.

The value of IsSvgModified will be set to true after this method returns.

Refer to Loading Using LEADTOOLS Documents Library for more information.

Requirements

Target Platforms

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Documents Assembly