WP Get subsection

Home

4D v20 R7

WP Get subsection


WP Get subsection ( targetObj ) \| (wpSection ; subSectionType ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element
wpSection	Objekt	Abschnitt in 4D Write Pro
subSectionType	Lange Ganzzahl	Typ des Unterabschnitts (wk first page, wk left page oder wk right page)
Funktionsergebnis	Objekt	Unterabschnitt

Beschreibung

Der Befehl WP Get subsection gibt den ersten Unterabschnitt zurück, der im "Range" oder Element im Parameter targetObj oder im angegebenen subSectionType des Abschnitts wpSection zugewiesen ist.

Mit der ersten Syntax (Parameter targetObj) gibt der Befehl den ersten Unterabschnitt von "Range" oder dem Element zurück. Gibt es keinen Unterabschnitt in Range oder im Element, wird ein Null Objekt zurückgegeben. In targetObj können Sie folgendes übergeben:
- Range oder
- Element (Tabelle, Zeile, Absatz, Textfeld, Kopf-, Fuß-,Hauptteil)
Gehören Range oder Element zu einem Kopf- oder Fußteil, gibt WP Get subsection den Unterabschnitt von diesem Kopf- oder Fußteil zurück. Ist der Kopf- oder Fußteil keinem Unterabschnitt zugewiesen, wird ein Null Objekt zurückgegeben.
Gehören Range oder Element zu einem verankerten Bild, wird ein Fehler zurückgegeben.

Mit der zweiten Syntax (Parameter wpSection und subSectionType) gibt der Befehl ein Objekt wpSubSection (Kind von wpSection) vom Typ subSectionType zurück. Im Parameter subSectionType können Sie eine der folgenden Konstanten übergeben:

Konstante	Typ	Wert
wk first page	Lange Ganzzahl	1
wk left page	Lange Ganzzahl	2
wk right page	Lange Ganzzahl	3

Ist für wpSection kein Unterabschnitt subSectionType definiert, gibt der Befehl ein undefiniertes Objekt zurück (es wird kein Fehler zurückgegeben).

Beispiel

Auf den linken Seiten einen blauen Hintergrund setzen:

 C_OBJECT($section;$subsection)

  //Den ersten Abschnitt finden

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

  //Linken Unterabschnitt des ersten Abschnitts finden

 $subsection:=WP Get subsection($section;wk left page)

 

  //Wenn der Unterabschnitt existiert, den Hintergrund in blau setzen

 If($subsection#Null)

    WP SET ATTRIBUTES($subsection;wk background color;"#87CEEB")

 Else

    ALERT("Bitte erstellen Sie linke und rechte Unterabschnitte.")

 End if

Siehe auch

WP DELETE SUBSECTION
WP Get section
WP New subsection