WP Import document
WP Import document ( filePath {; option} ) : Object
WP Import document ( fileObj {; option} ) : Object
| 引数 | 型 | 説明 | |
|---|---|---|---|
| filePath | Text | → | 4D Write ドキュメント(.4w7または.4wt)へのパス、または4D Write Pro ドキュメント(.4wp)へのパス、または.docx ドキュメント(.docx)へのパス |
| fileObj | 4D.File | → | 読み込むファイルオブジェクト |
| option | Integer, Object | → | (倍長整数) HTML 式の読み込みオプション (オブジェクト型) .docx ドキュメント用の読み込みオプション |
| 戻り値 | Object | ← | 4D Write Pro オブジェクト |
説明
WP Import document コマンドは、既存の4D Write Proドキュメント/4D Write ドキュメント(.4wp、.4w7 または .4wt)またはMS Word ドキュメント(.docx) を新規の4D Write Proオブジェクトへと変換します。
filePath あるいは fileObj のいずれかを渡すことができます:
-
filePath 引数の場合、ディスク上に保存されているドキュメントのパスを渡します。 filePath 引数の場合、ディスク上に保存されているドキュメントのパスを渡します。 ドキュメントが ストラクチャーファイルと同階層に置かれている場合を除き、完全なパスを渡す必要があります (同階層に置かれている場合にはファイル名のみを渡すことができます)。
-
fileObj 引数には、読み込むファイルを表す4D.File オブジェクトを渡します。
以下のドキュメントの種類がサポートされています:
- 旧式の4D Write ドキュメント(.4w7 あるいは .4wt)。 4D Write Pro オブジェクトでもサポートされる4D Write 機能の詳細な一覧については、4D Write ドキュメントの読み込み の章を参照して下さい。
- 4D Write Pro(.4wp)フォーマットドキュメント。 4D Write Proドキュメントフォーマットについてのより詳細な情報に関しては、.4wp ドキュメントフォーマット を参照して下さい。
- .docx フォーマットのドキュメント。 詳細な情報については、.docxフォーマットの読み込み/書き出し を参照してください。
注意: 4D BLOBフィールドに保存されたドキュメントを読み込みたい場合には、WP New コマンドの使用も検討してみて下さい。
filePath または fileObj 引数に渡したパスが無効な場合、またはファイルが見つからない場合、または指定したファイルがサポートされていないフォーマットだった場合、エラーが返されます。
オプションのoption 引数を使用すると以下のように読み込みオプションを定義することができます:
- 倍長整数
デフォルトで、旧式の4D Write ドキュメント内で使用されているHTML 式は読み込まれません(4D Write Pro ではサポートされません)。 wk import html expressions as text 定数を渡した場合、HTML 式は##htmlBegin## および ##htmlEnd## タグで囲まれた標準テキストとして読み込まれるため、そのあとに整形アクションが必要になります。 例:
##htmlBegin##Imported titlebold##htmlEnd##
- オブジェクト
以下のプロパティを持ったオブジェクトを渡すことで、読み込みオペレーション中に以下の属性がどのように扱われるかを定義することができます:
| 属性 | 型 | Description |
|---|---|---|
| anchoredTextAreas | Text | MS Word (.docx) ドキュメントのみ有効。 Word のアンカーされたテキストがどのように管理されるかを指定します。 取り得る値: anchored (デフォルト) - アンカーされたテキストエリアはテキストボックスとして扱われます。 inline - アンカーされたテキストはアンカーされた位置でインラインテキストとして扱われます。 ignore - アンカーされたテキストは無視されます。 注意: ドキュメント内のレイアウトとページ数が変化する可能性があります。 .docx フォーマットのファイルの読み込み方 も参照してください。 |
| anchoredImages | Text | MS Word (.docx) ドキュメントのみ有効。 アンカーされた画像がどのように管理されるかを指定します。 取り得る値: all (デフォルト) - アンカーされた画像は全てアンカーされた画像としてテキスト折り返しプロパティとともに読み込まれます(例外: .docx の折り返しオプション"tight"はwrap square として読み込まれます)。 ignoreWrap - アンカーされた画像は全て読み込まれますが、画像の周りにテキスト折り返しがある場合は無視されます。 ignore - アンカーされた画像は読み込まれません。 |
| sections | Text | MS Word (.docx) ドキュメントのみ有効。 セクションがどのように管理されるかを指定します。 取り得る値: all (デフォルト) - 全てのセクションが読み込まれます。 継続されたセクション、奇数/偶数セクションは全て標準のセクションへと変換されます。 ignore - セクションは全てデフォルトの4D Write Pro セクション(A4/縦向きレイアウト/ヘッダーやフッターはなし)へと変換されます。 注意: 継続されたセクションブレークを除く全てのセクションブレークはセクションブレークを伴う改ページへと変換されます。 継続されたセクションブレークは継続したセクションブレークとして読み込まれます。 |
| fields | Text | MS Word (.docx) ドキュメントのみ有効。 4D Write Pro フォーミュラに変換できない.docx フィールドがどのように管理されるかを指定します。 取り得る値: ignore - .docx フィールドは無視されます。 label - .docx フィールド参照は二重中括弧 ("{{ }}")がついたラベルとして読み込まれます。 例: "ClientName" フィールドは{{ClientName}} として読み込まれます。 value (default) - .docx フィールドの最後の計算された値が(あれば)読み込まれます。 注意: .docx フィールドが4D Write Pro 変数に対応している場合、フィールドはフォーミュラとして読み込まれ、このオプションは無視されます。 |
| borderRules | Text | MS Word (.docx) ドキュメントのみ有効。 段落の境界線がどのように管理されるかを指定します。 取り得る値: collapse - 段落フォーマットは自動折りたたみ境界線を真似するように変更されます。 折りたたみプロパティは読み込みオペレーションのときにしか適用されないと言う点に注意してください。 自動境界線折りたたみ設定のあるスタイルシートが読み込みオペレーションの後に再適用された場合、この設定は無視されます。 noCollapse (デフォルト) - 段落フォーマットは変更されません。 |
| preferredFontScriptType | Text | MS Word (.docx) ドキュメントのみ有効。 OOXML 内の単一フォントプロパティとして異なるタイプフェイスが定義されていた場合にどのタイプフェイスを使用するかを指定します。 取り得る値: latin (デフォルト) - ラテン文字 bidi - 双方向テキスト。 ドキュメントが双方向でleft-to-right(LTR)またはright-to-left(RTL)テキストの場合に適しています(例:アラビア文字やヘブライ文字)。 eastAsia - 東アジア文字。 ドキュメントが主にアジア系のテキストの場合に適しています。 |
| htmlExpressions | Text | 4D Write (.4w7) ドキュメントのみ有効。 HTML 式がどのように管理されるかを指定します。 取り得る値: rawText - HTML テキストは##htmlBegin## および ##htmlEnd## タグに挟まれた標準テキストとして読み込まれます。 ignore (デフォルト) - HTML 式は無視されます。 |
| importDisplayMode | Text | 4D Write (.4w7) ドキュメントのみ有効。 画像の表示がどのように管理されるかを指定します。 取り得る値: legacy - 画像の表示モードは、縮小して表示以外の場合には背景画像として変換されます。 noLegacy (デフォルト) - 4W7 画像の表示モードは縮小して表示以外の場合にはimageDisplayMode 属性に変換されます。 |
互換性に関する注意
- 旧式の4D Write ドキュメント内で使用される文字スタイルシートは独自の機構が使用されており、これは4D Write Pro ではサポートされていないものです。 インポートされたテキストを可能な限り再現するため、スタイルシート属性は"ハードコード"スタイル属性へと変換されています。 旧式の文字スタイルシートは読み込まれず、今後ドキュメント内では参照されることはありません。
- .docx フォーマットからの読み込みのサポートはMicrosoft Word 2010 以降でのみ正式対応しています。 それ以前のバージョン、具体的にはMicrosoft Word 2007 などでは、正しく読み込まれない可能性があります。
例題 1
var WPDoc : Object
WPDoc:=WP Import document("C:\\documents\\4DWriteDocs\\Letter.4w7")
例題 2
.docx ドキュメントを読み込み、段落境界線がMS Word のように折りたたまれていてほしい場合を考えます:
$options:=New object
$options.borderRules:="collapse" //変換時に段落境界線を折りたたむ
wpDoc:=WP Import document(«mydoc.docx»;$options)
オリジナルの.docx フィールドをテキストとして読み込みたい場合を考えます(4D フォーミュラに変換できないフィールドの場合):
$options:=New object
$options.fields:="label" // 変換されていないフィールドは、{{ と }} に挟まれたテキストとして読み込まれます。
wpDoc:=WP Import document(«mydoc.docx»;$options)
テキストが主に日本語である.docx ドキュメントを読み込みたい場合を考えます:
$options:=New object
$options.preferredFontScriptType:="eastAsia" //強制的に東アジアフォント文字に適した変換をします
wpDoc:=WP Import document(«mydoc.docx»;$options)
例題 3
ディスク上のファイルを、ファイルオブジェクトを使用して読み込みたい場合を考えます:
var $file : 4D.File
$file:=File("/RESOURCES/myFile.4wp")
WParea:=WP Import document($file)