ピクチャーを管理する

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

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

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

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

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

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

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

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

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

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

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

(*)4D プロジェクトメソッドを式として呼び出すためには、そのメソッドが事前に明示的に許可されている必要があるという点に注意してください(式の管理参照)。

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

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

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

式の結果の画像が計算できない、あるいは読み込みできない場合、4D Write pro はデフォルトの黒フレームの画像を表示します:

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

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

例:

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

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

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

例:

全てのピクチャーには高さ、幅、境界線、などといったプロパティ(属性)があります。これら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 - ユーザーが選択した画像に対してのみ適用可能

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

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

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

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

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

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