WP GET ATTRIBUTES

4D v17

WP GET ATTRIBUTES


WP GET ATTRIBUTES ( targetObj ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} )

引数	型	説明
targetObj	Object	4D Write Pro ドキュメント、レンジまたは要素の参照
attribName	テキスト	取得する属性の名前
attribValue	テキスト, Number, 倍長整数配列, 実数配列, ピクチャー, 日付	テキストのレンジの属性のカレント値

説明

WP GET ATTRIBUTESコマンドは、4D Write Proレンジ、ヘッダー/フッター/ボディ、あるいはドキュメント内のあらゆる属性の値を返します。このコマンドを使用すると4D Write Proのどのような内部属性(文字、段落、ドキュメント、テーブル、画像など)にもアクセスすることができます。

targetObj 引数には、以下のいずれかを渡すことができます:

レンジ
要素 (ヘッダー / フッター / 本文 / テーブル / 段落 / アンカー画像あるいはインライン画像) の参照
4D Write Pro ドキュメント

attribName 引数に渡すことのできる属性の包括的な一覧と、そのスコープおよび値については、4D Write Pro属性の章を参照してください。

引数として渡した要素内の同じ属性に対して異なる値があった場合、コマンドは以下のように対応します:

数値に対しては、wk mixed を返します。
配列の場合、空の配列を返します(attribValueが配列として定義されていた場合にはタブストップ、カラー)。ただしwk text shadow offset に関しては、配列の値は常に2つのエントリーを含みます。これらのエントリーは水平方向あるいは垂直方向のオフセット(あるいはその両方)がミックスされていた場合にはwk mixedが返されます。
文字列の値に対しては、空の文字列を返します。
ピクチャーの値に対しては、空のピクチャーを返します。

例題

選択されたエリアの背景色を取得したい場合を考えます:

 $range:=WP Get selection(*;"WParea")

 WP GET ATTRIBUTES($range;wk background color;$bcol)

参照

4D Write Pro
4D Write Pro属性
 WP RESET ATTRIBUTES
WP SET ATTRIBUTES