4D Doc Center : ST INSERT URL

Home

4D v14.3

ST INSERT URL


ST INSERT URL ( {* ;} Objekt ; urlText ; urlAdresse {; StartAusw {; EndeAusw}} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist Objektname (String) Ohne Stern: Objekt ist Feld oder Variable
Objekt	Formularobjekt	Objektname (mit ) oder Feld bzw. Variable (ohne )
urlText	Text	Sichtbarer Text der URL
urlAdresse	Text	URL Adresse
StartAusw	Lange Ganzzahl	Start der Auswahl
EndeAusw	Lange Ganzzahl	Ende der Auswahl

Beschreibung

Der Befehl ST INSERT URL fügt einen URL Link in das Feld ein, definiert im Parameter Objekt und vom Typ formatierter Text oder Variable.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt ein Feld oder eine Variable. In diesem Fall übergeben Sie eine Feld- oder Variablenreferenz anstelle eines String (nur Feld oder Variablenobjekt).

Im Parameter urlText übergeben Sie den sichtbaren Text der URL, wie sie in Objekt erscheinen soll. Das können z.B. Textbezeichnungen sein, wie "4D Web Site" oder "Für weitere Informationen klicken Sie auf diesen Link". Sie können auch die Adresse selbst verwenden, z.B. "http://www.4d.com".

Im Parameter urlAdresse übergeben Sie die komplette Adresse zur Seite, die der Browser aufrufen soll, z.B."http://www.4D.com".

Die optionalen Parameter StartAusw und EndeAusw definieren eine Textauswahl in Objekt. Die Werte StartAusw und EndeAusw geben eine Auswahl im Plain Text, ohne evtl. vorhandene Stil Tags zu berücksichtigen.

Übergeben Sie StartAusw und EndeAusw, ersetzt ST INSERT URL den Text innerhalb dieser Auswahl mit urlText.
Übergeben Sie nur StartAusw oder ist der Wert von EndeAusw größer als die Gesamtanzahl der Zeichen in Objekt, werden alle Zeichen zwischen StartAusw und dem Textende mit urlText ersetzt.
Lassen Sie StartAusw und EndeAusw weg, ersetzt urlText die aktuelle Textauswahl in Objekt oder wird an der Cursorposition eingefügt.

4D bietet vordefinierte Konstanten, so dass Sie die Auswahlgrenzen in den Parametern StartAusw und EndeAusw automatisch setzen können. Diese Konstanten finden Sie unter dem Thema Mehrfachstil Text:

Konstante	Typ	Wert	Meldung
ST End highlight	Lange Ganzzahl	-1001	Bestimmt das letzte Zeichen der aktuellen Textauswahl in Objekt (*)
ST End text	Lange Ganzzahl	0	Bestimmt das letzte Zeichen des Textes in Objekt
ST Start highlight	Lange Ganzzahl	-1000	Bestimmt das erste Zeichen der aktuellen Textauswahl in Objekt (*)
ST Start text	Lange Ganzzahl	1	Bestimmt das erste Zeichen des Textes in Objekt

(*) Um diese Konstante zu nutzen, müssen Sie in Objekt einen Objektnamen verwenden. Übergeben Sie eine Referenz auf ein Feld oder eine Variable, wird der Befehl auf den gesamten Text des Objekts angewendet.

Hinweis: Ist StartAusw größer als EndeAusw (außer EndeAusw ist 0), führt der Befehl nichts aus und die Variable OK wird auf 0 gesetzt.

Der eingefügte Link ist dann aktiv: Über Strg+click (Windows) oder Befehl+Klick (OS X) auf die Bezeichnung öffnet der Standardbrowser die Seite zur Adresse, die im Parameter urlAdresse angegeben ist.

Beispiel

Einen Link zur 4D Web Site einfügen, um den im Objekt ausgewählten Text zu ersetzen:

 vTitle:="4D Web Site"

 vURL:="http://www.4d.com/"

 ST INSERT URL(*;"myText";vTitle;vURL;ST Start highlight;ST End highlight)