WP Add picture
WP Add picture ( wpDoc {; picture} ) : Object
WP Add picture ( wpDoc {; picturePath} ) : Object
WP Add picture ( wpDoc {; pictureFileObj} ) : Object
| 引数 | 型 | 説明 | |
|---|---|---|---|
| wpDoc | Object | → | 4D Write Pro ドキュメント |
| picture | Picture | → | ピクチャー |
| picturePath | Text | → | ピクチャーパス |
| pictureFileObj | 4D.File | → | ピクチャーファイルを表す4D.File オブジェクト |
| 戻り値 | Object | ← | ピクチャーを参照しているオブジェクト |
説明
WP Add picture コマンドは、 引数として渡されたピクチャーをwpDoc 引数で指定したドキュメント内での固定された場所にアンカーし、その参照を返します。 返された参照は、 WP SET ATTRIBUTES コマンドへと渡すことでwpDoc 引数で指定したドキュメント内の(ページ、セクション、ヘッダー、フッター等の)任意の位置へと移動させることができます。 レイヤーやサイズなども指定可能です。
wpDoc 引数には、4D Write Pro ドキュメントオブジェクトを渡します。
オプションの第二引数には、次のいずれかを渡すことができます:
- picture: 4D ピクチャー
- picturePath: ディスク上に保存されているピクチャーファイルへのパスを格納した文字列(システムのシンタックス) フルパス名か、またはデータベースストラクチャーファイルへの相対パス名を渡すことができます。 またファイル名を渡すこともでき、その場合、ファイルはデータベースのストラクチャーファイル と同じ階層に置かれている必要があります。 ファイル名を渡す場合には、ファイルの拡張子も指定する必要があります。
- PictureFileObj: ピクチャーファイルを表す
4D.Fileオブジェクト
4D でサポートされているフォーマット であれば、どんなピクチャーフォーマットでも使用することができます。 PICTURE CODEC LIST コマンドを使用することで、利用可能なピクチャーフォーマットの一覧を取得することができます。 ピクチャーに複数のフォーマット(コーデック)が格納されている場合、4D Write Pro はドキュメント内に表示用に1種類、印刷用に1種類(異なる場合)のフォーマットのみを保管します。その際、「最適」なフォーマットが自動的に選択されます。
- picture 引数が省略された場合でも、有効なピクチャー参照は返され、空の画像が追加されます。 picture 引数が省略された場合でも、有効なピクチャー参照は返され、空の画像が追加されます。 この場合、その後にWP SET ATTRIBUTES コマンドをwk image expression セレクターで呼び出すことでその画像に4D 式を入れることができます。 式が評価できない、あるいは有効なピクチャーが返されない場合、空の画像(デフォルトの黒枠の画像)が表示されます。 式が評価できない、あるいは有効なピクチャーが返されない場合、空の画像(デフォルトの黒枠の画像)が表示されます。
デフォルトでは、追加されたピクチャーは以下のように表示されます:
- テキストの後ろに埋め込み
- ペーパーボックスの左上隅に表示
- 全てのページに表示
位置、レイヤー(インライン、テキストの前/後)、表示状態、その他ピクチャーのあらゆるプロパティはWP SET ATTRIBUTES コマンド、または標準アクションを使用して変更することができます(4D Write Pro 標準アクションを使用を参照してください)。
注意: WP Selection range コマンドは、アンカーされたピクチャーが選択されていた場合には ピクチャー参照 を、インラインピクチャーが選択されていた場合には レンジオブジェクト を返します。 選択されたオブジェクトがピクチャーオブジェクトであるかどうかは、wk type 属性をチェックすることで確認できます。
- Value = 2: 選択されたオブジェクトはピクチャーオブジェクトです。
- Value = 0: 選択されたオブジェクトはレンジオブジェクトです。
例題 1
ファイルパスを使用して、デフォルトの設定でピクチャーを追加したい場合を考えます。
var $obPict : Object
$obPict:=WP Add picture(myDoc;"/PACKAGE/Pictures/Saved Pictures/Sunrise.jpg")
結果は以下のようになります:
例題 2
リサイズされたピクチャーを、ヘッダーの中央にアンカーして追加したい場合を考えます:
var $obImage : Object
var $myPictureFile : 4D.File
$myPictureFile:=File("/PACKAGE/Pictures/Saved Pictures/Sunrise.jpg")
$obImage:=WP Add picture(myDoc;$myPictureFile)
WP SET ATTRIBUTES($obImage;wk anchor origin;wk header box)
WP SET ATTRIBUTES($obImage;wk anchor horizontal align;wk center)
WP SET ATTRIBUTES($obImage;wk anchor vertical align;wk center)
WP SET ATTRIBUTES($obImage;wk width;"650px";wk height;"120px")
結果は以下のようになります:
例題 3
フィールド式を使用して、アンカーされた画像を、データベースからのテキストを表示するドキュメントに追加したい場合を考えます:
QUERY([Flowers];[Flowers]Common_Name="tulip")
WP SET TEXT(myDoc;[Flowers]Description;wk append) //テキストを挿入する
var $obImage : Object
$obImage:=WP Add picture(myDoc)
WP SET ATTRIBUTES($obImage;wk image formula;Formula([Flowers]Image))
