ここは旧式の4DドキュメントWebサイトです。最新のアップデートされたドキュメントを読むには新サイトをご利用下さい→ developer.4d.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v20
WP EXPORT VARIABLE
|
WP EXPORT VARIABLE ( wpDoc ; destination ; format {; option} ) | ||||||||
引数 | 型 | 説明 | ||||||
wpDoc | オブジェクト |
![]() |
4D Write Pro変数 | |||||
destination | テキスト変数, BLOB変数 |
![]() |
書き出したコンテンツを受け取る変数 | |||||
format | 倍長整数 |
![]() |
変数出力フォーマット | |||||
option | オブジェクト, 倍長整数 |
![]() |
書き出しオプション | |||||
WP EXPORT VARIABLE コマンドはwpDoc 変数内の4D Write Proオブジェクトをformat 引数で指定したフォーマットでdestination 引数で指定した4D変数へと書き出します。
wpDoc 引数には、書き出したい4D Write Proオブジェクトを渡します。
destination 引数には、書き出された4D Write Pro オブジェクトを受け取る変数を渡します。必要な変数の型は、format 引数で指定した書き出しフォーマットに応じて変化します:
format 引数には、4D Write Pro テーマから、使用する書き出しフォーマットを設定する定数を渡します。それぞれのフォーマットは特定の用法と関連しています。サポートされているフォーマットは以下の通りです:
定数 | 型 | 値 | コメント |
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 mime html | 倍長整数 | 1 | 4D Write Proドキュメントは標準のMIME HTMLとして保存され、htmlドキュメントと画像はMIMEパーツとして埋め込まれます(base64でエンコードされます)。式は計算され4D特有のタグは除去されます。このフォーマットは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 html 4D | 倍長整数 | 3 | 4D Write ProドキュメントはHTMLとして保存され、4D独自のタグを含みます。それぞれの式はノンブレークのスペースとして挿入されます。このフォーマットはロスレスであるため、テキストフィールドへの保存目的に適しています。 |
注:
option 引数には、書き出されるドキュメントのプロパティを定義する値を格納しているオブジェクト 型の引数を渡します。以下のプロパティが利用可能です:
定数 | 値 | コメント |
wk CID host domain name | cidHostDomain | CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。wk mime html フォーマットが使用されている際にのみ使用可能です。 |
wk embedded pictures | embeddedPictures | SVG 書き出し専用。WP EXPORT DOCUMENT を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。取り得る値:
|
wk google fonts tag | googleFontsTag | SVG書き出し専用。書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。取り得る値:
注: このプロパティはデフォルトではFalse に設定されています。一般的にはネイティブのフォントはブラウザ上で綺麗にレンダリングされますが、読み込まれたGoogle フォントはネイティブのフォントを上書きするからです。例えば、macOS で”Helvetica” を上書きするのはあまり良いアイデアではありません。これはmacOS ネイティブのフォントだからです。 |
wk HTML pretty print | htmlPrettyPrint | HTML コードは読みやすいようにフォーマットされます。 |
wk max picture DPI | maxPictureDPI | 画像を適切な解像度にリサンプリング(縮小)するのに使用されます。Windows でのSVG 画像に対しては。ラスタライズに使用されます。 デフォルト値:
取り得る最大値: 1440 |
wk optimized for | optimizedFor | 書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。 取り得る値:
|
wk page index | pageIndex | SVG 書き出し専用。SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 注: ページインデックスはページナンバリングとは異なるものです。 |
wk recompute formulas | recomputeFormulas | 書き出し時にフォーミュラを再計算するかどうかを定義します。取り得る値:
|
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 | ![]() | - | ![]() | ![]() | ![]() | ![]() |
wk max picture DPI | - | 常に300 | ![]() | ![]() | - | ![]() |
wk optimized for | - | 常に wk print | ![]() | 常に wk print | - | ![]() |
wk recompute formulas | - | ![]() | ![]() | ![]() | - | ![]() |
wk visible background and anchored elements | - | ![]() | 常に true | ![]() | - | ![]() |
wk visible footers | - | 常に true | 常に false | ![]() | - | ![]() |
wk visible headers | - | 常に true | 常に false | ![]() | - | ![]() |
wk visible empty images | - | ![]() | ![]() | ![]() | - | ![]() |
wk visible references | - | - | - | ![]() | - | ![]() |
wk page index | - | - | - | - | - | ![]() |
wk embedded pictures | - | - | - | - | - | ![]() |
wk google fonts tag | - | - | - | - | - | ![]() |
互換性に関する注意: option 引数に倍長整数 型の値を渡すことは互換性の理由からサポートされていますが、オブジェクト 型の引数を渡すことが推奨されています。
myArea 4D Write Pro オブジェクトのコンテンツをMIME 形式で書き出し、ホストドメインとして"gmail.com" を追加したい場合を考えます:
var $option;$export : Objet
$option[wk CID host domain name]:="gmail.com"
WP EXPORT VARIABLE(myArea;$export;wk mime html;$option)
スタイル付テキストと4D参照と画像を含んだEメールを送信したい場合を考えます。この場合、MIME HTMLフォーマットで書き出された4D Write Proエリアを、SMTP を使用して送信することができます:
// transporter オブジェクトを作成
$server:=New object
$server.host:="smtp.gmail.com"
$server.port:=465
$server.user:="4D@gmail.com"
$server.password:="XXXX"
$transporter:=SMTP New transporter($server)
WP EXPORT VARIABLE(WParea;$mime;wk mime html)
$mailTmp:=MAIL Convert from MIME($mime)
// ピクチャーを追加(あれば)
If($mailTmp.attachments#Null)
$email.attachments:=$mailTmp.attachments
End if
$email.bodyStructure:=$mailTmp.bodyStructure
$email.bodyValues:=$mailTmp.bodyValues
$status:=$transporter.send($email)
If(Not($status.success))
ALERT("An error occurred: "+$status.statusText)
End if
4D Wrie Pro の最初のページをSVG で、ヘッダーを隠してテキスト変数に書き出す場合を考えます:
var $options : Object
var $destination : Text
$options:=New object
$options[wk optimized for]:=wk screen
$options[wk visible headers]:=False
WP EXPORT VARIABLE(WPArea;$destination;wk svg;$options)
.docxフォーマットの読み込み/書き出し
HTML およびMIME HTML フォーマットへの書き出し
WP EXPORT DOCUMENT
プロダクト: 4D
テーマ: 4D Write Proランゲージ
番号:
1319
初出: 4D v14 R5
変更: 4D v15 R2
変更: 4D v17 R4
変更: 4D v19 R3
変更: 4D v20
4D Write Proリファレンス ( 4D v20)