VP Convert to picture
VP Convert to picture ( vpObject : Object {; rangeObj : Object} ) : Picture
| 引数 | 型 | 説明 | |
|---|---|---|---|
| vpObject | Object | -> | 変換するエリアを格納した 4D View Pro オブジェクト |
| rangeObj | Object | -> | レンジオブジェクト |
| 戻り値 | Picture | <- | エリアの SVGピクチャー |
説明
VP Convert to picture コマンドは、vpObject 引数で指定した 4D View Pro オブジェクト (あるいは vpObject 内にある、rangeObj 引数で指定したレンジ) を、SVGピクチャーに変換します。
このコマンドは以下のような場合に有用です:
- 4D View Pro ドキュメントを 4D Write Pro ドキュメントなど、他のドキュメントに埋め込みたい場合
- 4D View Pro ドキュメントを、4D View Pro エリアに読み込まずに印刷したい場合
vpObject 引数には、変換したい 4D View Pro オブジェクトを渡します。このオブジェクトは事前に VP Export to object コマンドで解析するか、または VP EXPORT DOCUMENT コマンドにより保存してある必要があります。
4D View Pro エリアに含まれている式や書式 (セルフォーマット 参照) が正常に書き出されるよう、少なくともそれらが一度は評価されていることが SVG変換プロセスには必要です。事前に評価されていないドキュメントを変換した場合、式や書式が予期せぬ形にレンダリングされている可能性があります。
rangeObj には、変換するセルのレンジを渡します。この引数が省略された場合のデフォルトでは、ドキュメントのコンテンツ全体が変換されます。
書式 (上の注記参照)、ヘッダーの表示状態、カラムと行などを含めた表示属性に準じて、ドキュメントコンテンツは変換されます。以下の要素の変換がサポートされます:
- テキスト: スタイル / フォント / サイズ / 文字揃え / 向き / 回転 / 書式
- セルの背景: カラー / 画像
- セルの罫線: 太さ / カラー / スタイル
- セルの結合
- ピクチャー
- 行高さ
- カラム幅
- 非表示のカラム / 行 > 枠線の表示状態は VP SET PRINT INFO で定義されたドキュメント属性に依存します。
枠線の表示状態は VP SET PRINT INFO で定義されたドキュメント属性に依存します。
戻り値
コマンドは SVGフォーマットのピクチャーを返します。
例題
4D View Pro エリアを SVG に変換し、結果をプレビューするためピクチャー変数に戻り値を代入します:
var $vpAreaObj : Object
var $vPict : Picture
$vpAreaObj:=VP Export to object("ViewProArea")
$vPict:=VP Convert to picture($vpAreaObj) //エリア全体を書き出します