ピクチャーは4D Write Pro ドキュメントあるいはドキュメント要素(テーブル、段落、セクション、ヘッダー/フッター等)の、背景画像として設定することが可能です。

以下の図は、ピクチャーをドキュメントの背景として使用する二つの異なる方法を示したものです:

背景画像はプログラミングによって、あるいはコンテキストメニューによって設定することが可能です。詳細な情報については、4D Write Pro エリアを使用する の記事内の背景 の章を参照してください。

背景画像の表示はプログラムによって、またはコンテキストメニューによって設定することができます。背景表示モードの値は以下の定数の詳細に記されているように背景設定のプリセットを定義するという点に注意してください:

4D Write Pro ドキュメントへのピクチャーの追加は、必要に応じて複数の方法で行うことができます:

• 背景画像を追加するためには、WP SET ATTRIBUTES コマンドとwk background image 属性あるいは wk background image url 属性を使用します。
• インライン画像(文字のようにテキストフローに挿入された画像)を追加するためには、WP INSERT PICTURE あるいは ST INSERT EXPRESSION コマンドを使用します。
• アンカー画像をページ内(テキストの後ろあるいは前面)に追加するためには、WP Add picture コマンドを使用します。

ピクチャーの追加方法によって画像が位置するレイヤーが決定されます。以下の図を参照してください:

アンカーされたピクチャーは絶対位置で、テキストの前あるいは後ろに追加されます。また、ページあるいはドキュメントの特定のパーツ(ヘッダー、フッター、セクションなど)にアンカーすることもできます。ピクチャーに絶対位置を設定するためには、WP Add picture and WP SET ATTRIBUTES コマンドを使用します。

アンカーされた画像の位置は以下の特定の属性あるいは標準アクションを使用することで変更可能です:

アンカーされたピクチャーは、左側/右側/大きい側/上と下またはwk anchor layout プロパティまたはanchorLayout 標準アクションを通して提供されるオプションでドキュメントにアンカーされた場合、自動テキスト折り返しをサポートします。詳細については こちらのblog記事 を参照してください。

テキスト折り返しが設定されているピクチャーがページの本文に対してアンカーされている場合、それらはヘッダーまたはフッターには影響しません(ピクチャーはヘッダーまたはフッターの前面に表示されます)。その反対に、ヘッダーまたはフッターにアンカーされたピクチャーは、ページの本文と重なった場合にはそちらに影響します。

注意: テキスト折り返しが設定されているピクチャーをヘッダーまたはフッターにアンカーしたい場合、ピクチャーの横方向揃えを上揃えに設定する必要があります。

アンカーされたピクチャーは全てページビューモードでのみ表示されます。以下の場合には表示されません:

• ピクチャーが非表示のヘッダーあるいはフッターにアンカーされている
• ビューモードが下書きモードである
• 中央揃えになっているかセクションにアンカーされている状態で、HTML WYSIWYGで表示オプションがチェックされている
• "背景を表示"オプションが選択されていない

4D Write Pro エリア内には、ピクチャーを返す4D 式を挿入することも可能です。式には変数、フィールド、プロジェクトメソッド(*)、オブジェクト属性あるいはコレクション要素を使用することができます。

ピクチャーtipでは、式の参照を見ることができます(*):

(*)アンカーされたがずには割り当てられたテキストは何もないため、その式参照は表示されません。

全ての画像属性はピクチャー式に適用することができます(wk imageおよび  wk image url 属性は読出し専用です)。しかしながら、ピクチャーには特有の属性があるため、4D Write Pro はそその式の結果がピクチャーであると判定し、それをピクチャー式として扱うために、少なくとも一度は式を評価する必要がある点に注意してください。これはつまりWP INSERT FORMULA を使用してピクチャー式を挿入した場合、どのピクチャー属性を設定するよりも前にWP COMPUTE FORMULAS を呼び出す必要があるということです。

注: 他の式同様、ピクチャー式はWP INSERT FORMULA および WP COMPUTE FORMULAS コマンドの影響を受けます。

アンカーされたピクチャー式は、WP Add picture コマンド(第2引数なし)によって追加され、その後にWP SET ATTRIBUTES コマンドをwk image formula セレクターつきで呼び出します。

例:

また、既存のアンカーされたピクチャーにWP SET ATTRIBUTES コマンドとwk image formula を合わせて使用することでピクチャー式を挿入することもできます。

互換性に関する注意: テキストを通してピクチャー式を定義するためには、wk image expression 定数は引き続き使用することができます。しかしながら、今後はwk image formula とオブジェクトを使用する方法が推奨されます。

