4D v17

WP Create range

Home

 
4D v17
WP Create range

WP Create range 


 

WP Create range ( ZielObj ; StartAusschnitt ; EndeAusschnitt ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
ZielObj  Objekt in Ausschnitt oder Referenz auf Element oder 4D Write Pro Dokument
StartAusschnitt  Lange Ganzzahl in Start neuer Textausschnitt
EndeAusschnitt  Lange Ganzzahl in Ende neuer Textausschnitt
Funktionsergebnis  Objekt in 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:

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

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)



Siehe auch 

WP Get body
WP Get bookmark range
WP Get header
WP Get selection
WP SELECT

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer: 1341

Dieser Befehl kann in preemptive Prozessen laufen

 
GESCHICHTE 

Erstellt: 4D v15 R4
Geändert: 4D v16 R5
Umbenannt: 4D v16 R5

 
ARTIKELVERWENDUNG

4D Write Pro Handbuch ( 4D v17)