WP EXPORT DOCUMENT

4D v18

WP EXPORT DOCUMENT


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

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

説明

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

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

filePath 引数には、書き出し先の場所と、書き出したドキュメント名を渡します。ドキュメント名のみを渡した場合、4Dストラクチャーファイルと同階層に保存されます。デフォルトで、format 引数を省略した場合、コマンドはドキュメントの拡張子を見て書き出しのフォーマットを選択します。

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 web page complete	倍長整数	2	.htm または .html 拡張子。このドキュメントは標準HTMLとして保存され、そのリソースは別に保存されます。4Dタグは除去され、式は値が計算されます。このフォーマットは特に4D Write Pro ドキュメントWeb ブラウザで表示したい場合に特に適しています。

注:

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

options 引数には、書き出しの設定を指定するオプションを渡します。倍長整数の値を渡す事で、HTMLコードのスタイルを定義することができます。使用できる定数は以下の通りです:

定数	型	値	コメント
wk html debug	倍長整数	1	フォーマット済みのHTMLコード("整形済みフォーマット")。デバッグが容易。
wk normal	倍長整数	0	標準のHTML コード

HTML デバッグオプションなし(デフォルト):

HTML デバッグオプションあり:

例題 1

myArea という4D Write Proオブジェクトの中身をデータベースフォルダー内のドキュメントへと書き出したい場合を考えます。'pprint'ボタンを使用してデバッグオプションを設定することができます:

 C_TEXT($filePath)

 $filePath:=Get 4D folder(Database folder)+"Exported files"+Folder separator+"WriteProExport.html"

 If(pprint=0) //デバッグオプションがoffの場合

    WP EXPORT DOCUMENT(myArea;$filePath;wk web page complete;wk normal)

 Else

    WP EXPORT DOCUMENT(myArea;$filePath;wk web page complete;wk html debug)

 End if

例題 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;wk normal)

       Else

          ALERT("An error occurred.")

       End if

 End case

参照

.docxフォーマットへの書き出し
 WP EXPORT VARIABLE