WP EXPORT DOCUMENT

4D v20

WP EXPORT DOCUMENT


WP EXPORT DOCUMENT ( wpDoc ; filePath {; format {; option}} )

引数	型	説明
wpDoc	オブジェクト	4D Write Pro 変数
filePath	文字	書き出されたファイルへのパス
format	倍長整数	ドキュメントの出力フォーマット
option	オブジェクト, 倍長整数	書き出しオプション

説明

WP EXPORT DOCUMENT コマンドはwpDoc 引数に渡したディスク上の4D Write Proオブジェクトを、filePath 引数で指定した場所に、他の任意の引数に基づいて書き出します。

wpDoc 引数には、書き出したい4D Write Proオブジェクトを渡します。

filePath 引数には、書き出し先の場所と、書き出したドキュメント名を渡します。ドキュメント名のみを渡した場合、4Dストラクチャーファイルと同階層に保存されます。

format 引数は省略することができますが、その場合はfilePath 引数で拡張子を指定する必要があります。またformat 引数には4D Write Pro テーマの定数を渡すこともできます。この場合、4D は必要に応じて適切な拡張子を追加します。以下のフォーマットがサポートされています。:

定数	値	コメント
wk 4wp	4	4D Write Proドキュメントは、ネイティブなアーカイブフォーマット(zipになったHTMLと、別のフォルダに保存された画像)にて保存されています。4D特有のタグも含まれ、4D式は計算はされていません。このフォーマットは、特に4D Write Proドキュメントをディスク上に損失なく保存してアーカイブする事に適しています。
wk docx	7	.docx 拡張子を意味します。4D Write Pro ドキュメントはMicrosoft Word フォーマットで保存されます。Microsoft Word 2016 以降に正式に対応していますが、.docx フォーマットをサポートするバージョン(例: Microsoft Word 2007など)であればどれであっても互換性はあります。書き出しに対応しているドキュメントの部分は以下の通りです: 本文 / ヘッダー / フッター / セクションページ / 印刷設定 (余白、背景色 / 背景画像、境界線、パディング、用紙サイズ / 用紙の向き) 画像 - インライン、アンカー、背景画像パターン(wk background image で定義されているもの) 互換性のある変数と式(ページ番号、ページ数、日付、時間、メタデータ)。互換性のない変数と式は評価されて、書き出しの前に値が固定化されます。ブックマーク一部の4D Write Pro 設定はMicrosoft Word では利用できないか、振る舞いが異なる可能性があることに注意してください。
wk mime html	1	4D Write Proドキュメントは標準のMIME HTMLとして保存され、htmlドキュメントと画像はMIMEパーツとして埋め込まれます(base64でエンコードされます)。式は計算され4D特有のタグは除去されます。埋め込みビューにアンカーされたテキストボックスのみが(divとして)書き出されます。このフォーマットはSMTP_QuickSend コマンドを使用してHTML Eメールを送信するのに特に適しています。
wk pdf	5	.pdf 拡張子。4D Write Pro ドキュメントはページニューモードに基づいてPDF フォーマットで保存されています。 PDF ドキュメントには以下のメタ情報が書き出されています: タイトル作者サブタイトルコンテンツ作成者注: 式は、ドキュメントが書き出されるときに自動的に値が計算されて固定化されます。メソッドへのリンクはサポートされていません。
wk svg	8	4D Write Pro ドキュメントのページはページビューモードに基づいてSVG フォマットで保存されます。注: SVG へと書き出す際は、一度に1ページしか書き出すことができません。書き出すページを指定するにwk page index はを使用して下さい。
wk web page complete	2	.htm または .html 拡張子。このドキュメントは標準HTMLとして保存され、そのリソースは別に保存されます。4Dタグは除去され、式は値が計算されます。埋め込みビューにアンカーされたテキストボックスのみが(divとして)書き出されます。このフォーマットは特に4D Write Pro ドキュメントWeb ブラウザで表示したい場合に特に適しています。

注:

