WP Get section

Home

4D v20 R7

WP Get section


WP Get section ( targetObj ) \| (wpDoc ; sectionIndex ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element
wpDoc	Objekt	4D Write Pro Dokument
sectionIndex	Lange Ganzzahl	Index Abschnitt
Funktionsergebnis	Objekt	Abschnitt in 4D Write Pro

Beschreibung

Der Befehl WP Get section gibt den ersten Abschnitt zurück, der im "Range" oder Element, definiert in targetObj oder im angegebenen sectionIndex des Dokuments wpDoc zugewiesen ist.

Mit der ersten Syntax (Parameter targetObj) gibt der Befehl den ersten Abschnitt von "Range" oder dem Element zurück. In targetObj können Sie folgendes übergeben:

Range oder
Element (Tabelle, Zeile, Absatz, Textfeld, Kopf-, Fuß-,Hauptteil). Sie können keinen Unterabschnitt oder verankertes Bild zurückgeben. In diesen Fällen wird ein Fehler zurückgegeben.
Gehören Range oder Element zu einem Kopf- oder Fußteil, gibt WP Get section den Abschnitt von diesem Kopf- oder Fußteil zurück.

Wenn der Range oder das Element zu einem Kopf- oder Fußteil gehört, gibt WP Get section den Abschnitt zurück, an den der Kopf- oder Fußteil angehängt ist. Wenn der Bereich oder das Element ein Textfeld ist oder zu einem Textfeld gehört, gibt WP Get section immer den ersten Abschnitt zurück, es sei denn, er ist mit einem Abschnitt verankert (in diesem Fall wird der Abschnitt zurückgegeben).

Mit der zweiten Syntax (Parameter wpDoc) gibt der Befehl den in sectionIndex angegebenen Abschnitt zurück (Wert von sectionIndex muss >=1 sein).
Ist kein Abschnitt für sectionIndex definiert, gibt der Befehl ein undefiniertes Objekt zurück (es wird kein Fehler zurückgegeben).

Hinweis: Mit dem Befehl WP Get subsection erhalten Sie einen Unterabschnitt aus einem Abschnitt oder Range.

Beispiel

Den ersten Abschnitt erhalten:

 C_OBJECT($section)

  // Den ersten Abschnitt erhalten

 $section:=WP Get section(wpDoc;1)

Siehe auch

WP Get sections
WP Get subsection