WP Text range

Home

4D v20 R7

WP Text range


WP Text range ( targetObj ; startRange ; endRange ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
startRange	Lange Ganzzahl	Start neuer Range im Bereich
endRange	Lange Ganzzahl	Ende neuer Range im Bereich
Funktionsergebnis	Objekt	Objekt Range

Geänderter Name

WP Text range hieß in bisherigen Versionen von 4D Write Pro WP Get range. Der Name wurde für mehr Klarheit geändert.

Beschreibung

Die Funktion WP Text range gibt ein neues Objekt Range mit der Auswahl zwischen startRange und endRange in targetObj zurück.

Ein 4D Write Pro Objekt Range 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 Range.

In targetObj übergeben Sie:

Range oder
Element (Tabelle, Zeile, Absatz, Bild im Textfluss, Kopf-, Haupt-, Fußteil, Abschnitt, Unterabschnitt) oder
4D Write Pro Dokument

Ist im Parameter targetObj kein gültiges Objekt übergeben, wird ein leerer Range zurückgegeben.

In startRange und endRange übergeben Sie Werte für die Position des ersten und letzten Zeichens der Auswahl im Dokument. Sie können wk start text in startRange übergeben, um den Anfang des Dokuments zu definieren und wk end text in endRange, 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 Range enthält.

Hinweis: Haben Sie in targetObj ein Element Tabelle, Zeile, Absatz, Bild im Textfluss, Kopf-, Haupt- oder Fußteil, Abschnitt oder Unterabschnitt übergeben, beziehen sich StartRange und endRange auf das jeweilige Element. Ist z.B. ein Kopfteil übergeben, gibt wk start text das startende Zeichen und wk end text das endende Zeichen des Kopfteils an. Bei einerTabelle gibt die Funktion den Textbereich der Tabelle zurück, die in targetObj übergeben ist. Ist ein Abschnitt übergeben, beziehen sich startRange und endRange auf den Hauptteil des Dokuments, das ist der übergeordnete Bereich eines Range, der aus einem Abschnitt erstellt wurde (siehe Beispiel 2).

Beispiel 1

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 Text range([SAMPLE]WP;wk start text;12)

 WP SELECT(*;"WParea";$range2)

Beispiel 2

Aus einem Abschnitt einen "Range" erstellen:

 C_OBJECT($wpRange)

 $wpRange:=WP Text range(wpSection;1;11) //gibt einen Range mit den ersten 10 Zeichen des Abschnitts zurück

  //startet Abschnitt bei 100 im Dokument:

  //$wpRange.start = 100

  //$wpRange.end = 111

Siehe auch

WP Bookmark range
WP Get body
WP Get header
WP Paragraph range
WP Picture range
WP SELECT
WP Selection range
WP Table range