"4D 特有のタグ"とは、4Dネームスペースと4D CSSスタイルを含めた4D XHTMLのことです。
4D Write Proフォーマットに関するより詳細な情報については、.4wp ドキュメントフォーマットを参照して下さい。
.docx フォーマットを使用する際の、既に知られている差異や変換されない設定の一覧については、.docxフォーマットの読み込み/書き出しを参照して下さい。
SVG フォーマットへの書き出しついてのより詳細な情報については、SVGフォーマットへの書き出しを参照して下さい。

option 引数

option 引数には、書き出されるドキュメントのプロパティを定義する値を格納しているオブジェクト型の引数を渡します。以下のプロパティが利用可能です:

定数	値	コメント
wk embedded pictures	embeddedPictures	SVG 書き出し専用。WP EXPORT DOCUMENT を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。取り得る値: true (デフォルト): ピクチャーは書き出された.svg ファイルに埋め込まれます。 false: ピクチャーは書き出された.svg ファイルと同じ階層にある"filename_images" というフォルダ内に書き出されます。この"filename" はファイル用にコマンドに渡された名前の拡張子を抜いたものです。ピクチャーは埋め込まれませんが、.svg ファイルから参照されます。以下の点に注意して下さい: フォルダが既に存在する場合、ファイルが書き出される前に中身が消去されます書き出されたページに画像が何もない場合、フォルダが削除されます
wk google fonts tag	googleFontsTag	SVG書き出し専用。書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。取り得る値: false (デフォルト): Google フォントの読み込みルールは何も追加されません true: 書き出されたファイルに@import ルールを追加します。Windows またはmacOS において利用できないフォントを使用したい場合に有用です。注: このプロパティはデフォルトではFalse に設定されています。一般的にはネイティブのフォントはブラウザ上で綺麗にレンダリングされますが、読み込まれたGoogle フォントはネイティブのフォントを上書きするからです。例えば、macOS で”Helvetica” を上書きするのはあまり良いアイデアではありません。これはmacOS ネイティブのフォントだからです。
wk HTML pretty print	htmlPrettyPrint	HTML コードは読みやすいようにフォーマットされます。
wk max picture DPI	maxPictureDPI	画像を適切な解像度にリサンプリング(縮小)するのに使用されます。Windows でのSVG 画像に対しては。ラスタライズに使用されます。デフォルト値: 300 (wk optimized for = wk print 時) 192 (wk optimized for = wk screen 時) 取り得る最大値: 1440
wk optimized for	optimizedFor	書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。取り得る値: wk print (wk pdf のデフォルト値) ビットマップピクチャーは、wk max picture DPI で定義されたDPI あるいは300 (デフォルト値)を使用してダウンスケールされ、書き出しタイプとしてコーデックがサポートされない場合にはPNGに変換されます。ベクターピクチャーはwk max picture DPI で定義されたDPI または300 (Windows のみ)を使用してPNG へと変換されます。ピクチャーに複数のフォーマットが格納されている場合、印刷に最適なフォーマットが使用されます(例: .jpg の代わりに .tiff など) wk screen (wk web page complete および wk mime html のデフォルト値) ビットマップピクチャーは、wk max picture DPI で定義されたDPI あるいは192 (デフォルト値)を使用してダウンスケールされ、書き出しタイプとしてコーデックがサポートされない場合にはJPEG (不透明タイプ)またはPNG(透過画像)に変換されます。ベクターピクチャーはwk max picture DPI で定義されたDPI または192 (Windows のみ)を使用してPNG へと変換されます。ピクチャーに複数のフォーマットが格納されている場合、スクリーン用のフォーマットが使用されます。
wk page index	pageIndex	SVG 書き出し専用。SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。注: ページインデックスはページナンバリングとは異なるものです。
wk recompute formulas	recomputeFormulas	書き出し時にフォーミュラを再計算するかどうかを定義します。取り得る値: true - デフォルト値。全てのフォーミュラは再計算されます。 false- フォーミュラを再計算しません。
wk visible background and anchored elements	visibleBackground	背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。取り得る値: True/False
wk visible empty images	visibleEmptyImages	読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。取り得る値: True/False 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。
wk visible footers	visibleFooters	フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible headers	visibleHeaders	ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible references	visibleReferences	ドキュメントに挿入されている4D 式を参照として表示または書き出しします。取りうる値: True/False

