WP Get element by ID

Home

4D v20


WP Get element by ID ( wpDok ; ID ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
wpDok	Objekt	4D Write Pro Dokument
ID	String	Kennung des gesuchten Elements
Funktionsergebnis	Objekt	4D Write Pro Element

Beschreibung

Die Funktion WP Get element by ID gibt ein Objekt mit dem im Parameter ID angegebene Element von wpDok zurück.

Im Parameter wpDok übergeben Sie ein 4D Write Pro Dokument.

Im Parameter ID übergeben Sie das ID Attribut des gesuchten Elements. Es kann innerhalb des Dokuments liegen, wie Bild, Absatz, Tabelle, Zeile, etc., oder das Dokument selbst sein. Hat kein Element im Dokument die angegebene Kennung, wird ein Nullwert zurückgegeben.

Hinweis: Beim Parameterwert ID wird zwischen Groß- und Kleinschreibung unterschieden.

Beispiel 1

Bild mit der Kennung "img1" erhalten:

 C_OBJECT(obImage)

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

Beispiel 2

Ein Tabellenelement finden und auf einen breiteren Rand mit der Farbe Purpur ändern:

 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")

Beispiel 3

Ein Element wiederfinden und seine Kennung ändern:

 $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

Siehe auch

WP Get elements