WP Get elements

Home

4D v17

WP Get elements


WP Get elements ( ZielObj {; ElementTyp} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
ZielObj	Objekt	Ausschnitt, Referenz auf Element oder 4D Write Pro Dokument
ElementTyp	Lange Ganzzahl	Gewünschter Typ des gesuchten Elements
Funktionsergebnis	Collection	Collection mit Referenzen auf Elemente

Beschreibung

Die Funktion WP Get elements gibt eine Collection von Objekten mit Referenzen auf Absätze, Bilder, Tabellen bzw. Zeilen zurück.

Im Parameter ZielObj übergeben Sie:

Ausschnitt oder
Referenz auf ein Element (Tabelle, Zeile, Absatz, Kopf-, Haupt-, Fußteil) oder
4D Write Pro Dokument

Wenn ein typisierter Bereich oder eine Referenz übergeben wird, gibt die Funktion eine Collection zurück, die nur Elemente des entsprechenden Typs enthält (es sei denn, Sie geben mit dem Parameter ElementTyp einen Typ an, siehe unten). Sonst gibt sie eine Collection mit allen in ZielObj verfügbaren Elementen an.

Optional können Sie im Parameter ElementTyp die Elementtypen angeben, die in der Collection zurückgegeben werden sollen. Es gibt folgende Typen:

Konstante	Wert	Kommentar
wk type default	0	Standardtyp Range (Wert für wk type)
wk type image	2	Verankertes Bild (Wert für wk type)
wk type image anchored	200	Referenz verankertes Bild für Dokument Objekte
wk type image inline	100	Referenz Bild im Textfluss für Dokument Objekte
wk type paragraph	1	Rangetyp Absatz (Wert für wk type)
wk type table	4	Referenz Tabelle (Wert für wk type)
wk type table row	5	Referenz Tabellenzeile (Wert für wk type)

Hinweise:

Mit dem Selektor wk type default gibt die Funktion eine ungefilterte Collection zurück.
Mit den Selektoren wk type paragraph, wk type image oder wk type table enthält die zurückgegebene Collection nur Elemente des angegebenen Typs, selbst wenn er sich vom Typ unterscheidet, der im Parameter ElementTyp angegeben ist.
Die Elemente in der zurückgegebenen Collection werden in derselben Reihenfolge wie in ZielObj sortiert, außer wenn eine Referenz auf ein 4D Write Pro Dokument übergeben ist. Dann werden die Elemente nach ihrer Kennung sortiert.
Ist ein Element im Ausschnitt, übergeben in ZielObj, nur teilweise enthalten, ist das ganze Element im Ergebnis übernommen. Enthält der Ausschnitt beispielsweise einen Teil und nicht die komplette Tabelle, wird die Referenz auf die komplette Tabelle zurückgegeben, jedoch sind nur die Zellenreferenzen (Absatz) innerhalb des Ausschnitts enthalten.

Beispiel 1

Eine Collection mit allen Absätzen in einem Dokument zurückgeben:

 C_COLLECTION($docElements)

 $docElements:=WP Get elements($myDoc;wk type paragraph)

  //gibt eine Collection zurück, die nur die Elemente vom Typ Absatz enthält

Beispiel 2

Ausrichtung und Farbe der Absätze in einem Dokument abwechselnd verwenden:

 C_COLLECTION($col)

 C_OBJECT($obj)

 C_OBJECT($body)

 C_LONGINT($i;$n)

 $col:=New collection

 $body:=WP Get body(myDoc)

 $col:=WP Get elements($body;wk type paragraph)

 $i:=0

 $n:=$col.length

 For($i;0;$n-1)

    $obj:=$col[$i]

    WP RESET ATTRIBUTES($obj)

    WP SET ATTRIBUTES($obj;wk font bold;wk false)

    WP SET ATTRIBUTES($obj;wk font italic;wk false)

    If($i%2=0)

       WP SET ATTRIBUTES($obj;wk text align;wk left)

       WP SET ATTRIBUTES($obj;wk font bold;wk true)

       WP SET ATTRIBUTES($obj;wk text color;"#804040")

       WP SET ATTRIBUTES($obj;wk margin right;"5cm")

       WP SET ATTRIBUTES($obj;wk margin left;"1cm")

    Else

       WP SET ATTRIBUTES($obj;wk text align;wk right)

       WP SET ATTRIBUTES($obj;wk font italic;wk true)

       WP SET ATTRIBUTES($obj;wk text color;"#404020")

       WP SET ATTRIBUTES($obj;wk margin left;"5cm")

       WP SET ATTRIBUTES($obj;wk margin right;"1cm")

    End if

 End for

Siehe auch

WP Create table range
WP Get element by ID