4D v20
WP Text range
- 4D Write Pro Handbuch
-
- 4D Write Pro Programmiersprache
-
- Über 4D Write Pro Objekte
- Befehle aus dem Kapitel Objekte (Formulare) verwenden
- Befehle aus dem Kapitel Mehrfachstil Text verwenden
- Per Programmierung auf Dokumentinhalte zugreifen
- 4D Write Pro Konstanten
- WP Add picture
- WP Bookmark range
- WP COMPUTE FORMULAS
- WP DELETE BOOKMARK
- WP DELETE FOOTER
- WP DELETE HEADER
- WP DELETE PICTURE
- WP DELETE STYLE SHEET
- WP DELETE SUBSECTION
- WP DELETE TEXT BOX
- WP EXPORT DOCUMENTUpd
- WP EXPORT VARIABLEUpd
- WP Find all
- WP Find next
- WP Find previous
- WP FREEZE FORMULAS
- WP GET ATTRIBUTES
- WP Get body
- WP GET BOOKMARKS
- WP Get breaks
- WP Get data context
- WP Get element by ID
- WP Get elements
- WP Get footer
- WP Get formulas
- WP Get frame
- WP Get header
- WP Get links
- WP Get page count
- WP Get position
- WP Get section
- WP Get sections
- WP Get style sheet
- WP Get style sheets
- WP Get subsection
- WP Get text
- WP Get view properties
- WP Import document
- WP IMPORT STYLE SHEETS
- WP INSERT BREAK
- WP INSERT DOCUMENT
- WP INSERT FORMULA
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP NEW BOOKMARK
- WP New footer
- WP New header
- WP New style sheet
- WP New subsection
- WP New text box
- WP Paragraph range
- WP Picture range
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP Selection range
- WP SET ATTRIBUTES
- WP SET DATA CONTEXT
- WP SET FRAME
- WP SET LINK
- WP SET TEXT
- WP SET VIEW PROPERTIES
- WP Table append row
- WP TABLE DELETE COLUMNS
- WP TABLE DELETE ROWS
- WP Table get cells
- WP Table get columns
- WP Table get rows
- WP Table insert columns
- WP Table insert rows
- WP Table range
- WP Text range
- WP USE PAGE SETUP
- 4D Write Pro Attribute
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 | |||||
WP Text range hieß in bisherigen Versionen von 4D Write Pro WP Get range. Der Name wurde für mehr Klarheit geändert.
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).
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)
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
WP Bookmark range
WP Get body
WP Get header
WP Paragraph range
WP Picture range
WP SELECT
WP Selection range
WP Table range
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer:
1341
Erstellt: 4D v15 R4
Geändert: 4D v16 R5
Umbenannt: 4D v16 R5
Geändert: 4D v17 R3
Umbenannt: 4D v17 R5
4D Write Pro Handbuch ( 4D v20)
