LEADTOOLS Leadtools.Documents(Leadtools.Documentsアセンブリ)

フレームを表示

GetSvgメソッド






SVGドキュメント作成時に使うオプション。必要でないならば、返されたドキュメントからイメージ、テキストまたはシェイプをドロップするのに用いられることができます。この値がnullである場合、SVGドキュメントは修正せずそのまま返されます。
指定されたオプションによるSVGドキュメントとして、このページを取得します。
構文
'Declaration
 
Public Function GetSvg( _
   ByVal options As CodecsLoadSvgOptions _
) As SvgDocument
'Usage
 
Dim instance As DocumentPage
Dim options As CodecsLoadSvgOptions
Dim value As SvgDocument
 
value = instance.GetSvg(options)
public SvgDocument getSvg(CodecsLoadSvgOptions options)
            

パラメーター

オプション
SVGドキュメント作成時に使うオプション。必要でないならば、返されたドキュメントからイメージ、テキストまたはシェイプをドロップするのに用いられることができます。この値がnullである場合、SVGドキュメントは修正せずそのまま返されます。

戻り値

見つかった場合はこのページのSVGドキュメント、またはnull。
解説

GetSvgは、このページのSVGドキュメント表現を取得するのに用いられます。すべてのドキュメントタイプがこのメソッドをサポートするというわけではありません、これはDocumentImages.IsSvgSupportedの値に依存します。

SetSvgは、ページのSVGドキュメントを置換するのに用いられます。IsSvgModifiedは、ユーザーがこのページのSVGドキュメントを置換したことを示すフラグとして使われます。

オプションパラメーターは、SVGドキュメントがどのように生成されるかについて制御します。最も一般的な使用法は、大きな埋め込みデータを格納している可能性のある画像要素なしでのSVGのロードです。このデータはbase64符号化され、SVGデータのメモリサイズが大きくなります。これのための1つの回避方法は、オプションDropImagesを使うことです。生成されるSVGドキュメントにはテキストとベクトルシェイプのみが含まれ、メモリのフットプリントは小さくなります。その後、GetSvgBackImageは、別にドロップされた画像要素を格納するラスター画像を返すために呼び出されることができます。

このメソッドは以下のように機能します(「項目」は、指定されたオプションによるSVGドキュメントです):

  1. このドキュメントがSVG(DocumentImages.IsSvgSupportedの値はfalseです)をサポートしないならば、このメソッドはnullを返します。

  2. 項目がキャッシュで見つけられるならば、それはすぐに返されます。ドキュメントがキャッシュシステムを用いて作成されるならば、これは利用できます。そして、Document.CacheOptionsDocumentCacheOptions.PageSvgを格納します。

  3. これがソース文書ファイル(OriginalPageNumberの値は-1でありません)のオリジナルページであるならば、RasterCodecsRasterCodecs.LoadSvgを用いてオリジナルページからSvgDocumentオブジェクトをロードするのに用いられます。

  4. これがソース文書ファイル(OriginalPageNumberの値は1でありません)のオリジナルページでないならば、新しいSvgDocumentオブジェクトはDocumentImagesでページサイズと解像度とデフォルト値に基づいて作成されます。

  5. このドキュメントがキャッシュシステム(Document.HasCachetrueです)を使うならば、それが返される前に、SvgDocumentオブジェクトはキャッシュに保存されます。次にこのメソッドが呼び出される時に、SVGはファイルからそれをロードするか、新しいインスタンスを作成することなく直接キャッシュから返されます。

SetSvgが以前にsvgパラメーターのために無効なオブジェクトで呼び出されていた場合、このメソッドもnullを返すのでご注意ください。

全ての場合において、返されたSvgDocumentオブジェクトはこのドキュメントにより用いられません、それが使われたあと、ユーザーはSvgDocument.Disposeを用いてそれを削除する役割を果たします。

ImageScaleの値が1より大きければ、生成されるSVGドキュメントのサイズはサイズ/ImageScaleに等しくなります。

LEADTOOLSドキュメントビューワは、ビューモードが「SVG」であるとき、このメソッドを使用してそのページ用にSVGドキュメントを取得します。

LEADTOOLSドキュメントコンバータは、OCRを使用することなく変換するとき、ページのためにSVGドキュメントを得るために、このメソッドを使います。

詳細については、「LEADTOOLSドキュメントライブラリを使用したロード」を参照してください。

サンプル

サンプルのために、参照しますDocumentPage

必要条件

ターゲットプラットホーム

参照

参照

DocumentPageクラス
DocumentPageメンバ

   Leadtools.Documentsは、DocumentまたはMedicalツールキットのライセンスと、解除キーが必要です。詳細は、以下を参照してください。LEADTOOLSツールキット機能