4D v17WP Create range |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v17
WP Create range
|
WP Create range ( ZielObj ; StartAusschnitt ; EndeAusschnitt ) -> Funktionsergebnis | ||||||||
Parameter | Typ | Beschreibung | ||||||
ZielObj | Objekt |
![]() |
Ausschnitt oder Referenz auf Element oder 4D Write Pro Dokument | |||||
StartAusschnitt | Lange Ganzzahl |
![]() |
Start neuer Textausschnitt | |||||
EndeAusschnitt | Lange Ganzzahl |
![]() |
Ende neuer Textausschnitt | |||||
Funktionsergebnis | Objekt |
![]() |
Objektausschnitt | |||||
WP Create range hieß in bisherigen Versionen von 4D Write Pro WP Get range. Dieser Name wurde für mehr Klarheit geändert.
Die Funktion WP Create range gibt einen neuen Objektausschnitt (objAusschnitt) mit der Auswahl zwischen StartAusschnitt und EndeAusschnitt im 4D Write Pro Bereich wpArea zurück.
Ein 4D Write Pro Objektausschnitt dient zum Verwalten von Attributen in einer Textauswahl (insbesondere über die Befehle WP GET ATTRIBUTES und WP SET ATTRIBUTES). Weitere Informationen dazu finden Sie im Abschnitt Befehle zum Verwalten des Ausschnitts.
In Zielobj übergeben Sie:
Ist im Parameter Zielobj kein gültiges Objekt übergeben, wird ein leerer objAusschnitt zurückgegeben.
In StartAusschnitt und EndeAusschnitt übergeben Sie Werte für die Position des ersten und letzten Zeichens der Auswahl im Dokument. Sie können wk start text in StartAusschnitt übergeben, um den Anfang des Dokuments zu definieren und wk end text in EndeAusschnitt, um das Ende des Dokuments zu definieren. Beachten Sie, dass ein 4D Write Pro Dokument nicht nur sichtbaren Text, sondern auch Tags zur Formatierung im Ausschnitt enthält.
Haben Sie in Zielobj eine Referenz auf ein Element Tabelle, Zeile, Absatz, Bild im Textfluss, Kopf-, Haupt- oder Fußteil übergeben, beziehen sich StartAusschnitt und EndeAusschnitt auf das jeweilige Element. Ist z.B. die Referenz eines Kopfteils übergeben, gibt wk start text das startende Zeichen und wk end text das endende Zeichen des Kopfteils an. Bei Referenz auf eine Tabelle gibt die Funktion den Textausschnitt in dieser Tabelle zurück.
Hinweis: Haben Sie in Zielobj eine Referenz auf ein Element übergeben, bezieht sich der zurückgegebene Ausschnitt auf den Textinhalt von Haupt-, Kopf- oder Fußteil. Der Objektausschnitt behält eine interne Referenz auf den übergeordneten Haupt-, Kopf- oder Fußteil.
Einen "Range" mit 12 Zeichen auswählen, der mit dem Anfang eines 4D Write Pro Feldes startet. Das Feld erscheint in einem Formularobjekt:
Der Code lautet:
$range2:=WP Create range([SAMPLE]WP;wk start text;12)
WP SELECT(*;"WParea";$range2)
WP Get body
WP Get bookmark range
WP Get header
WP Get selection
WP SELECT
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer:
1341
Erstellt: 4D v15 R4
Geändert: 4D v16 R5
Umbenannt: 4D v16 R5
4D Write Pro Handbuch ( 4D v17)