以下の表はformat 引数の各フォーマットごとに利用可能なoption 引数のオプションをあらわしています:

	wk 4wp	wk docx	wk mime html	wk pdf	wk web page html 4D	wk svg
wk CID host domain name	-	-		-	-	-
wk HTML pretty print	(デフォルト: false)	-	(デフォルト: False)	(デフォルト: False)	(デフォルト: False)	(デフォルト: false)
wk max picture DPI	-	常に300		(デフォルト: 300)	-	(デフォルト: 300)
wk optimized for	-	常に wk print	(デフォルト: wk screen)	常に wk print	-	(デフォルト: wk print)
wk recompute formulas	-	(デフォルト: true)	(デフォルト: true)	(デフォルト: true)	-	(デフォルト: true)
wk visible background and anchored elements	-	(デフォルト: true)	常に true	(デフォルト: true)	-	(デフォルト: true)
wk visible footers	-	常に true	常に false	(デフォルト: true)	-	(デフォルト: true)
wk visible headers	-	常に true	常に false	(デフォルト: true)	-	(デフォルト: true)
wk visible empty images	-	(デフォルト: true)	(デフォルト: true)	(デフォルト: true)	-	(デフォルト: true)
wk visible references	-	-	-	(デフォルト: false)	-	(デフォルト: false)
wk page index	-	-	-	-	-	(デフォルト: 1)
wk embedded pictures	-	-	-	-	-	(デフォルト: true)
wk google fonts tag	-	-	-	-	-	(デフォルト: false)

互換性に関する注意: option 引数に倍長整数 型の値を渡すことは互換性の理由からサポートされていますが、オブジェクト型の引数を渡すことが推奨されています。

例題 1

myArea 4D Write Pro オブジェクトのコンテンツをHTML 形式とPDF フォーマットの両方に書き出したい場合を考えます:

  // HTML 形式に書き出し

 var $option : Object

 $option:=New object

 

 $option[wk recompute formulas]:=False

 $option[wk HTML pretty print]:=False

 $option[wk optimized for]:=wk print

 $option[wk max picture DPI]:=600 //印刷用のデフォルト値(300 DPI)を上書き

 

 WP EXPORT DOCUMENT(myArea;$path;wk web page complete;$option)

 

  // PDF フォーマットで書き出し

 var $option : Object

 $option:=New object

 

 $option[wk visible headers]:=True

 $option[wk visible footers]:=True

 $option[wk visible background]:=True

 $option[wk max picture DPI]:=96 //スクリーン用のデフォルト値(192 DPI) を上書きしてドキュメントのサイズを制限

 $option[wk optimized for]:=wk screen

 $option[wk recompute formulas]:=True

 

 WP EXPORT DOCUMENT(myArea;$path;wk pdf;$option)

例題 2

myArea 4D Write Proオブジェクト内のコンテンツを、.4wpフォーマットで書き出したい場合を考えます:

 C_TEXT($path)

 C_LONGINT($docRef)

 

 Case of

    :(Form event code=On Clicked)

 

       $path:=Get 4D folder(Database folder)+"Export"+Folder separator

       $path:=Select document($path;".4wp";" title";File name entry)

 

       If($path#"")

          WP EXPORT DOCUMENT(myArea;document;wk 4wp)

       End if

 End case

例題 3

ドキュメントの2ページ目をSVG として書き出し、ドキュメントからピクチャーを書き出したい場合を考えます:

 var $options : Object

 

 $options:=New object

 $options[wk embedded pictures]:=False

 $options[wk page index]:=2

 

 WP EXPORT DOCUMENT(WPArea;"my exported document";wk svg;$options)

参照

.docxフォーマットの読み込み/書き出し
 HTML およびMIME HTML フォーマットへの書き出し
 WP EXPORT VARIABLE