WP Get element by ID

4D v17


WP Get element by ID ( wpDoc ; ID ) -> 戻り値

引数	型	説明
wpDoc	Object	4D Write Pro ドキュメント
ID	文字	取得する要素のID
戻り値	Object	4D Write Pro 要素への参照

説明

WP Get element by ID コマンドは、wpDoc 引数で指定したドキュメント内の、ID 引数で指定された要素への参照を格納しているオブジェクトを返します。

wpDoc 引数には、4D Write Pro ドキュメント参照を渡します。

ID 引数には、取得する要素の属性IDを渡します。要素なドキュメント内のもの、例えば画像、段落、表、などを指定できますし、あるいはドキュメント自身を指定することもできます。ドキュメント内に指定されたIDを持つ要素がなかった場合、null 値が返されます。

例題 1

"img1"というID を持つピクチャーへの参照を取得する場合を考えます:

 C_OBJECT(obImage)

 obImage:=WP Get element by ID(myDoc;"img1")

例題 2

表要素を探し、その境界線を太い紫の境界線に変更したい場合を考えます:

 C_OBJECT($element)

 $element:=WP Get element by ID(myDoc;"Table1")

 WP SET ATTRIBUTES($element;wk border style;wk solid)

 WP SET ATTRIBUTES($element;wk border width;"4px")

 WP SET ATTRIBUTES($element;wk border color;"purple")

例題 3

要素を取得し、そのID を変更したい場合を考えます:

 $colTable:=WP Create table range([INFO]Sample)

 $elements:=WP Get elements($colTable)

 $elem:=WP Get element by ID([INFO]Sample;"Paris")

 If($elem#Null)

    $elem.ID:="Lyon"

 End if

参照

WP Get elements