4D v14.3

ST INSERT URL

Home

 
4D v14.3
ST INSERT URL

ST INSERT URL 


 

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

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.

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)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Mehrfachstil Text
Nummer: 1280

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

New
Erstellt: 4D v14

 
SIEHE AUCH 

ST GET URL
ST INSERT EXPRESSION

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)