WP RESET ATTRIBUTES コマンドをwk image formula と呼び出すことは、式が画像属性から消去されるという点において、WP FREEZE FORMULAS を(ドキュメント全体に)呼び出すことに似ています。しかしながら、WP FREEZE FORMULAS コマンドは消去の前に式を計算するのに対し、WP RESET ATTRIBUTES コマンドは計算をしません。式が一度も計算されていない場合、デフォルトの黒いフレーム画像が表示されます。

WP INSERT FORMULA コマンドを使用することでインラインピクチャー式を追加することができます。

例:

画像が空の場合(例: 画像が読み込みできない、計算できない式の結果である、サポートされていないピクチャーフォーマットを使用している等)、デフォルトで4D Write Pro は黒枠の四角形を表示します。

以下の方法を使用してこれらの黒い四角形をカレントのビューから消去することができます:

• プロパティリストの"空またはサポートされていない画像を表示"オプション(ビュープロパティの設定 参照)を使用する
• WP SET VIEW PROPERTIES コマンドとwk visible empty images セレクターを組み合わせて使用する
• visibleEmptyImage 標準アクションを使用する(4D Write Pro標準アクションの使用 参照)

またwk visible empty images セレクターをWP EXPORT DOCUMENT および WP EXPORT VARIABLE コマンドに対して使用することで、書き出されたコンテンツから黒い四角形を消去することもできます。

このオプションが設定されている場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。

全てのピクチャーには高さ、幅、境界線、表示モードなどといったプロパティ(属性)があります。これら4D Write Pro ランゲージ(WP GET ATTRIBUTES あるいは WP SET ATTRIBUTES)あるいは標準アクションを用いて取得あるいは設定することが可能です。

• ピクチャーに対して使用可能なプロパティの完全な一覧は、4D Write Pro属性 のページに記載されています。
• 画像 の章にはピクチャー専用の属性が含まれています。
• 4D Write Pro標準アクションの使用 のページにも利用可能な画像プロパティの一覧があります。

ピクチャー参照(ピクチャー変数、フィールド、式)を使用する事もできますし、ピクチャーURL(ピクチャーのローカルあるいはネットワークアドレスを表すテキスト)を使用する事もできます。

2組の属性を使用する事で、ピクチャー参照を使用したいか、ピクチャーURLを使用したいかを定義する事ができます:

• wk image、 wk background image、wk list style image: ピクチャー参照を設定あるいは取得します。
  これらの属性を使用してピクチャーを取得した場合、ピクチャーの定義方法に関係なく、4Dピクチャーを受け取ります。
• wk image url、wk background image url、wk list style image url: ピクチャーURLを設定あるいは取得します。
  これらの属性を使用してピクチャーを取得した場合、テキストのみを受け取ります。ピクチャーが参照を通して定義されていた場合(例: ピクチャー変数)、ローカルのURI と、そのあとにBase64 の画像を受け取ります。

例:

以下のコマンドを使用するとピクチャーが返されます:

• WP Picture range - インライン画像に対してのみ適用可能
• WP Selection range - ユーザーが選択した画像に対してのみ適用可能

インライン画像とアンカー画像は、以下の方法で削除することができます:

• マウス/キーボードアクション を使用する
• WP DELETE PICTURE コマンドを使用する

ピクチャーはマウスあるいはキーボードで編集することができます。利用可能なアクションは以下の通りです:

• 選択
  
  • 前面レイヤーにあるピクチャーはクリックすることで選択することが可能です。
  • 背景画像はCTRL+クリック(Windows)あるいはCommand+クリック(Mac)で選択することが可能です。
  • 絶対位置をもつピクチャーを一つだけ選択することができます。複数選択することはできません。

• 移動
  
  • ピクチャーはマウスを使用して移動およびリサイズすることができます(インライン画像はドキュメントの外へとドラッグすることはできません)。

• 挿入
  
  • 絶対位置を持つピクチャーが下書きモードに貼り付け場合、カレントのキーボードセレクションの先頭にインラインとして表示されます。

• カット/貼り付け/コピー
  
  • ピクチャーは選択されていればクリップボードへとコピーしたり、カット/貼り付けなどを行うことができます。
  • 絶対位置を持つピクチャーをページモードで貼り付けすると、そのピクチャーは選択されている最初のページに貼り付けられ、元のアンカー設定に関係なく、そのページへとアンカーされます。貼り付けられたピクチャーは元のオフセットは保持しますが、元のモードとは異なるページモードへと貼り付けられた場合には保持しません(例えばピクチャーがページモードでコピーされ、埋め込みモードで貼り付けされた場合には、オフセットは0へとリセットされます)。

• 削除 -ピクチャーを選択した状態で以下の操作を行うと、ピクチャーを削除することができます:
  
  • deleteキー
  • クリアアクションのキーボードショートカット